◷ Reading Time: 38 minutes
Web Commands
These commands are available on a Web-based RPA.
Find Element
Allows the location of one or more elements on the web page.
Properties

- Target Browser (required): Name of a target browser to use for browsing. The parameter that is associated with the Browser.
- Lookup Key (required): Type of identifier to be used in the search
- Search Value (required): The value to search for in a web page’s elements
- Type: Each value has a type associated with it. Select (…) in the Property grid to set the type.
- String
- Expression
- FormattedString
- Type: Each value has a type associated with it. Select (…) in the Property grid to set the type.
- Policy:
- All: Finds all the elements specified in the Search Value
- Any: Finds the first element specified in the Search Value
- Copy Element To: Name of the parameter that holds to the search result
- Timeout: Wait until the element is found. Value is total milliseconds. For example, enter 1000 for one second.
- Safe Lookup: Safe lookup does not throw an exception if elements are not found. Instead, it sets the target parameter to null.
- Multiple Results: The result of a search can return multiple web elements
Flow for the two examples given here.

Example 1
Find an element with name of n in a Browser named web1
Properties
- Target Browser (required): web1
- Lookup Key (required): Name
- Search Value (required): n
- Copy Element To: result
Example 2
Find all elements in the Google homepage with name of button-21, q or btnK in a Browser named web1
Properties
- Target Browser (required): web1
- Lookup Key (required): Name
- Search Value (required): [‘button-21′,’q’,’btnK’]
- Policy: All
- Copy Element To: result
New Browser
Opens a new browser with a specific mode: secure (private) or insecure.
Properties

- Browser Type: Application to open a selected website
- Private Mode: Allows opening the browser in a secure and private mode
- True: Opens the browser in incognito mode
- False: Opens the browser in normal mode
- Copy Result To Name of the parameter that holds to the Browser instance (Name of the Navigate To instance)
Flow for the two examples given here.

Example 1
Open Chrome web browser in incognito mode
Properties
- Browser Type: Chrome
- Private Mode: True
- Copy Result To: web1
Example 2
Open Chrome web browser in normal mode
Properties
- Browser Type: Chrome
- Private Mode: False
- Copy Result To: web1
Close Browser
Closes the open browser.
Properties

- Target Browser: Target browser to close
Flow for the example is given here.

Example 1
Close opened browser
Properties
- Target Browser: web1
Navigate To
Navigates to a web page.
Properties

- Target Browser: Name of the target browser
- Url: Address of the site to which to navigate
- New Browser: To open a new browser
- Browser Type: Application to open selected website
- Private Mode: Allows you to open a browser in a secure and private mode
- True: Opens the browser in incognito mode
- False: Opens the browser in normal mode
- Copy Result To: Assign a name for the Browser instance
Example 1
Navigate to Google using a created ‘New Browser’ instance

Properties
- Target Browser: web1
- Url: https://www.google.com
Example 2
Navigate to Google by creating a new Browser instance

Properties
- Target Browser: <leave empty>
- Url: https://www.google.com
- New Browser
- Browser Type: Chrome
- Private Mode: False
- Copy Result To: web1
Wait Until
Sets a condition and a timeout period to wait. The process will wait for the given time period until the condition is satisfied and terminate the process after exceeding the timeout limit.
Properties
Properties

- Target Browser: Name of the target browser
- Condition Check: Condition to be checked
- UrlEquals: URL exactly equals to the passing value
- UrlContains: URL contains the passing value, does not need to equal exactly
- UrlMatches: URL matches a given regex
- TitleEqauls”: Title exactly equals to the passing value
- TitleContains: Title contains the passing value, does not need to equal exactly
- TitleMatches: Title matches a given regex
- ElementTextVisibility: Element text contains the passing value. Returns true if contains, throws an error if it does not contain
- ElementTextInvisibility: Element text does not contain the passing value. Returns true if it doesn’t contain, throws an error if it contains
- ElementValue: Element value equals to the passing value. Returns true or false
- ElementVisibility: Returns true if the element is visible if not throws an error
- ElementInvisibility: Returns true if the element is not visible if not throws an error
- ElementClickability: Returns true if the element is active/ clickable if not throws an error
- Search Value: Value to search on a web page
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Copy Result To: Name of the parameter that holds the search result
- Timeout: Timeout period in milliseconds
Flow for the two examples given here.

Example 1
Navigate to a page and wait 3 seconds until the Url contains ‘hello’.
Properties
- Target Browser: web1
- Condition Check: UrlContains
- Search Value: hello
- Timeout: 3000
The process will wait three seconds until the URL contains ‘hello’. In this example, as the URL will never contain the word ‘hello’ it will give a timeout exception after 3 seconds and terminate the process.
Example 2
Navigate to a page and wait three seconds until input text value is equal to’hello’
Properties
- Target Browser: web1
- Condition Check: ElementValue
- Search Value: hello
- Lookup Key: Name
- Search Value: n
- Timeout: 3000
The process will wait three seconds until the input text value equals ‘hello’. In this example, as the value won’t change, it will give a timeout exception after 3 seconds and terminate the process.
Run JavaScript
Runs a JavaScript code in the open web browser.
Properties

- Target Browser: Name of the target browser
- JavaScript: JavaScript content to run on the browser
- Copy Result To: Name of the parameter that holds the search result
Flow for the two examples given here.

Example 1
Navigate to a web page and show an alert box saying “hi”.
Properties
- Target Browser: web1
- JavaScript: alert (“hi”)
Example 2
Navigate to a page and type ‘FlexRule’ as input text value
Properties
- Target Browser: web1
- JavaScript: document.getElementById(“n”).value=”Flexrule” (“n” is the HTML element ID of a input text in the page)
List Action
Selects or Deselects options in a list of a web form.
Properties

- Element: Target element to get an attribute from
- Action: Options to select items of a drop-down list or multiple-selection box. Deselect and DeselectAll options are available only for multiple-selection box.
- Select
- Deselect
- DeselectAll
- Item Value: Value of HTML element identifier to perform the action
- Find Method: Type of HTML element identifier to be used in the search
- Find Element:
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that hold to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the two examples given here.

Example 1
Select Australia from the list
Properties
- Element: el
- Action: Select
- Item Value”: AU
- Target Browser: web1
- Lookup Key: Name
- Search Value: country
- Copy Element To: el
Example 2
Deselect all items of the list
Properties
- Element: el
- Action: DeselectAll
- Target Browser: web1
- Lookup Key: Name
- Search Value: country
- Copy Element To: el
Set Text
Sets the text of a given HTML element in a web browser.
Properties

- Element: Target element to set a text on it
- Text Value: Text value to set on the element
- Find Element
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that hold to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the example is given here.

Example 1
Set user name of a form.
Properties
- Text Value: User 1
- Target Browser:web1
- Lookup Key: Name
- Search Value:n
Get Text
Gets the text of a given HTML element in a web browser.
Properties

- Element: Target element to set a text on it
- Copy Result To: Name of the parameter that holds to the search result
- Find Element
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that hold to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the example is given here.

Example 1
Get user name from a form.
Properties
- Copy Result To: result
- Target Browser: web1
- Lookup Key: Name
- Search Value: n
Get Title
Gets the title of a web browser.
Properties

- Target Browser: Target browser to get the title from
- Copy Result To: Name of the parameter that holds to the search results
Flow for the example is given here.

Example 1
Get the title of a web browser.
Properties
- Target Browser: web1
- Copy Result To: result
Get Url
Gets the Url of a web browser.
Properties

- Target Browser: Target browser to get the URL from
- Copy Result To: Name of the parameter that holds to the search results
Flow for the example is given here.

Example 1
Get the URL of a web browser.
Properties
- Target Browser: web1
- Copy Result To: result
Set Attribute
Sets an attribute of a form.
Properties

- Element: Target element to set a text on it
- Attribute Name: Name of the attribute on an element to set the value to
- value: Value of the attribute
- Find Element
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that holds to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the example is given here

Example 1
Set the name of a web form
Properties
- Value: User 4
- Target Browser: web1
- Lookup Key: Name
- Search Value: n
Select File
Selects a file in a form.
Properties

- Silent Mode: Option Launch the file browser to select the file
- True: Does not open file browser to select the file
- False: Open file browser to select the file
- Element: Target element to get an attribute from
- File: File path to select the file
Flow for the two examples given here.

Example 1
Select a file without launching a file selecting window
Properties
- Silent Mode: True
- Element: el
- File: D:\Projects\1.txt
Example 2
Select after launching the file selecting window. The file will be automatically selected once the user opens the file selecting window
Properties
- Silent Mode: False
- Element: el
- File: D:\Projects\1.txt
Get Attribute
Gets an attribute of a form.
Properties

- Element: Target element to get an attribute from
- Attribute Name: Name of the attribute to get the value of
- Copy Result To: Name of the parameter that holds to the search result
- Find Element:
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that holds to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the example is given here.

Example 1
Get the value of username field using Name identifier
Properties
- Element: el
- Attribute Name: value
- Copy Result To: result
- Target Browser: web1
- Lookup Key: Name
- Search Value: n
- Copy Element To: el
Mouse Button
Performs mouse button actions.
Properties

- Element: Target element to get an attribute from
- Button Action: Type of action on the mouse button to perform
- LeftClick
- RightClick
- MiddleClick
- LeftDown
- RightDown
- MiddleDown
- LeftUp
- RightUp
- MiddleUp
- DoubleClick
- Find Element:
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that hold to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the example given here.

Example 1
Click on a button in a form to display a text
Properties
- Element: el
- Button Action: LeftClick
- Target Browser: web1
- Lookup Key: Name
- Search Value: bt
- Copy Element To: el
Mouse Move
Performs mouse move actions.
Properties

- Element: Target element to get an attribute from
- Action: Type of mouse movement to perform
- MoveToElement
- MoveByOffset
- Offset X: X coordinate in the element
- Offset Y: Y coordinate in the element
- Find Element:
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, the policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that holds to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the two examples given here.

Example 1
Show user name on mouse-over action of the button
Properties
- Element: el
- Action: MoveToElement
- Target Browser: web1
- Lookup Key: Name
- Search Value: bt
- Copy Element To: el
Example 2
Show user name on mouse-over action by Offset of the button
Properties
- Element: el
- Action: MoveByOffset
- Offset X: 10
- Offset Y: 30
- Target Browser: web1
- Lookup Key: Name
- Search Value: bt
- Copy Element To: el
Keyboard
Performs keyboard actions.
Properties

- Element: Target element to get an attribute from
- Auto Focus: Call focus method on the element before key keystroke actions (default true)
- Keys: Enter keys effect using (KeyName) for special keys, and simple text for alphabetic and numeric keys
- Key Action:
- KeyUp
- KeyDown
- Send
- Find Element:
- Target Browser: Target browser to use for browsing
- Lookup Key: Type of HTML element identifier to be used in the search
- Search Value: The value to search for in the web page’s HTML element
- Policy: If lookup value is an array of values, the policy defines whether to find or any of them that is possible
- Copy Element To: Name of the parameter that holds to the search results
- Timeout: Timeout period in milliseconds
- Multiple Results: The search result can return multiple values
Flow for the two examples given here.

Example 1
Click on the ‘Print User’ button using ‘enter’ button in the keyboard (in Keyboard.html)
Properties
- Element: el
- Keys: (enter)
- Key Action: KeyDown
- Target Browser: web1
- Lookup Key: Name
- Search Value: bt
- Copy Element To: el
Example 2
Change user name field (in Keyboard.html)
Properties
- Element: el
- Keys: Name Changed
- Key Action: KeyDown
- Target Browser: web1
- Lookup Key: Name
- Search Value: n
- Copy Element To: el
Excel Commands
These commands are available on an Excel RPA.
Excel New
Open a new Excel Application window.
Properties

- Copy Results To: Parameter name to store the newly created Excel application instance
- Visible: Whether the application should be visible or not
Opens a new Excel application instance.

Properties
- Copy Results To: ‘wb1’
- Visibility: ‘True’
Excel Close
Close an opened Excel Application window.
Properties

- Excel: Name of the Excel instance to close
Closes an opened Excel application instance.

- Excel: ex1
Workbook New
Open a new Excel workbook.
Properties

- Workbook New
- Excel: Parameter name that has the reference to the Excel application instance (if an instance exists already)
- Copy Results To: Parameter name to store the newly created Excel application instance
- Excel New
- Copy Results To: Parameter name to store the Excel application instance (if an instance does exist already and should be created)
- Visible: Whether the application should be visible or not
Opens a new Excel workbook.

Properties
- Workbook New
- Copy Results To: wb1
- Excel New
- Copy Results To: ex1
- Visibility: True
Workbook Open
Open an existing Excel workbook.
Properties

- Workbook Open
- Excel: Parameter name that has the reference to the Excel application instance (if an instance exists already)
- Path: Full path of the Excel file you want to open
- Copy Results To: Parameter name to store the workbook instance
- Excel New
- Copy Results To: Parameter name to store the Excel application instance (if an instance does exist already and should be created)
- Visible: Whether the application should be visible or not
Opens an existing Excel workbook.

Properties
- Workbook Open
- Path: pathCombine(pathCurrent(),’Excel Tutorials\\files\\workBook1.xlsx’)
- Copy Results To: wb1
- Excel New
- Copy Results To: ex1
- Visibility: True
Workbook Save
Save a workbook in a given location.
Properties

- Path: Full path of the Excel file you want to save
- Workbook: Name of the workbook instance you want to save
Saves a newly created Excel workbook.

- Path: pathCombine(pathCurrent(),’Excel Tutorials\\files\\workBook2.xlsx’)
- Workbook: wb1
Workbook Close
Close a workbook.
Properties

- Workbook: Workbook instance name of the workbook you want to close.
Closes an opened Excel workbook.

Properties
- Workbook: wb1
Sheet New
Create and open a new Excel sheet in a workbook.
Properties

- Workbook: Name of the workbook instance you want to create the sheet
- Sheet: Name of the sheet
- Copy Results To: Parameter name to store the newly created sheet instance
Creates a new sheet in a given workbook.

Properties
- Workbook: wb1
Sheet Delete
Delete an existing sheet of a workbook.
Properties

- Workbook: Name of the workbook instance
- Sheet: Name of the sheet you want to delete
Deletes a sheet in a given workbook.

Properties
- Workbook: wb1
- Sheet: Sheet1
Sheet List
Gives a list of sheets of a workbook.
Properties

- Workbook: Name of the workbook instance
- Copy Result To: Name of the variable to store the list of sheets
Creates a workbook and a sheet, and return the list of sheets in the workbook.

Properties
- Workbook: wb1
- Copy Result To: sheetList
Sheet Count
Count the number of sheets of a workbook.
Properties

- Workbook: Name of the workbook instance
- Copy Result To: Name of the variable to store the sheet count
Creates a workbook and a sheet, and counts the number of sheets in the workbook.

Properties
- Workbook: wb1
- Copy Result To: sheetCount
Sheet Exists
Checks whether a given sheet exists in a given workbook.
Properties

- Workbook: Name of the workbook instance
- Sheet: Name of the sheet to check the existence
- Copy Result To: Name of the variable to store the result (Yes if exists, otherwise No)
Creates a workbook and a sheet, and checks whether the given sheet exists in the workbook.

Properties
- Workbook: wb1
- Sheet: Sheet2
- Copy Result To: sheetExist
Cell Get
Get the values of a given cell range.
Properties

- Workbook: Name of the workbook instance
- Sheet: Name of the sheet
- Copy Result To: Name of the variable to store the result
- Cell Start: Starting cell to get values
- Cell End: Ending cell of getting values
- Multiple Results: True/ False (If you want to get data only from one cell leave it false)
Get data from cell B2.

Properties
- Workbook: wb1
- Sheet: Sheet1
- Copy Result To: results
- Cell Start: B2
- Multiple Results: False
Cell Set
Sets the values to a given cell range.
Properties

- Workbook: Name of the workbook instance
- Sheet: Name of the sheet
- Copy Result To: Name of the variable to store the result
- Cell Start: Starting cell to assign values
- Cell End: Ending cell of assigning values
- Values: values to assign (This can be a value/ expression to do calculations)
Set ‘hello’ from cell A1 to D4.

Properties
- Workbook: wb1
- Sheet: Sheet1
- Cell Start: a1
- Cell End: d4
- Values: hello
Windows Commands
These commands are available on Windows applications.
New App
Open a new Windows Application window.
Properties

- Application Path: Path of the application to run
- Copy Results to: Name of the parameter that holds the application instance
Opens a new Notepad application instance.

Properties
- Application Path: notepad.exe
- Copy Results To: app
Close App
Close an opened window.
Properties

- Application: Name of the parameter that holds the application instance you want to close
Closes an opened Notepad application instance.

Properties
- Application: app
Find Window
Find a popup window of a given opened window.
Properties

- Target Browser/ App: Name of the parameter that holds the application instance
- Lookup Key: Type of the identifier to be used in the search
- Search Value: The value to search for in the application elements
- Policy: If lookup value is an array of values, the policy defines whether to find all or any of them that is possible
- All
- Any
- Copy Element To: Name f the parameter that holds the search result
- Timeout: Wait until the element is found. Value is in milliseconds (For example, 1000 means 1 second)
- Safe Lookup: Safe lookup does not throw exceptions if the element is not found. Instead set the target parameter to null
- Multiple Results: The search result can return multiple elements/ not if there are more than elements found
- True
- False
Find Save As window in an opened Notepad application instance and store in a parameter.

It will open a Notepad application, Click on File –> Save As and then select the Save As window.
Properties
- Target Browser/ App: app
- Lookup Key: Title
- Search Value: Save As
- Copy Element To: el
Set Text
Set text of a text area.
Properties

- Element: Target element parameter name
- Text Value: Text value to set on the element
- Target Browser/ App: Name of the parameter that holds the application instance
- Lookup Key: Type of the identifier to be used in the search
- Search Value: The value to search for in the application elements
- Policy: If lookup value is an array of values, the policy defines whether to find all or any of them that is possible
- All
- Any
- Copy Element To: Name f the parameter that holds the search result
- Timeout: Wait until the element is found. Value is in milliseconds (For example, 1000 means 1 second)
- Multiple Results: The search result can return multiple elements/ not if there are more than elements found
- True
- False
Set text to hello in an opened Notepad application instance.

It will open a Notepad application, set text to hello in the text area.
Properties
- Text Value: hello
- Target Browser/ App: app
- Lookup Key: ClassName
- Search Value: Edit
Find Element
Find elements on an opened window.
Properties

- Target Browser/ App: Name of the parameter that holds the application instance
- Lookup Key: Type of the identifier to be used in the search
- Search Value: The value to search for in the application elements
- Policy: If lookup value is an array of values, the policy defines whether to find all or any of them that is possible
- All
- Any
- Copy Element To: Name f the parameter that holds the search result
- Timeout: Wait until the element is found. Value is in milliseconds (For example, 1000 means 1 second)
- Safe Lookup: Safe lookup does not throw exceptions if the element is not found. Instead set the target parameter to null
- Multiple Results: The search result can return multiple elements/ not if there are more than elements found
- True
- False
Find the text area on an opened Notepad application instance and store in a parameter.

Properties
- Target Browser/ App: app
- Lookup Key: Id
- Search Value: 15
- Copy Element To: el
Mouse Button
Perform mouse button actions such as left click, right click, etc.
Properties

Mouse Button
- Element: Target element parameter name
- Button Action: Action of the mouse button to perform
- LeftClick
- RightClick
- MiddleClick
- LeftDown
- RightDown
- MiddleDown
- LeftUp
- RightUp
- MiddleUp
- DoubleClick
Find Element
- Target Browser/ App: Name of the parameter that holds the application instance
- Lookup Key: Type of the identifier to be used in the search
- Search Value: The value to search for in the application elements
- Policy: If lookup value is an array of values, the policy defines whether to find all or any of them that is possible
- All
- Any
- Copy Element To: Name f the parameter that holds the search result
- Timeout: Wait until the element is found. Value is in milliseconds (For example, 1000 means 1 second)
- Multiple Results: The search result can return multiple elements/ not if there are more than elements found
- True
- False
Click on File menu on an opened Notepad application instance.

Properties
- Button Action: LeftClick
- Target Browser/ App: app
- Lookup Key: Name
- Search Value: File
Mouse Move
Move mouse pointer.
Properties

Mouse Move
- Element: Target element parameter name
- Action: Action of the mouse movement to perform
- MoveToElement
- MoveByOffset
- Offset X: X coordinate in the element
- Offset Y: Y coordinate in the element
Find Element
- Target Browser/ App: Name of the parameter that holds the application instance
- Lookup Key: Type of the identifier to be used in the search
- Search Value: The value to search for in the application elements
- Policy: If lookup value is an array of values, the policy defines whether to find all or any of them that is possible
- All
- Any
- Copy Element To: Name f the parameter that holds the search result
- Timeout: Wait until the element is found. Value is in milliseconds (For example, 1000 means 1 second)
- Multiple Results: The search result can return multiple elements/ not if there are more than elements found
- True
- False
Move the mouse to File menu on an opened Notepad application instance.

Properties
- Action: MoveToElement
- Target Browser/ App: app
- Lookup Key: Name
- Search Value: File
Keyboard
Use the keyboard keys.
Properties

Keyboard
- Element: Target element parameter name
- Auto Focus: Focus on the element before performing the keyboard action
- True
- False
- Keys: Keys to be entered. (Use {KeyName} for special keys. For example, {enter} for the Enter key)
- Key Action: Type of the keyboard action
- KeyUp
- KeyDown
- Send
Find Element
- Target Browser/ App: Name of the parameter that holds the application instance
- Lookup Key: Type of the identifier to be used in the search
- Search Value: The value to search for in the application elements
- Policy: If lookup value is an array of values, the policy defines whether to find all or any of them that is possible
- All
- Any
- Copy Element To: Name f the parameter that holds the search result
- Timeout: Wait until the element is found. Value is in milliseconds (For example, 1000 means 1 second)
- Multiple Results: The search result can return multiple elements/ not if there are more than elements found
- True
- False
Type in the text area on an opened Notepad application instance.

Properties
- Keys: hi{enter}hi again
- Key Action: Send
- Target Browser/ App: app
- Lookup Key: Id
- Search Value: 15