Robotics Commands

Print Friendly, PDF & Email

◷ 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.

Summary

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
  • 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

Example

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-21q 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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

New Browser

Opens a new browser with a specific mode: secure (private) or insecure.

Summary

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)

Example

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.

Summary

Properties

  • Target Browser: Target browser to close

Example

Flow for the example is given here.

Example 1

Close opened browser

Properties

  • Target Browser: web1

Navigates to a web page.

Summary

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

Example 1

Navigate to Google using a created ‘New Browser’ instance

Properties

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

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.

Summary

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

Example

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.

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Run JavaScript

Runs a JavaScript code in the open web browser.

Summary

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

Example

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)

For Example 1 and 2, it is required to create a Navigate To instance named web1 to open the web page.

List Action

Selects or Deselects options in a list of a web form.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Set Text

Sets the text of a given HTML element in a web browser.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Get Text

Gets the text of a given HTML element in a web browser.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Get Title

Gets the title of a web browser.

Summary

Properties

  • Target Browser: Target browser to get the title from
  • Copy Result To: Name of the parameter that holds to the search results

Example

Flow for the example is given here.

Example 1

Get the title of a web browser.

Properties

  • Target Browser: web1
  • Copy Result To: result

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Get Url

Gets the Url of a web browser.

Summary

Properties

  • Target Browser: Target browser to get the URL from
  • Copy Result To: Name of the parameter that holds to the search results

Example

Flow for the example is given here.

Example 1

Get the URL of a web browser.

Properties

  • Target Browser: web1
  • Copy Result To: result

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Set Attribute

Sets an attribute of a form.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Select File

Selects a file in a form.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Get Attribute

Gets an attribute of a form.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Mouse Button

Performs mouse button actions.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Mouse Move

Performs mouse move actions.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Keyboard

Performs keyboard actions.

Summary

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

Example

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

Create a Navigate To instance named web1 to open the web form.

See Variable Parameter to understand how to declare a variable parameter.

Excel Commands

These commands are available on an Excel RPA.

Excel New

Open a new Excel Application window.

Summary

Properties

  • Copy Results To: Parameter name to store the newly created Excel application instance
  • Visible: Whether the application should be visible or not

Example

Opens a new Excel application instance.

Properties

  • Copy Results To: ‘wb1’
  • Visibility: ‘True’

See Variable Parameter to understand how to declare a variable parameter.

Excel Close

Close an opened Excel Application window.

Summary

Properties

  • Excel: Name of the Excel instance to close

Example

Closes an opened Excel application instance.

  • Excel: ex1

See Variable Parameter to understand how to declare a variable parameter.

Workbook New

Open a new Excel workbook.

Summary

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

Example

Opens a new Excel workbook.

Properties

  • Workbook New
    • Copy Results To: wb1
  • Excel New
    • Copy Results To: ex1
    • Visibility: True

See Variable Parameter to understand how to declare a variable parameter.

Workbook Open

Open an existing Excel workbook.

Summary

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

Example

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

See Variable Parameter to understand how to declare a variable parameter.

Workbook Save

Save a workbook in a given location.

Summary

Properties

  • Path: Full path of the Excel file you want to save
  • Workbook: Name of the workbook instance you want to save

Example

Saves a newly created Excel workbook.

  • Path: pathCombine(pathCurrent(),’Excel Tutorials\\files\\workBook2.xlsx’)
  • Workbook: wb1

See Variable Parameter to understand how to declare a variable parameter.

Workbook Close

Close a workbook.

Summary

Properties

  • Workbook: Workbook instance name of the workbook you want to close.

Example

Closes an opened Excel workbook.

Properties

  • Workbook: wb1

See Variable Parameter to understand how to declare a variable parameter.

Sheet New

Create and open a new Excel sheet in a workbook.

Summary

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

Example

Creates a new sheet in a given workbook.

Properties

  • Workbook: wb1

See Variable Parameter to understand how to declare a variable parameter.

Sheet Delete

Delete an existing sheet of a workbook.

Summary

Properties

  • Workbook: Name of the workbook instance
  • Sheet: Name of the sheet you want to delete

Example

Deletes a sheet in a given workbook.

Properties

  • Workbook: wb1
  • Sheet: Sheet1

See Variable Parameter to understand how to declare a variable parameter.

Sheet List

Gives a list of sheets of a workbook.

Summary

Properties

  • Workbook: Name of the workbook instance
  • Copy Result To: Name of the variable to store the list of sheets

Example

Creates a workbook and a sheet, and return the list of sheets in the workbook.

Properties

  • Workbook: wb1
  • Copy Result To: sheetList

See Variable Parameter to understand how to declare a variable parameter.

Sheet Count

Count the number of sheets of a workbook.

Summary

Properties

  • Workbook: Name of the workbook instance
  • Copy Result To: Name of the variable to store the sheet count

Example

Creates a workbook and a sheet, and counts the number of sheets in the workbook.

Properties

  • Workbook: wb1
  • Copy Result To: sheetCount

See Variable Parameter to understand how to declare a variable parameter.

Sheet Exists

Checks whether a given sheet exists in a given workbook.

Summary

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)

Example

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

See Variable Parameter to understand how to declare a variable parameter.

Cell Get

Get the values of a given cell range.

Summary

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)

Example

Get data from cell B2.

Properties

  • Workbook: wb1
  • Sheet: Sheet1
  • Copy Result To: results
  • Cell Start: B2
  • Multiple Results: False

See Variable Parameter to understand how to declare a variable parameter.

Cell Set

Sets the values to a given cell range.

Summary

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)

Example

Set ‘hello’ from cell A1 to D4.

Properties

  • Workbook: wb1
  • Sheet: Sheet1
  • Cell Start: a1
  • Cell End: d4
  • Values: hello

See Variable Parameter to understand how to declare a variable parameter.

Windows Commands

These commands are available on Windows applications.

New App

Open a new Windows Application window.

Summary

Properties

  • Application Path: Path of the application to run
  • Copy Results to: Name of the parameter that holds the application instance

Example

Opens a new Notepad application instance.

Properties

  • Application Path: notepad.exe
  • Copy Results To: app

See Variable Parameter to understand how to declare a variable parameter.

Close App

Close an opened window.

Summary

Properties

  • Application: Name of the parameter that holds the application instance you want to close

Example

Closes an opened Notepad application instance.

Properties

  • Application: app

See Variable Parameter to understand how to declare a variable parameter.

Find Window

Find a popup window of a given opened window.

Summary

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

Example

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

See Variable Parameter to understand how to declare a variable parameter.

Set Text

Set text of a text area.

Summary

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

Example

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

See Variable Parameter to understand how to declare a variable parameter.

Find Element

Find elements on an opened window.

Summary

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

Example

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

See Variable Parameter to understand how to declare a variable parameter.

Mouse Button

Perform mouse button actions such as left click, right click, etc.

Summary

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

Example

Click on File menu on an opened Notepad application instance.

Properties

  • Button Action: LeftClick
  • Target Browser/ App: app
  • Lookup Key: Name
  • Search Value: File

See Variable Parameter to understand how to declare a variable parameter.

Mouse Move

Move mouse pointer.

Summary

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

Example

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

See Variable Parameter to understand how to declare a variable parameter.

Keyboard

Use the keyboard keys.

Summary

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

Example

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

Updated on July 31, 2019

Was this article helpful?

Related Articles