Application Manager Operations

Actions

Get Window Attribute

Get the current value of a window attribute.

Parameters
Name Data Type Description
Attribute Name text The name of the attribute to get.

The internal ID for this action is 'GetWindowIdentifier'

Works with the following element types:

Get AA Attribute

Get the current value of an Active Accessibility attribute.

Parameters
Name Data Type Description
Attribute Name text The name of the attribute to get.

The internal ID for this action is 'GetAAIdentifier'

Works with the following element types:

Get HTML Attribute

Get the current value of an HTML attribute.

Parameters
Name Data Type Description
Attribute Name text The name of the attribute to get.

The internal ID for this action is 'GetHTMLIdentifier'

Works with the following element types:

Get JAB Attribute

Get the current value of a Java Access Bridge attribute.

Parameters
Name Data Type Description
Attribute Name text The name of the attribute to get.

The internal ID for this action is 'GetJABIdentifier'

Works with the following element types:

Get UIA Attribute

Get the current value of a UI Automation attribute.

Parameters
Name Data Type Description
Attribute Name text The name of the attribute to get.

The internal ID for this action is 'GetUIAIdentifier'

Works with the following element types:

Get Bounds

Gets information about the bounding rectangle of the element, in coordinates relative to the parent.

This action takes no parameters

The internal ID for this action is 'GetElementBounds'

Works with the following element types:

Get Relative Bounds

Gets information about the bounding rectangle of the element, in coordinates relative to the parent.

This action takes no parameters

The internal ID for this action is 'GetRelativeElementBounds'

Works with the following element types:

Get Screen Bounds

Gets information about the bounding rectangle of the element, in screen coordinates.

This action takes no parameters

The internal ID for this action is 'GetElementScreenBounds'

Works with the following element types:

Get Bounds

Gets information about the bounding rectangle of the element, in coordinates relative to the parent.

This action takes no parameters

The internal ID for this action is 'RegionGetElementBounds'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Bounds

Gets information about the bounding rectangle of the element, in coordinates relative to the parent.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListRegionGetElementBounds'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Bounds

Gets information about the bounding rectangle of the element, in coordinates relative to the parent.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridRegionGetElementBounds'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Screen Bounds

Gets information about the bounding rectangle of the element, in screen coordinates.

This action takes no parameters

The internal ID for this action is 'RegionGetElementScreenBounds'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Screen Bounds

Gets information about the bounding rectangle of the element, in screen coordinates.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListRegionGetElementScreenBounds'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Screen Bounds

Gets information about the bounding rectangle of the element, in screen coordinates.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridRegionGetElementScreenBounds'

Works with the following element types:

'''Global action''' - the target application must have focus.

Click Window

Send a click message to the window at the specified position. The position is relative to the top left of the window.

Parameters
Name Data Type Description
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'ClickWindow'

Works with the following element types:

Click Window Centre

Send a click message to the centre of the window.

Parameters
Name Data Type Description
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'ClickWindowCentre'

Works with the following element types:

Global Mouse Click

Click the element at the specified position, using a global mouse click. The position is relative to the top left of the element's bounding rectangle. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'MouseClick'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Double Mouse Click

Double click the element at the specified position, using a global mouse click. The position is relative to the top left of the element's bounding rectangle. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'MouseDoubleClick'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click Centre

Click the element at its centre, using a global mouse click.

Parameters
Name Data Type Description
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'MouseClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Double Mouse Click Centre

Double click the element at its centre, using a global mouse click.

Parameters
Name Data Type Description
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'MouseDoubleClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click

Click the region at the specified position, using a global mouse click. The position is relative to the top left of the region. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'RegionMouseClick'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click

Click the region at the specified position, using a global mouse click. The position is relative to the top left of the region. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'ListRegionMouseClick'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click

Click the region at the specified position, using a global mouse click. The position is relative to the top left of the region. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'GridRegionMouseClick'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click Centre

Click the region at its centre, using a global mouse click. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'RegionMouseClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click Centre

Click the region at its centre, using a global mouse click. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'ListRegionMouseClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click Centre

Click the region at its centre, using a global mouse click. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'GridRegionMouseClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Click Centre

Click the parent window of the region at the centre of the region.

This action takes no parameters

The internal ID for this action is 'RegionParentClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Click Centre

Click the parent window of the region at the centre of the region.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListRegionParentClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Click Centre

Click the parent window of the region at the centre of the region.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridRegionParentClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Start Drag

Start a drag-drop operation by dragging from the centre of the region. Must be followed by a drop operation on another element.

This action takes no parameters

The internal ID for this action is 'RegionStartDrag'

Works with the following element types:

'''Global action''' - the target application must have focus.

Start Drag

Start a drag-drop operation by dragging from the centre of the region. Must be followed by a drop operation on another element.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListRegionStartDrag'

Works with the following element types:

'''Global action''' - the target application must have focus.

Start Drag

Start a drag-drop operation by dragging from the centre of the region. Must be followed by a drop operation on another element.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridRegionStartDrag'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drop Onto

End a drag-drop operation by dropping onto the region, at its centre. Must be preceded by a drag operation on another element.

This action takes no parameters

The internal ID for this action is 'RegionDropOnto'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drop Onto

End a drag-drop operation by dropping onto the region, at its centre. Must be preceded by a drag operation on another element.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListRegionDropOnto'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drop Onto

End a drag-drop operation by dropping onto the region, at its centre. Must be preceded by a drag operation on another element.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridRegionDropOnto'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drag

Start dragging from a given position over the window

Parameters
Name Data Type Description
X number The X coordinate of the point at which to start dragging, relative to the window
Y number The Y coordinate of the point at which to start dragging, relative to the window

The internal ID for this action is 'Drag'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drop

Drop at the given position over the window - must follow a drag

Parameters
Name Data Type Description
X number The X coordinate of the point at which to perform the drop, relative to the window
Y number The Y coordinate of the point at which to perform the drop, relative to the window

The internal ID for this action is 'Drop'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drag Listview Item

Start dragging the listview item with the specified text

Parameters
Name Data Type Description
Item Text text The text of the listview item to be dragged. If not unique, then the first matching item found will be dragged.

The internal ID for this action is 'DragItem'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drop Onto Listview Item

Drop onto the listview item with the specified text - must follow a drag

Parameters
Name Data Type Description
Item Text text The text of the listview item onto which the drop should be performed. If not unique, then the first matching item found will be chosen.

The internal ID for this action is 'DropOntoItem'

Works with the following element types:

'''Global action''' - the target application must have focus.

Close

Asks a window to close.

This action takes no parameters

The internal ID for this action is 'CloseWindow'

Works with the following element types:

Focus

Focuses an HTML element.

This action takes no parameters

The internal ID for this action is 'HTMLFocus'

Works with the following element types:

Press

Press a button

This action takes no parameters

The internal ID for this action is 'Press'

Works with the following element types:

'''Global action''' - the target application must have focus.

Set Field

Set the contents of a terminal field

Parameters
Name Data Type Description
Text text The new text to be entered into the field.

The internal ID for this action is 'SetField'

Works with the following element types:

Read Field

Read the contents of a terminal field

This action takes no parameters

The internal ID for this action is 'GetField'

Works with the following element types:

Search Terminal

Search the whole terminal for instances of the given text. Case insensitive.

Parameters
Name Data Type Description
Text text The text to search for.

The internal ID for this action is 'SearchTerminal'

Works with the following element types:

Get Cursor Position

Gets the row/column position of the cursor in the presentation space

This action takes no parameters

The internal ID for this action is 'GetMainframeCursorPos'

Works with the following element types:

Set Cursor Position

Sets the row/column position of the cursor in the presentation space

Parameters
Name Data Type Description
Row Index number The 1-based index of the row at which the cursor should be located. This value must not exceed the number of rows available.
Column Index number The 1-based index of the column at which the cursor should be located. This value must not exceed the number of columns available.

The internal ID for this action is 'SetMainframeCursorPos'

Works with the following element types:

Get Window Title

Gets the title of the window in which the terminal emulator resides

This action takes no parameters

The internal ID for this action is 'GetMainframeParentWindowTitle'

Works with the following element types:

Set Window Title

Sets the title of the window in which the terminal emulator resides

Parameters
Name Data Type Description
New Title text The new title of the mainframe emulator window.

The internal ID for this action is 'SetMainframeParentWindowTitle'

Works with the following element types:

Run Macro

Runs the specified macro defined on the emulator instance

Parameters
Name Data Type Description
Macro Name text The name of the macro to be run, only. File paths are not supported.

The internal ID for this action is 'RunMainframeMacro'

Works with the following element types:

Set Text

Set the windowtext for a window.

Parameters
Name Data Type Description
Text text The new text to be sent to the window.

The internal ID for this action is 'SetText'

Works with the following element types:

Read Text with OCR

Read text using OCR from a rectangular area on a window

Parameters
Name Data Type Description
Language text The Tesseract language code to use. Default is 'eng'.
Page Segmentation Mode text The Tesseract page segmentation mode to use. Default is 'Auto'.
Character Whitelist text Whitelist of characters to recognise.
Diagnostics Path text Optional. Can be used to specify a directory where diagnostics files will be saved - e.g. intermediate processed images.
Scale number Set the internal image scale factor. Default is 4.

The internal ID for this action is 'ReadTextOCR'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text with OCR

Read text using OCR from a rectangular area on a window

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
Language text The Tesseract language code to use. Default is 'eng'.
Page Segmentation Mode text The Tesseract page segmentation mode to use. Default is 'Auto'.
Character Whitelist text Whitelist of characters to recognise.
Diagnostics Path text Optional. Can be used to specify a directory where diagnostics files will be saved - e.g. intermediate processed images.
Scale number Set the internal image scale factor. Default is 4.

The internal ID for this action is 'ListReadTextOCR'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text with OCR

Read text using OCR from a rectangular area on a window

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
Language text The Tesseract language code to use. Default is 'eng'.
Page Segmentation Mode text The Tesseract page segmentation mode to use. Default is 'Auto'.
Character Whitelist text Whitelist of characters to recognise.
Diagnostics Path text Optional. Can be used to specify a directory where diagnostics files will be saved - e.g. intermediate processed images.
Scale number Set the internal image scale factor. Default is 4.

The internal ID for this action is 'GridReadTextOCR'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text (Legacy)

Read text discovered using invasive techniques within a rectangular area of a window

This action takes no parameters

The internal ID for this action is 'GetText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text (Legacy)

Read text discovered using invasive techniques within a rectangular area of a window

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListGetText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text (Legacy)

Read text discovered using invasive techniques within a rectangular area of a window

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridGetText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text

Read text discovered values. The text was found based on the centre of the text being contained within the specified region within the window. (Method used: Invasive)

This action takes no parameters

The internal ID for this action is 'GetTextCenter'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text

Read text discovered values. The text was found based on the centre of the text being contained within the specified region within the window. (Method used: Invasive)

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListGetTextCenter'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Text

Read text discovered values. The text was found based on the centre of the text being contained within the specified region within the window. (Method used: Invasive)

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridGetTextCenter'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text

Read text using character matching from a rectangular area on a window

Parameters
Name Data Type Description
Font text The name of the font to use. Default is 'System'.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.

The internal ID for this action is 'RecogniseText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text

Read text using character matching from a rectangular area on a window

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
Font text The name of the font to use. Default is 'System'.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.

The internal ID for this action is 'ListRecogniseText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text

Read text using character matching from a rectangular area on a window

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
Font text The name of the font to use. Default is 'System'.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.

The internal ID for this action is 'GridRecogniseText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Single Line Text

Read text using character matching from a rectangular area on a window, which is known to represent a single line of text.

Parameters
Name Data Type Description
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.

The internal ID for this action is 'RecogniseSingleLineText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Single Line Text

Read text using character matching from a rectangular area on a window, which is known to represent a single line of text.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.

The internal ID for this action is 'ListRecogniseSingleLineText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Single Line Text

Read text using character matching from a rectangular area on a window, which is known to represent a single line of text.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.

The internal ID for this action is 'GridRecogniseSingleLineText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Multi-line Text

Read text using character matching from a rectangular area on a window, which is known to represent more than one line of text.

Parameters
Name Data Type Description
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'RecogniseMultiLineText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Multi-line Text

Read text using character matching from a rectangular area on a window, which is known to represent more than one line of text.

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'ListRecogniseMultiLineText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Multi-line Text

Read text using character matching from a rectangular area on a window, which is known to represent more than one line of text.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'GridRecogniseMultiLineText'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text

Read text using character matching from a rectangular area on a window

Parameters
Name Data Type Description
Font text The name of the font to use. Default is 'System'.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Split Lines flag True to split each subregion into lines before matching. Default: False
Use Original Algorithm flag True to use the backwards compatible algorithm for reading characters which scans across then down. Default: False
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'ReadChars'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text

Read text using character matching from a rectangular area on a window

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
Font text The name of the font to use. Default is 'System'.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Split Lines flag True to split each subregion into lines before matching. Default: False
Use Original Algorithm flag True to use the backwards compatible algorithm for reading characters which scans across then down. Default: False
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'ListReadChars'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text

Read text using character matching from a rectangular area on a window

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
Font text The name of the font to use. Default is 'System'.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Split Lines flag True to split each subregion into lines before matching. Default: False
Use Original Algorithm flag True to use the backwards compatible algorithm for reading characters which scans across then down. Default: False
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'GridReadChars'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Image

Read image from a rectangular area on a window

This action takes no parameters

The internal ID for this action is 'ReadBitmap'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Image

Read image from a rectangular area on a window

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1

The internal ID for this action is 'ListReadBitmap'

Works with the following element types:

'''Global action''' - the target application must have focus.

Read Image

Read image from a rectangular area on a window

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1

The internal ID for this action is 'GridReadBitmap'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text In Range

Read text using character matching from a series of rectangular areas on a window, which are known to represent a single line of text.

Parameters
Name Data Type Description
First Element number The first element in the list region to read. Default is 1
Last Element number The last element in the list region to read. Default is 1
Split Lines flag True to split each subregion into lines before matching. Default: False
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'ListReadCharsInRange'

Works with the following element types:

'''Global action''' - the target application must have focus.

Recognise Text In Table

Reads the text in each cell defined in the grid region.

Parameters
Name Data Type Description
Split Lines flag True to split each subregion into lines before matching. Default: False
Font text The name of the font to use.
Colour text The text colour, e.g. FF0000. Default is black.
Background Colour text Optional. Used to specify the background colour against which the text is set. If used, the colour of the text must not be specified. Input format must be a six-character hex sequence specifying the background colour, e.g. FF0000.
Erase Blocks flag Optional; default False. Set to True to automatically detect and erase coloured blocks surrounding text, such as a highlighted selection in a listview.

The internal ID for this action is 'GridReadTable'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Conflicting Font Characters

Get a collection of conflicting character groups. Each row contains a string under the 'Character Group' field, representing a group of characters whose appearance is identical within the font of interest.

Parameters
Name Data Type Description
Font text The name of the font of interest.

The internal ID for this action is 'GetConflictingFontCharacters'

Works with the following element types:

Get Text

Get the text for a window

This action takes no parameters

The internal ID for this action is 'GetWindowText'

Works with the following element types:

Get Win32 Parent Text

Get the text for a region's Win32 parent control/window

This action takes no parameters

The internal ID for this action is 'GetRegionWindowText'

Works with the following element types:

Is Window Active

Indicates whether a window is the active window - the window which receives user input

This action takes no parameters

The internal ID for this action is 'IsWindowActive'

Works with the following element types:

Get Checked

Reads the 'checked' value from a checkbox, radio button, etc

This action takes no parameters

The internal ID for this action is 'GetChecked'

Works with the following element types:

Get Checked

Reads the 'checked' value from a checkbox, radio button, etc

This action takes no parameters

The internal ID for this action is 'NetGetChecked'

Works with the following element types:

Show Dropdown

Show the dropdown list on a combobox or menu

This action takes no parameters

The internal ID for this action is 'ShowDropdown'

Works with the following element types:

Hide Dropdown

Hide the dropdown list on a combobox or menu

This action takes no parameters

The internal ID for this action is 'HideDropdown'

Works with the following element types:

Get Text

Read the text of a java element

This action takes no parameters

The internal ID for this action is 'JABGetText'

Works with the following element types:

Get Selected Text

Read the selected text of a java element

This action takes no parameters

The internal ID for this action is 'JABGetSelectedText'

Works with the following element types:

Select Text

Select a portion of the text in an editable java element

Parameters
Name Data Type Description
Start Position number The one-based start index of the text to be selected. This must be within the range of available characters.
Length number The number of characters to be selected. This must be within the range of available characters, relative to the specified start position.

The internal ID for this action is 'JABSelectText'

Works with the following element types:

Select All Text

Select all of the text in an editable java element

This action takes no parameters

The internal ID for this action is 'JABSelectAllText'

Works with the following element types:

Get Checked

Reads the 'checked' value from a java checkbox, radio button, toggle button, etc

This action takes no parameters

The internal ID for this action is 'JABGetChecked'

Works with the following element types:

Set Checked

Writes the 'checked' value to a java checkbox, radio button, toggle button, etc

This action takes no parameters

The internal ID for this action is 'JABSetChecked'

Works with the following element types:

Is Selected

Reads the 'selected' value from a java element, such as a list item, a tab page, etc

This action takes no parameters

The internal ID for this action is 'JABIsSelected'

Works with the following element types:

Is Expanded

Reads the 'expanded' value from a java element, such as a tree node, a combo box, etc

This action takes no parameters

The internal ID for this action is 'JABIsExpanded'

Works with the following element types:

Hide Drop Down

Hides the drop-down portion of a java element such as a menu, combobox, etc

This action takes no parameters

The internal ID for this action is 'JABHideDropdown'

Works with the following element types:

Show Drop Down

Shows the drop-down portion of a java element such as a menu, combobox, etc

This action takes no parameters

The internal ID for this action is 'JABShowDropdown'

Works with the following element types:

Collapse Item

Collapse a java tree node, if it is expanded

This action takes no parameters

The internal ID for this action is 'JABCollapseTreeNode'

Works with the following element types:

Expand Item

Expand a java tree node, if it is expanded

This action takes no parameters

The internal ID for this action is 'JABExpandTreeNode'

Works with the following element types:

Toggle Item Expansion

Toggles the expanded state of a java tree node, if it has children

This action takes no parameters

The internal ID for this action is 'JABToggleTreeNode'

Works with the following element types:

Select Item

Selects a java item identified by its text or its position - eg from a menu dropdown, a combo box, a tab control, etc

Parameters
Name Data Type Description
Item Text text The text of the item to be selected. If not unique, then the first matching item found will be selected.
Item Position number The 1-based index of the item to be selected. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'JABSelectItem'

Works with the following element types:

Ensure Item Visible

Selects a java item identified by its text or its position - eg from a menu dropdown, a combo box, a tab control, etc

Parameters
Name Data Type Description
Item Text text The text of the item. Only used when no value is supplied to the Position parameter
Item Position number The 1-based index of the item. If this parameter is used then the Text parameter will be ignored

The internal ID for this action is 'JABEnsureItemVisible'

Works with the following element types:

Select All Items

Selects all child items - eg in a list

This action takes no parameters

The internal ID for this action is 'JABSelectAllItems'

Works with the following element types:

Clear Selection

Clears the selection of child items - eg in a list

This action takes no parameters

The internal ID for this action is 'JABClearSelection'

Works with the following element types:

Count Selected Items

Counts and returns the number of selected items contained in a java listview, Treeview, ListBox, etc.

This action takes no parameters

The internal ID for this action is 'JABGetSelectedItemCount'

Works with the following element types:

Get All Items

Gets all rows and columns (of a listview, combobox, datagrid etc) as a collection. For simple controls, the collection has a single field called 'Item Text'. For multi-column controls, the fields will be named as they are in the control, where possible - otherwise names such as 'Column1', 'Column2' will be used.

This action takes no parameters

The internal ID for this action is 'GetAllItems'

Works with the following element types:

Get Treenode Child Items

Gets all child items of the specified item in a treeview, as a collection.

Parameters
Name Data Type Description
Item Text text The text of the treenode of interest. If not unique, then the first matching item will be retrieved.

The internal ID for this action is 'GetTreenodeChildItems'

Works with the following element types:

Get Treenode Sibling Items

Gets all sibling items of the specified item in a treeview, as a collection. The returned collection includes the item specified, as well as its siblings.

Parameters
Name Data Type Description
Item Text text The text of the treenode of interest. If not unique, then the first matching item will be retrieved.

The internal ID for this action is 'GetTreenodeSiblingItems'

Works with the following element types:

Go To Cell

Set the current position to a particular cell

Parameters
Name Data Type Description
Row number The 1-based row number
Column number The 1-based column number

The internal ID for this action is 'GoToCell'

Works with the following element types:

Set Top Row

Set the top visible row - this row may not actually go to the top if there are not enough rows below it.

Parameters
Name Data Type Description
Row number The 1-based row number

The internal ID for this action is 'SetTopRow'

Works with the following element types:

Get Row Offset

Get the offset, in pixels, of the top of the given row from the top of the grid.

Parameters
Name Data Type Description
Row number The 1-based row number

The internal ID for this action is 'GetRowOffset'

Works with the following element types:

Select Range

Select a range of cells

Parameters
Name Data Type Description
Row number The 1-based row number
Column number The 1-based column number
End Row number The end column number
End Column number The end column number

The internal ID for this action is 'SelectRange'

Works with the following element types:

Get Item

Gets all data associated with an item, as a collection (eg every column of a listview, for the item in question).

Parameters
Name Data Type Description
Item Text text The main text of the item of interest (eg the text of the first column in a listview item). If not unique, then the first matching item will be retrieved.
Item Position number The 1-based index of the item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'GetItem'

Works with the following element types:

Get Selected Items

Gets all selected rows and columns (of a listview, combobox, datagrid etc) as a collection.

This action takes no parameters

The internal ID for this action is 'GetSelectedItems'

Works with the following element types:

Is Item Selected

Reads the 'selected' value from a child of the chosen element. Eg from an item in a listview, etc

Parameters
Name Data Type Description
Item Text text The text of the item. Only used when no value is supplied to the Position parameter
Item Position number The 1-based index of the item. If this parameter is used then the Text parameter will be ignored

The internal ID for this action is 'IsItemSelected'

Works with the following element types:

Is Item Checked

Reads the 'checked' value from a child of the chosen element. Eg from an item in a listview, etc

Parameters
Name Data Type Description
Item Text text The text of the item. Only used when no value is supplied to the Position parameter
Item Position number The 1-based index of the item. If this parameter is used then the Text parameter will be ignored

The internal ID for this action is 'IsItemChecked'

Works with the following element types:

Is Item Expanded

Reads the 'expanded' value from a child of the chosen element. Eg from an item in a treeview, etc

Parameters
Name Data Type Description
Item Text text The text of the item. Only used when no value is supplied to the Position parameter
Item Position number The 1-based index of the item. If this parameter is used then the Text parameter will be ignored

The internal ID for this action is 'IsItemExpanded'

Works with the following element types:

Is Item Focused

Reads the 'focused' value from a child of the chosen element. Eg from an item in a treeview, etc.

Parameters
Name Data Type Description
Item Text text The text of the item. Only used when no value is supplied to the Position parameter
Item Position number The 1-based index of the item. If this parameter is used then the Text parameter will be ignored

The internal ID for this action is 'IsItemFocused'

Works with the following element types:

Get Item Image Index

Reads the Image Index of a child of the chosen element. Eg from an item in a listview, treeview, etc.

Parameters
Name Data Type Description
Item Text text The text of the item. Only used when no value is supplied to the Position parameter
Item Position number The 1-based index of the item. If this parameter is used then the Text parameter will be ignored

The internal ID for this action is 'GetItemImageIndex'

Works with the following element types:

Get Current Value

Gets the current value (of a textbox, combobox, listview current row, checkbox, etc). The data type will be that of the calling control (eg flag for a checkbox).

This action takes no parameters

The internal ID for this action is 'ReadCurrentValue'

Works with the following element types:

Ensure Item Visible

Makes sure that the specified item is visible in a Listview or Treeview, by adjusting the scrollbars where necessary.

Parameters
Name Data Type Description
Item Text text The text of the item. Only used when no value is supplied to the Index parameter
Item Position number The 1-based index of the item. If this parameter is used then the Text parameter will be ignored

The internal ID for this action is 'EnsureItemVisible'

Works with the following element types:

Scroll To Top

Scrolls a listview to the top when in details mode.

This action takes no parameters

The internal ID for this action is 'ScrollListviewToTop'

Works with the following element types:

Scroll To Bottom

Scrolls a listview to the bottom when in details mode.

This action takes no parameters

The internal ID for this action is 'ScrollListviewToBottom'

Works with the following element types:

Count Items

Counts and returns the number of items contained in a listview or Treeview.

This action takes no parameters

The internal ID for this action is 'GetItemCount'

Works with the following element types:

Count Selected Items

Counts and returns the number of selected items contained in a listview or Treeview.

This action takes no parameters

The internal ID for this action is 'GetSelectedItemCount'

Works with the following element types:

Get Page Capacity

Gets the number of items that can be displayed on one page, in a Listview (in details mode) or a Treeview.

This action takes no parameters

The internal ID for this action is 'GetPageCapacity'

Works with the following element types:

Get Selected Item Text

Gets the text of the first selected item. Returns an error if no items are selected.

This action takes no parameters

The internal ID for this action is 'GetSelectedItemText'

Works with the following element types:

Expand Item

Expands the specified Treeview item.

Parameters
Name Data Type Description
Item Text text The text of the treenode to be expanded. If not unique, then the first matching node will be expanded.

The internal ID for this action is 'ExpandTreeNode'

Works with the following element types:

Collapse Item

Collapses the specified Treeview item.

Parameters
Name Data Type Description
Item Text text The text of the treenode to be collapsed. If not unique, then the first matching node will be collapsed.

The internal ID for this action is 'CollapseTreeNode'

Works with the following element types:

Toggle Item Expansion

Toggles the expanded state of the specified Treeview item.

Parameters
Name Data Type Description
Item Text text The text of the treenode to be toggled. If not unique, then the first matching node will be toggled.

The internal ID for this action is 'ToggleTreeNode'

Works with the following element types:

Get Value

Gets the numeric value of a control such as the position on a trackbar, a scrollbar, or the value in a numeric up/down control.

This action takes no parameters

The internal ID for this action is 'GetNumericValue'

Works with the following element types:

Set Value

Sets the numeric value of a control such as the position on a trackbar, a scrollbar, or the value in a numeric up/down control.

Parameters
Name Data Type Description
Value number The new value to be set in the control.

The internal ID for this action is 'SetNumericValue'

Works with the following element types:

Get Max Value

Gets the maximum numeric value allowed by a control such as a trackbar, a scrollbar, or a numeric up/down control.

This action takes no parameters

The internal ID for this action is 'GetMaxNumericValue'

Works with the following element types:

Get Min Value

Gets the minimum numeric value allowed by a control such as a trackbar, a scrollbar or a numeric up/down control.

This action takes no parameters

The internal ID for this action is 'GetMinNumericValue'

Works with the following element types:

Get Value

Gets the numeric value of a control such as a java trackbar, a java scrollbar or a java numeric up/down control.

This action takes no parameters

The internal ID for this action is 'JABGetNumericValue'

Works with the following element types:

Set Value

Sets the numeric value of a control such as a java trackbar, a java scrollbar or a java numeric up/down control.

Parameters
Name Data Type Description
Value number The new value to be set in the control.

The internal ID for this action is 'JABSetNumericValue'

Works with the following element types:

Get Max Value

Gets the maximum numeric value allowed by a control such as a java trackbar, a java scrollbar or a java numeric up/down control.

This action takes no parameters

The internal ID for this action is 'JABGetMaxNumericValue'

Works with the following element types:

Get Min Value

Gets the minimum numeric value allowed by a control such as a java trackbar, a java scrollbar or a java numeric up/down control.

This action takes no parameters

The internal ID for this action is 'JABGetMinNumericValue'

Works with the following element types:

Get Value

Gets the datetime value of a VB6 date picker control.

This action takes no parameters

The internal ID for this action is 'GetDTPickerDateTime'

Works with the following element types:

Get Value

Gets the datetime value of a control such as a date picker.

This action takes no parameters

The internal ID for this action is 'GetDateTimeValue'

Works with the following element types:

Set Value

Sets the datetime value of a control such as a date picker.

Parameters
Name Data Type Description
Value datetime The new value to be set in the control.

The internal ID for this action is 'SetDateTimeValue'

Works with the following element types:

Get Max Value

Gets the maximum allowable datetime value of a control such as a date picker.

This action takes no parameters

The internal ID for this action is 'GetMaxDateTimeValue'

Works with the following element types:

Get Min Value

Sets the minimum allowable datetime value of a control such as a date picker.

This action takes no parameters

The internal ID for this action is 'GetMinDateTimeValue'

Works with the following element types:

Get Max Selected Value

Gets the maximum selected datetime value of a control such as a date picker.

This action takes no parameters

The internal ID for this action is 'GetMaxSelectedDateTimeValue'

Works with the following element types:

Get Min Selected Value

Gets the minimum selected datetime value of a control such as a date picker.

This action takes no parameters

The internal ID for this action is 'GetMinSelectedDateTimeValue'

Works with the following element types:

Scroll To Minimum

Sets a scrollbar to its minimum value - ie either the extreme left, or to the top depending on its orientation.

This action takes no parameters

The internal ID for this action is 'ScrollToMinimum'

Works with the following element types:

Scroll To Maximum

Sets a scrollbar to its maximum value - ie either the extreme right, or to the bottom depending on its orientation.

This action takes no parameters

The internal ID for this action is 'ScrollToMaximum'

Works with the following element types:

Scroll By Amount

Adjusts the value of a scroll bar by the specified amount in pages, where one page is the size represented by the "thumb" on the scroll bar. Both positive and negative values are permitted, as well as fractional values.

Parameters
Name Data Type Description
Number of Pages number The number of pages to scroll. Fractional values such as '0.5' are valid as well as whole values such as '3'. A negative value indicates scrolling up/left; a positive value indicates scrolling down/right.

The internal ID for this action is 'ScrollByAmount'

Works with the following element types:

Scroll To Minimum

Sets a java scrollbar to its minimum value - ie either the extreme left, or to the top depending on its orientation.

This action takes no parameters

The internal ID for this action is 'JABScrollToMinimum'

Works with the following element types:

Scroll To Maximum

Sets a java scrollbar to its maximum value - ie either the extreme right, or to the bottom depending on its orientation.

This action takes no parameters

The internal ID for this action is 'JABScrollToMaximum'

Works with the following element types:

Scroll By Amount

Adjusts the value of a java scroll bar by the specified amount in pages, where one page is the size represented by the "thumb" on the scroll bar. Both positive and negative values are permitted, as well as fractional values.

Parameters
Name Data Type Description
Number of Pages number The number of pages to scroll. Fractional values such as '0.5' are valid as well as whole values such as '3'. A negative value indicates scrolling up/left; a positive value indicates scrolling down/right.

The internal ID for this action is 'JABScrollByAmount'

Works with the following element types:

Multi Select Item

Adds the item to a multiple selection in a Windows ListBox that matches the given text.

Parameters
Name Data Type Description
Item Text text The text of the item to be selected. If not unique, then the first matching item will be selected.

The internal ID for this action is 'MultiSelectItem'

Works with the following element types:

Select Item

Selects the item in a Windows ComboBox, ListBox, Listview or Treeview that matches the given text.

Parameters
Name Data Type Description
Item Text text The text of the item to be selected. If not unique, then the first matching item found will be selected.
Item Position number The 1-based index of the item to be modified. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'SelectItem'

Works with the following element types:

Click Item

Clicks the item in a Windows Listview that matches the given text.

Parameters
Name Data Type Description
Item Text text The text of the item to be clicked. If not unique, then the first matching item found will be selected.
Item Position number The 1-based index of the item to be clicked. This parameter is ignored unless the 'Item Text' parameter is blank.
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'ClickItem'

Works with the following element types:

Get Item Bounds

Gets the bounds of an item within a Listview, relative to the listview's top left corner.

Parameters
Name Data Type Description
Item Text text The text of the item of interest. If not unique, then the first matching item found will be used.
Item Position number The 1-based index of the item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'GetItemBoundsAsCollection'

Works with the following element types:

Get Item Screen Bounds

Gets the bounds of an item within a Listview, in screen coordinates.

Parameters
Name Data Type Description
Item Text text The text of the item of interest. If not unique, then the first matching item found will be used.
Item Position number The 1-based index of the item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'GetItemScreenBoundsAsCollection'

Works with the following element types:

Select Tree Node

Selects a node in a TreeView.

Parameters
Name Data Type Description
Node Text text The text of the node to be selected. If not unique, then the first matching item found will be selected.

The internal ID for this action is 'SelectTreeNode'

Works with the following element types:

Click Item

Clicks the item in a Windows Toolbar (or similar) that matches the given text.

Parameters
Name Data Type Description
Item Position number The 1-based index of the item to be clicked. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'ClickToolbarButton'

Works with the following element types:

Is Button Enabled

Reads the 'enabled' value of a toolbar button.

Parameters
Name Data Type Description
Item Position number The 1-based index of the item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'IsToolbarButtonEnabled'

Works with the following element types:

Is Button Checked

Reads the 'checked' value of a toolbar button.

Parameters
Name Data Type Description
Item Position number The 1-based index of the item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'IsToolbarButtonChecked'

Works with the following element types:

Is Button Pressed

Reads the 'pressed' value of a toolbar button.

Parameters
Name Data Type Description
Item Position number The 1-based index of the item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'IsToolbarButtonPressed'

Works with the following element types:

Select Menu Item

Selects the specified menu item from the main menu.

Parameters
Name Data Type Description
Menu Path text The path to the menu item of interest, as a descent through the menu tree-structure. Eg "{File}{Backup Options}{Backup Configuration}". The escape character for the special "{","}" characters is the backslash: "\".

The internal ID for this action is 'SelectMenuItem'

Works with the following element types:

Is Menu Item Checked

Reads the 'checked' value of a menu item.

Parameters
Name Data Type Description
Menu Path text The path to the menu item of interest, as a descent through the menu tree-structure. Eg "{File}{Backup Options}{Backup Configuration}". The escape character for the special "{","}" characters is the backslash: "\".

The internal ID for this action is 'IsMenuItemChecked'

Works with the following element types:

Is Menu Item Enabled

Reads the 'enabled' value of a menu item.

Parameters
Name Data Type Description
Menu Path text The path to the menu item of interest, as a descent through the menu tree-structure. Eg "{File}{Backup Options}{Backup Configuration}". The escape character for the special "{","}" characters is the backslash: "\".

The internal ID for this action is 'IsMenuItemEnabled'

Works with the following element types:

Click Tab

Sends a click message to a tab control, located at the centre of the specified tab.

Parameters
Name Data Type Description
Tab Text text The text of the tab to receive the click messages. If not unique, then the first matching tab found will be used.
Item Position number The 1-based index of the tab to be used. This parameter is ignored unless the 'Tab Text' parameter is blank.

The internal ID for this action is 'ClickTab'

Works with the following element types:

Global Mouse Click Tab

Clicks a tab control, at the centre of the specified tab, using a global mouse click.

Parameters
Name Data Type Description
Tab Text text The text of the tab to be clicked. If not unique, then the first matching tab found will be used.
Item Position number The 1-based index of the tab to be clicked. This parameter is ignored unless the 'Tab Text' parameter is blank.

The internal ID for this action is 'MouseClickTab'

Works with the following element types:

'''Global action''' - the target application must have focus.

Set Item Checked

Sets the 'checked' value of the item in a Windows Listview or Treeview that matches the given text.

Parameters
Name Data Type Description
Item Text text The text of the item to be modified. If not unique, then the first matching item found will be used.
Item Position number The 1-based index of the item to be modified. This parameter is ignored unless the 'Item Text' parameter is blank.
Value flag A flag value indicating whether the item specified should be checked or unchecked.

The internal ID for this action is 'SetItemChecked'

Works with the following element types:

'''Global action''' - the target application must have focus.

Select Item

Selects a child item identified by its text, or by its index - eg from a menu dropdown, or a combo box, etc

Parameters
Name Data Type Description
Item Text text The text of the item to be selected. If not unique, then the first matching item found will be selected.
Item Position number The 1-based index of the item to be selected. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'AASelectItem'

Works with the following element types:

Count Items

Counts and returns the number of items contained in an active accessibility element such as a listview, Treeview or ComboBox.

This action takes no parameters

The internal ID for this action is 'AAGetItemCount'

Works with the following element types:

Get All Items

Gets all rows and columns (of a listview, combobox, datagrid, listbox etc) as a collection. For simple controls, the collection has a single field called 'Item Text'. For multi-column controls, the fields will be named as they are in the control, where possible - otherwise names such as 'Column1', 'Column2' will be used.

This action takes no parameters

The internal ID for this action is 'AAGetAllItems'

Works with the following element types:

Get Selected Items

Gets all selected rows and columns (of a listview, combobox, datagrid, listbox etc) as a collection.

This action takes no parameters

The internal ID for this action is 'AAGetSelectedItems'

Works with the following element types:

Get Selected Item Text

Gets the text of the principal selection (of a listview, combobox, datagrid, listbox etc).

This action takes no parameters

The internal ID for this action is 'AAGetSelectedItemText'

Works with the following element types:

Get Current Value

Reads the current value from an active accessibility element

This action takes no parameters

The internal ID for this action is 'AAGetValue'

Works with the following element types:

Get Checked

Reads the 'checked' value from an active accessibility checkbox, radio button, etc

This action takes no parameters

The internal ID for this action is 'AAGetChecked'

Works with the following element types:

Show Dropdown

Show the dropdown list on a combobox or menu, etc

This action takes no parameters

The internal ID for this action is 'AAShowDropdown'

Works with the following element types:

Hide Dropdown

Hide the dropdown list on a combobox or menu, etc

This action takes no parameters

The internal ID for this action is 'AAHideDropdown'

Works with the following element types:

Clear Selection

Clears the selection (of child items where appropriate) - eg in a edit field, listview, listbox, etc

This action takes no parameters

The internal ID for this action is 'ClearSelection'

Works with the following element types:

Set Checked

Sets the checked status of a radio button or checkbox

Parameters
Name Data Type Description
Checked flag The new value to be applied.

The internal ID for this action is 'SetChecked'

Works with the following element types:

Launch Mainframe

Launch the mainframe. The parameters supplied in the Application Modeller wizard may be optionally overridden in this call. To use the value supplied in the wizard, leave the corresponding parameter blank. To supply an empty string to a parameter, use an expression which represents an empty string (eg "", or use a data item with an empty value).

This action takes no parameters

The internal ID for this action is 'LaunchMainframe'

Works with the following element types:

Attach Mainframe

Attach to the target mainframe.

Parameters
Name Data Type Description
Session Identifier text Often called the session short name this is a single letter in the range A..Z.

The internal ID for this action is 'AttachMainframe'

Works with the following element types:

Detach Mainframe

Detach from the mainframe.

This action takes no parameters

The internal ID for this action is 'DetachMainframe'

Works with the following element types:

Terminate Mainframe

Terminate the mainframe.

This action takes no parameters

The internal ID for this action is 'TerminateMainframe'

Works with the following element types:

Send Keys Mainframe

Send keys to the mainframe. See the 'Mainframe Integration' help page for more details.

Parameters
Name Data Type Description
Text text The key-codes to be sent to the target application.

The internal ID for this action is 'MainframeSendKeys'

Works with the following element types:

Launch

Launch the target application. The parameters supplied in the Application Modeller wizard may be optionally overridden in this call. To use the value supplied in the wizard, leave the corresponding parameter blank. To supply an empty string to a parameter, use an expression which represents an empty string (eg "", or use a data item with an empty value).

This action takes no parameters

The internal ID for this action is 'Launch'

Works with the following element types:

Attach

Attaches to an existing instance of the target application. The parameters supplied in the Application Modeller wizard may be optionally overridden in this call. To use the value supplied in the wizard, leave the corresponding parameter blank. To supply an empty string to a parameter, use an expression which represents an empty string (eg "", or use a data item with an empty value).

Parameters
Name Data Type Description
Window Titles (as Collection) collection Optional Parameter. A collection of different patterns designed to match any one of a number of window titles. Window title matching patterns should be contained in a field called "Window Title". A successful match amongst any of the patterns will cause the matching application to be attached. The wildcard characters "*", "?", "#" are valid, and may be escaped with a backslash character ("\").
Window Title text Optional parameter. A pattern specifying a single window title to be matched. The wildcard characters "*", "?", "#" are valid, and may be escaped with a backslash character ("\").
Process Name text Optional parameter. A pattern specifying the process name of the application. The wildcard characters "*", "?", "#" are valid, and may be escaped with a backslash character ("\").
Process ID number Optional parameter. The process identifier (pid) of the process.
User Name text Optional parameter. The username of the user who the process is running as.
Child Index number Optional parameter. The child process index

The internal ID for this action is 'AttachApplication'

Works with the following element types:

Detach

Detaches from the currently connected application.

This action takes no parameters

The internal ID for this action is 'DetachApplication'

Works with the following element types:

Terminate

Terminate the target application. For emergency use only

This action takes no parameters

The internal ID for this action is 'Terminate'

Works with the following element types:

Is Connected

Detects whether the business object is currently connected to the application (be it through launching or attaching).

This action takes no parameters

The internal ID for this action is 'IsConnected'

Works with the following element types:

Global Send Keys

Send keys to the active application

Parameters
Name Data Type Description
Text text The key-codes to be sent to the target application. Full details at [http://msdn2.microsoft.com/en-us/library/system.windows.forms.sendkeys.send.aspx MSDN Sendkeys.Send()].
Interval number The number of seconds to wait between each keypress. Note that if this is set to a non-zero value, 'Text' must not contain any control characters or an error will occur

The internal ID for this action is 'SendKeys'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Send Key Events

Send keys to the application using events. These events take place at the lowest level, and are received by whichever application is currently focused. The SendKeys method is preferred unless there is a special reason for using this method.

Parameters
Name Data Type Description
Text text The key events to be sent to the target application. Special characters should be enclosed in curly braces (eg {SPACE}, {ESC}, {PGUP}, {PGDN}, {LEFT}, {RIGHT}, {UP}, {DOWN}). The modifiers "<" and ">" change the following letter into a key-down or key-up operation (respectively), instead of a full key-press (ie key-down followed by key-up operation). For example "hello" sends those keystrokes; "<{CTRL}s>{CTRL}" simulates depressing the control key, pressing "s" and releasing the control key again. Special characters (such as "<", ">", "{", "}") should be enclosed in curly braces if meant literally. Any key name listed at [https://msdn.microsoft.com/en-us/library/system.windows.forms.keys.aspx MSDN Keys Enumeration] can also be used.
Interval number The number of seconds to wait between each keypress. Default is 0.1, ie. 100ms

The internal ID for this action is 'SendKeyEvents'

Works with the following element types:

'''Global action''' - the target application must have focus.

Activate Application

Activate the application, i.e. brings to the foreground. Target element should be the app's main window.

This action takes no parameters

The internal ID for this action is 'ActivateApp'

Works with the following element types:

Window Press Keys

Send keypresses to the given window. Note that care must sometimes be taken to direct the keypresses to the correct window. For example, in Notepad, sending to the main window will have no effect, but sending to the 'Edit' window contained within it will work.

Parameters
Name Data Type Description
Text text The text to be sent. Each letter represents a different keystroke, which will be sent one by one.
Interval number The number of seconds to wait between each keystroke.

The internal ID for this action is 'TypeText'

Works with the following element types:

Window Press Keys with Alt

Send keypresses to the given window with the alt key down

Parameters
Name Data Type Description
Text text The text to be sent. Each letter represents a different keystroke, which will be sent one by one.
Interval number The number of seconds to wait between each keystroke.

The internal ID for this action is 'TypeTextAlt'

Works with the following element types:

'''Global action''' - the target application must have focus.

Default

Perform the default action for the application element

This action takes no parameters

The internal ID for this action is 'Default'

Works with the following element types:

Move

Move a window to the specified location.

Parameters
Name Data Type Description
X number The X coordinate of the new window location, relative to the top-left corner of the screen.
Y number The Y coordinate of the new window location, relative to the top-left corner of the screen.

The internal ID for this action is 'MoveWindow'

Works with the following element types:

Resize

Resize a window.

Parameters
Name Data Type Description
Width number The new width of the window, in pixels.
Height number The new width of the window, in pixels.

The internal ID for this action is 'ResizeWindow'

Works with the following element types:

Maximise

Maximises the window to fill the screen.

This action takes no parameters

The internal ID for this action is 'MaximiseWindow'

Works with the following element types:

Minimise

Minimises the window to the task tray.

This action takes no parameters

The internal ID for this action is 'MinimiseWindow'

Works with the following element types:

Restore

Restores the window from its minimised or maximised state.

This action takes no parameters

The internal ID for this action is 'RestoreWindow'

Works with the following element types:

Hide All Windows

Hides all top-level windows belonging to an application. Use 'Hide Window' to hide an individual window

This action takes no parameters

The internal ID for this action is 'HideAllWindows'

Works with the following element types:

Hide Window

Hides a top-level window by moving it offscreen, and removing from the taskbar.

This action takes no parameters

The internal ID for this action is 'HideWindow'

Works with the following element types:

Unhide Window

Unhides a top-level window which has previously been hidden.

This action takes no parameters

The internal ID for this action is 'UnhideWindow'

Works with the following element types:

Is Window Hidden

Determines whether a window has previously been hidden using a call to 'Hide Window'.

This action takes no parameters

The internal ID for this action is 'IsWindowHidden'

Works with the following element types:

Do

Performs an action

Parameters
Name Data Type Description
Action textNo Description Found. Please fix this problem

The internal ID for this action is 'DoJava'

Works with the following element types:

Focus

Brings a java element into focus, ready to receive keyboard input

This action takes no parameters

The internal ID for this action is 'JABFocus'

Works with the following element types:

Select Tab

Selects a java tab from a java tab control

This action takes no parameters

The internal ID for this action is 'JABSelectTab'

Works with the following element types:

Count Items

Gets the number of items contained in a java component, eg the number of rows in a table, eg the number of items in a combo box

This action takes no parameters

The internal ID for this action is 'JABGetItemCount'

Works with the following element types:

Get All Items

Gets all items from a java table, combo box, etc. For simple controls, the collection has a single field called 'Item Text'. For multi-column controls, the fields will be named as they are in the control, where possible - otherwise names such as 'Column1', 'Column2' will be used.

This action takes no parameters

The internal ID for this action is 'JABGetAllItems'

Works with the following element types:

Get Selected Items

Gets all selected items from a java table, combo box, etc

This action takes no parameters

The internal ID for this action is 'JABGetSelectedItems'

Works with the following element types:

Global Mouse Click Centre

Click at the centre of the Active Accessibility element.

Parameters
Name Data Type Description
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'AAClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click

Click the element at the specified position, using a global mouse click. The position is relative to the top left of the element's bounding rectangle. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'AAMouseClick'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Name

Gets the name of the Accessibility element. Some applications expose current value information in the Name Attribute

This action takes no parameters

The internal ID for this action is 'AAGetName'

Works with the following element types:

Get Description

Gets the description of the Accessibility element. Some applications expose current value information in the Description Attribute

This action takes no parameters

The internal ID for this action is 'AAGetDescription'

Works with the following element types:

Get Table

Get the Active Accessibility table specified

This action takes no parameters

The internal ID for this action is 'AAGetTable'

Works with the following element types:

Focus

Focus the Active Accessibility element.

This action takes no parameters

The internal ID for this action is 'AAFocus'

Works with the following element types:

Global Send Keys

Send keys to the active application

Parameters
Name Data Type Description
Text text The key-codes to be sent to the target application. Full details at [http://msdn2.microsoft.com/en-us/library/system.windows.forms.sendkeys.send.aspx MSDN Sendkeys.Send()].
Interval number The number of seconds to wait before each keypress. Note that if this is set to a non-zero value, 'Text' must not contain any control characters or an error will occur

The internal ID for this action is 'AASendKeys'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Document URL

Retrieves the URL of the currently loaded document

This action takes no parameters

The internal ID for this action is 'HTMLGetDocumentURL'

Works with the following element types:

Get Document URL Domain

Retrieves the URL domain of the currently loaded document

This action takes no parameters

The internal ID for this action is 'HTMLGetDocumentURLDomain'

Works with the following element types:

Navigate

Navigate to a URL

Parameters
Name Data Type Description
URL text The URL to navigate to.

The internal ID for this action is 'HTMLNavigate'

Works with the following element types:

Click Centre

Click the centre of an HTML element.

This action takes no parameters

The internal ID for this action is 'HTMLClickCentre'

Works with the following element types:

Double Click Centre

Double click the centre of an HTML element.

This action takes no parameters

The internal ID for this action is 'HTMLDoubleClickCentre'

Works with the following element types:

Get All Items

Get all child items of an HTML element, as a collection. For simple controls, the collection has a single field called 'Item Text'. For multi-column controls, the fields will be named as they are in the control, where possible - otherwise names such as 'Column1', 'Column2' will be used.

This action takes no parameters

The internal ID for this action is 'HTMLGetAllItems'

Works with the following element types:

Get Table

Gets all elements of a HTML table, as a collection.

This action takes no parameters

The internal ID for this action is 'HTMLGetTable'

Works with the following element types:

Get Selected Items

Get all child items of an HTML element which are selected, as a collection.

This action takes no parameters

The internal ID for this action is 'HTMLGetSelectedItems'

Works with the following element types:

Get Selected Item Text

Gets the text of the first selected item. Returns an error if no items are selected.

This action takes no parameters

The internal ID for this action is 'HTMLGetSelectedItemText'

Works with the following element types:

Select Item

Selects the item in a ComboBox that matches the given parameters.

Parameters
Name Data Type Description
Item Text text The text of the item to be selected. If not unique, then the first matching item found will be selected.
Item Position number The 1-based index of the item to be modified. This parameter is ignored unless the 'Item Text' parameter is blank.
Item Value text The value of the item to selected. This parameter is ignored unless the 'Item Text' and 'Item Position' parameter is blank.

The internal ID for this action is 'HTMLSelectItem'

Works with the following element types:

Count Items

Get the number of child items of an HTML element.

This action takes no parameters

The internal ID for this action is 'HTMLCountItems'

Works with the following element types:

Count Selected Items

Get the number of child items of an HTML element, which are selected.

This action takes no parameters

The internal ID for this action is 'HTMLCountSelectedItems'

Works with the following element types:

Invoke Javascript Function

Calls the specified javascript function. This can be a standard javascript function, or one which is defined in the target HTML page.

Parameters
Name Data Type Description
Function Name text The name of the function to be called.
Arguments text The arguments to pass to the function, as an array of objects in JSON format

The internal ID for this action is 'HTMLInvokeJavascriptMethod'

Works with the following element types:

Insert Javascript Fragment

Inserts the supplied javascript fragment into the target document. This can be a mixture of methods and variables. The methods can later be invoked using the corresponding method.

Parameters
Name Data Type Description
Fragment text The javascript fragment to be inserted. Eg var Success; function doSomething() { alert('hello'); Success = true; }

The internal ID for this action is 'HTMLInsertJavascriptFragment'

Works with the following element types:

Update Cookie

Updates the given cookie on the target document. Cookies need to be specified in the format "name=value". By default the cookie will expire when the browser is closed, but to have the cookie persist set an expiry date using "name=value; expires=date". To delete a cookie use "name=; expires=date", where name is the name of the cookie and date is in the past. Dates should be in UTC format e.g. Thu, 18 Dec 2013 12:00:00 UTC

Parameters
Name Data Type Description
Cookie text The cookie data to be set

The internal ID for this action is 'HTMLUpdateCookie'

Works with the following element types:

HTML Snapshot

Take a snapshot of all HTML document elements.

This action takes no parameters

The internal ID for this action is 'HTMLSnapshot'

Works with the following element types:

Source Capture

Capture the source of the HTML document.

This action takes no parameters

The internal ID for this action is 'HTMLSourceCap'

Works with the following element types:

Get HTML

Gets the HTML of an element.

This action takes no parameters

The internal ID for this action is 'HTMLGetOuterHTML'

Works with the following element types:

Get Path

Gets Path of the HTML element.

This action takes no parameters

The internal ID for this action is 'HTMLGetPath'

Works with the following element types:

Snapshot

Take a snapshot of all elements.

This action takes no parameters

The internal ID for this action is 'WindowsSnapshot'

Works with the following element types:

Snapshot

Take a snapshot of all elements.

This action takes no parameters

The internal ID for this action is 'JABSnapshot'

Works with the following element types:

Click Link

Clicks a .Net Link Label

This action takes no parameters

The internal ID for this action is 'ClickLink'

Works with the following element types:

Read Text (DDE)

Reads the value of a DDE field

This action takes no parameters

The internal ID for this action is 'DDEGetText'

Works with the following element types:

Execute Command (DDE)

Executes the command represented by the current DDE element.

Parameters
Name Data Type Description
Value text The value (if any) to supply to the DDE command.
No Check flag If true, then no check will be made as to the success of the operation. This provides a workaround for a badly behaved application which performs the requested command, but fails to feed back a success status. Defaults to False.

The internal ID for this action is 'ExecuteDDECommand'

Works with the following element types:

Verify

Verifies that an element exists, and optionally highlights the element

Parameters
Name Data Type Description
Highlight flag Specifies that the element should be highlighted

The internal ID for this action is 'Verify'

Works with the following element types:

Verify

Verifies that an element exists, and optionally highlights the element

Parameters
Name Data Type Description
Highlight flag Specifies that the element should be highlighted

The internal ID for this action is 'RegionVerify'

Works with the following element types:

'''Global action''' - the target application must have focus.

Verify

Verifies that an element exists, and optionally highlights the element

Parameters
Name Data Type Description
Element Number number The 1-based number indicating which element of the list region to act on. Default is 1
Highlight flag Specifies that the element should be highlighted

The internal ID for this action is 'ListRegionVerify'

Works with the following element types:

'''Global action''' - the target application must have focus.

Verify

Verifies that an element exists, and optionally highlights the element

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column of the grid region to act on. Default is 1
Row Number number The 1-based row number indicating which row of the grid region to act on. Default is 1
Highlight flag Specifies that the element should be highlighted

The internal ID for this action is 'GridRegionVerify'

Works with the following element types:

'''Global action''' - the target application must have focus.

Click

Clicks on the given element

This action takes no parameters

The internal ID for this action is 'WebClick'

Works with the following element types:

Double Click

Double click the given element

This action takes no parameters

The internal ID for this action is 'WebDoubleClick'

Works with the following element types:

Select

Selects the current element and any descendant elements

This action takes no parameters

The internal ID for this action is 'WebSelect'

Works with the following element types:

Focus

Sets the keyboard focus to the given element

This action takes no parameters

The internal ID for this action is 'WebFocus'

Works with the following element types:

Set Attribute

Sets the given attribute on the element

Parameters
Name Data Type Description
Attribute Name text The name of the attribute to set
Value text The value to set the attribute to

The internal ID for this action is 'WebSetAttribute'

Works with the following element types:

Set Checked

Sets the checked state of the element

Parameters
Name Data Type Description
Checked flag Whether the control should be checked

The internal ID for this action is 'WebSetCheckState'

Works with the following element types:

Global Send Keys

Send keys to the active application

Parameters
Name Data Type Description
Text text The key-codes to be sent to the target application. Full details at [http://msdn2.microsoft.com/en-us/library/system.windows.forms.sendkeys.send.aspx MSDN Sendkeys.Send()].
Interval number The number of seconds to wait before each keypress. Note that if this is set to a non-zero value, 'Text' must not contain any control characters or an error will occur

The internal ID for this action is 'WebSendKeys'

Works with the following element types:

'''Global action''' - the target application must have focus.

Scroll To

Scroll the parent to the element

This action takes no parameters

The internal ID for this action is 'WebScrollTo'

Works with the following element types:

Set Address

Navigates to the given address

Parameters
Name Data Type Description
Address text The Web address to navigate to

The internal ID for this action is 'WebNavigate'

Works with the following element types:

Invoke Javascript Function

Calls the specified javascript function. This can be a standard javascript function, or one which is defined in the target HTML page.

Parameters
Name Data Type Description
Function Name text The name of the function to be called.
Arguments text The arguments to pass to the function, as an array of objects in JSON format

The internal ID for this action is 'WebInvokeJavascript'

Works with the following element types:

Insert Javascript Fragment

Inserts the supplied javascript fragment into the target document. This can be a mixture of methods and variables. The methods can later be invoked using the corresponding method.

Parameters
Name Data Type Description
Fragment text The javascript fragment to be inserted. Eg var Success; function doSomething() { alert('hello'); Success = true; }

The internal ID for this action is 'WebInjectJavascript'

Works with the following element types:

Update Cookie

Updates the given cookie on the target document. Cookies need to be specified in the format "name=value". By default the cookie will expire when the browser is closed, but to have the cookie persist set an expiry date using "name=value; expires=date". To delete a cookie use "name=; expires=date", where name is the name of the cookie and date is in the past. Dates should be in UTC format e.g. Thu, 18 Dec 2013 12:00:00 UTC

Parameters
Name Data Type Description
Cookie text The cookie data to be set

The internal ID for this action is 'WebUpdateCookie'

Works with the following element types:

Submit

Submits the form

This action takes no parameters

The internal ID for this action is 'WebSubmit'

Works with the following element types:

Select List Item

Selects an item in the list by name or index

Parameters
Name Data Type Description
Item Index number The index of the item to select
Item Text text The text of the item to select

The internal ID for this action is 'WebSelectListItem'

Works with the following element types:

Add To Selection

Adds an item to the list's selected items by name or index

Parameters
Name Data Type Description
Item Index number The index of the item
Item Text text The text of the item

The internal ID for this action is 'WebAddToListSelection'

Works with the following element types:

Remove From Selection

Removes an item from the list's selected items by name or index

Parameters
Name Data Type Description
Item Index number The index of the item
Item Text text The text of the item

The internal ID for this action is 'WebRemoveFromListSelection'

Works with the following element types:

Click Menu Item

Clicks the menu item identified by name or index

Parameters
Name Data Type Description
Item Index number The index of the item to click
Item Text text The text of the item to click

The internal ID for this action is 'WebClickMenuItem'

Works with the following element types:

Toggle Expand/Collapse

Toggles whether the element is expanded or collapsed

This action takes no parameters

The internal ID for this action is 'WebToggleExpandCollapse'

Works with the following element types:

Expand

Expands the element

This action takes no parameters

The internal ID for this action is 'WebExpand'

Works with the following element types:

Collapse

Collapses the element

This action takes no parameters

The internal ID for this action is 'WebCollapse'

Works with the following element types:

Check Radio

Sets the radio button to be the one in its group that's checked

This action takes no parameters

The internal ID for this action is 'WebCheckRadio'

Works with the following element types:

Select Text Range

Selects a range of text within the element

Parameters
Name Data Type Description
Start Index number The character to start the selection at
Length number The number of characters to select

The internal ID for this action is 'WebSelectTextRange'

Works with the following element types:

Get Attribute

Gets the given attribute of the element

Parameters
Name Data Type Description
Attribute Name text The name of the attribute to get.

The internal ID for this action is 'WebGetAttribute'

Works with the following element types:

Get Bounds

Gets the bounds of the element relative to the page

This action takes no parameters

The internal ID for this action is 'WebGetBounds'

Works with the following element types:

Get Check State

Gets the checked state of the element

This action takes no parameters

The internal ID for this action is 'WebGetCheckState'

Works with the following element types:

Get Column Count

Gets the number of columns in the table

This action takes no parameters

The internal ID for this action is 'WebGetColumnCount'

Works with the following element types:

Get Form Values

Gets the values from each input element in a form

This action takes no parameters

The internal ID for this action is 'WebGetFormValues'

Works with the following element types:

Get ID

Gets the ID of the element

This action takes no parameters

The internal ID for this action is 'WebGetId'

Works with the following element types:

Get Is On Screen

Gets a value indicating whether the element is visible on screen

This action takes no parameters

The internal ID for this action is 'WebGetIsOnScreen'

Works with the following element types:

Get Is Selected

Gets a value indicating whether the list item is selected

This action takes no parameters

The internal ID for this action is 'WebGetIsSelected'

Works with the following element types:

Get Is Visible

Gets a value indicating whether the element is visible

This action takes no parameters

The internal ID for this action is 'WebGetIsVisible'

Works with the following element types:

Get Items

Gets all items from a list

This action takes no parameters

The internal ID for this action is 'WebGetItems'

Works with the following element types:

Get Label

Gets the label associated with an element

This action takes no parameters

The internal ID for this action is 'WebGetLabel'

Works with the following element types:

Get Link Address

Gets the web address that a link points to

This action takes no parameters

The internal ID for this action is 'WebGetLinkAddress'

Works with the following element types:

Get Max Value

Gets the maximum value of a numeric element

This action takes no parameters

The internal ID for this action is 'WebGetMaxValue'

Works with the following element types:

Get Min Value

Gets the minimum value of a numeric element

This action takes no parameters

The internal ID for this action is 'WebGetMinValue'

Works with the following element types:

Get Page URL

Gets the URL of the web page that contains this element

This action takes no parameters

The internal ID for this action is 'WebGetPageUrl'

Works with the following element types:

Get Row Count

Gets the number of rows in the table

This action takes no parameters

The internal ID for this action is 'WebGetRowCount'

Works with the following element types:

Get Selected Items

Gets the items in a list which are selected

This action takes no parameters

The internal ID for this action is 'WebGetSelectedItems'

Works with the following element types:

Get Selected Items Text

Gets the items in a list which are selected

This action takes no parameters

The internal ID for this action is 'WebGetSelectedItemsText'

Works with the following element types:

Get Selected Text

Gets the text selected in an element

This action takes no parameters

The internal ID for this action is 'WebGetSelectedText'

Works with the following element types:

Get Table Item

Gets the item in a table at the given row and column

Parameters
Name Data Type Description
Column number Column index
Row number Row index

The internal ID for this action is 'WebGetTableItem'

Works with the following element types:

Get Table Items

Gets all items in a table

This action takes no parameters

The internal ID for this action is 'WebGetTableItems'

Works with the following element types:

Get Text

Gets the text contained in an element

This action takes no parameters

The internal ID for this action is 'WebGetText'

Works with the following element types:

Get Current Value

Reads the current value from a Web element

This action takes no parameters

The internal ID for this action is 'WebGetValue'

Works with the following element types:

Get Path

Gets Path of the Web element.

This action takes no parameters

The internal ID for this action is 'WebGetPath'

Works with the following element types:

Get Name

Gets the name of the UIA element. Some applications expose current value information in the Name Attribute

This action takes no parameters

The internal ID for this action is 'UIAGetName'

Works with the following element types:

Focus

Focus the UIA element.

This action takes no parameters

The internal ID for this action is 'UIAFocus'

Works with the following element types:

Press

Press the UI Automation button element (this will invoke, toggle or expand/collapse the button depending which action the button supports.

This action takes no parameters

The internal ID for this action is 'UIAButtonPress'

Works with the following element types:

Press

Press the UI Automation element

This action takes no parameters

The internal ID for this action is 'UIAPress'

Works with the following element types:

Select

Deselects any selected items and then selects the UI Automation element

This action takes no parameters

The internal ID for this action is 'UIASelect'

Works with the following element types:

Press Menu Item

Press the UI Automation menu item element, either by expanding a submenu or invoking the menu item itself

This action takes no parameters

The internal ID for this action is 'UIAMenuItemPress'

Works with the following element types:

Toggle

Change the toggle state of the UI Automation element

This action takes no parameters

The internal ID for this action is 'UIAToggle'

Works with the following element types:

Get Checked

Get the checked state of the UI Automation element

This action takes no parameters

The internal ID for this action is 'UIAGetToggleState'

Works with the following element types:

Get Pressed

Get the pressed state of the UI Automation element

This action takes no parameters

The internal ID for this action is 'UIAGetPressedState'

Works with the following element types:

Set Checked

Sets the checked state of the UI Automation element

Parameters
Name Data Type Description
Checked flag Whether the control should be checked

The internal ID for this action is 'UIASetToggleState'

Works with the following element types:

Get Current Value

Reads the current value from a UI Automation element

This action takes no parameters

The internal ID for this action is 'UIAGetValue'

Works with the following element types:

Set Current Value

Writes the current value to a UI Automation element

This action takes no parameters

The internal ID for this action is 'UIASetValue'

Works with the following element types:

Expand/Collapse

Expands or collapses the UI Automation element.

This action takes no parameters

The internal ID for this action is 'UIAExpandCollapse'

Works with the following element types:

Set Checked

Sets the checked status of a UIA radio button

Parameters
Name Data Type Description
Checked flag Whether the control should be checked

The internal ID for this action is 'UIARadioSetChecked'

Works with the following element types:

Get Selected Item Text

Gets the text of the selected item.

This action takes no parameters

The internal ID for this action is 'UIAGetSelectedItemText'

Works with the following element types:

Get Selected Text

Gets the text selected in the element

This action takes no parameters

The internal ID for this action is 'UIAGetSelectedText'

Works with the following element types:

Is Expanded

Reads the current state of whether the element is expanded or collapsed. If the element cannot be expanded, this will return False

This action takes no parameters

The internal ID for this action is 'UIAGetExpanded'

Works with the following element types:

Get Checked

Get the checked state of the UI Automation element

This action takes no parameters

The internal ID for this action is 'UIAGetRadioCheckedState'

Works with the following element types:

Get Selected Items

Gets the selected items in the list

This action takes no parameters

The internal ID for this action is 'UIAGetSelectedItems'

Works with the following element types:

Get Item Count

Gets the number of items in the list

This action takes no parameters

The internal ID for this action is 'UIAGetItemCount'

Works with the following element types:

Get All Items

Gets all items in the list

This action takes no parameters

The internal ID for this action is 'UIAGetAllItems'

Works with the following element types:

Select Item

Deselects any selected items and then selects the current element. If the Item Text parameter is supplied, this takes precedence over the Item Position parameter.

Parameters
Name Data Type Description
Item Position number The one-based index of the item to select
Item Text text The text of the item to select

The internal ID for this action is 'UIAListSelect'

Works with the following element types:

Select Item

Selects the specified item in a UIA combo box. If the Item Text parameter is supplied, this takes precedence over the Item Position parameter.

Parameters
Name Data Type Description
Item Position number The one-based index of the item to select
Item Text text The text of the item to select

The internal ID for this action is 'UIAComboSelect'

Works with the following element types:

Get Item Count

Gets the number of items in the list in a UIA combo box.

This action takes no parameters

The internal ID for this action is 'UIAComboGetItemCount'

Works with the following element types:

Get All Items

Gets all items in the list in a UIA combo box.

This action takes no parameters

The internal ID for this action is 'UIAComboGetAllItems'

Works with the following element types:

Scroll Vertically

Scrolls an element vertically

Parameters
Name Data Type Description
Big Step flag Whether the scroll should be a big step.
Scroll Up flag Whether the scroll should be in the upwards direction.

The internal ID for this action is 'UIAScrollVertical'

Works with the following element types:

Scroll Horizontally

Scrolls an element horizontally

Parameters
Name Data Type Description
Big Step flag Whether the scroll should be a big step.
Scroll Up flag Whether the scroll should be in the upwards direction.

The internal ID for this action is 'UIAScrollHorizontal'

Works with the following element types:

Add To Selection

Adds an item to its parent's selected items

This action takes no parameters

The internal ID for this action is 'UIAAddToSelection'

Works with the following element types:

Remove From Selection

Removes an item from its parent's selected items

This action takes no parameters

The internal ID for this action is 'UIARemoveFromSelection'

Works with the following element types:

Scroll Into View

Scrolls the element into view

This action takes no parameters

The internal ID for this action is 'UIAScrollIntoView'

Works with the following element types:

Add To Selection

Adds the specfied item to the list's selected items. If the Item Text parameter is supplied, this takes precedence over the Item Position parameter.

Parameters
Name Data Type Description
Item Position number The one-based index of the item to select
Item Text text The text of the item to select

The internal ID for this action is 'UIAListAddToSelection'

Works with the following element types:

Remove From Selection

Removes the given item from the list's selected items. If the Item Text parameter is supplied, this takes precedence over the Item Position parameter.

Parameters
Name Data Type Description
Item Position number The one-based index of the item to de-select
Item Text text The text of the item to de-select

The internal ID for this action is 'UIAListRemoveFromSelection'

Works with the following element types:

Is Item Selected

Whether the item is currently selected

This action takes no parameters

The internal ID for this action is 'UIAGetIsItemSelected'

Works with the following element types:

Get All Tabs Text

Returns a collection of the text of all the tabs contained within the tab control

This action takes no parameters

The internal ID for this action is 'UIAGetAllTabsText'

Works with the following element types:

Select Item

Selects the Tab Item

This action takes no parameters

The internal ID for this action is 'UIASelectTabItem'

Works with the following element types:

Select Tab

Selects the Tab within a UIA Tab Control. If the Tab Text parameter is supplied, this takes precedence over the Tab Position parameter.

Parameters
Name Data Type Description
Tab Position number The one-based index of the tab to select
Tab Text text The text value of the tab to select

The internal ID for this action is 'UIASelectTab'

Works with the following element types:

Select Item

Selects an item in a tree

Parameters
Name Data Type Description
Item Text text The text of the tree view item of interest.
Item Position number The 1-based index of the tree view item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'UIATreeSelect'

Works with the following element types:

Add To Selection

Adds the given item to the tree's selected items.

Parameters
Name Data Type Description
Item Text text The text of the tree view item of interest.
Item Position number The 1-based index of the tree view item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'UIATreeAddToSelection'

Works with the following element types:

Remove From Selection

Removes the given item from the tree's selected items.

Parameters
Name Data Type Description
Item Text text The text of the tree view item of interest.
Item Position number The 1-based index of the tree view item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'UIATreeRemoveFromSelection'

Works with the following element types:

Expand/Collapse

Expands or collapses the UI Automation element.

Parameters
Name Data Type Description
Item Text text The text of the tree view item of interest.
Item Position number The 1-based index of the tree view item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'UIATreeExpandCollapse'

Works with the following element types:

Is Item Expanded

Reads the current state of whether the element is expanded or collapsed. If the element cannot be expanded, this will return False

Parameters
Name Data Type Description
Item Text text The text of the tree view item of interest.
Item Position number The 1-based index of the tree view item of interest. This parameter is ignored unless the 'Item Text' parameter is blank.

The internal ID for this action is 'UIATreeIsExpanded'

Works with the following element types:

Read Cell Text

Reads the text from the cell

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableReadCellText'

Works with the following element types:

Write Cell Text

Sets the text into the specified cell

Parameters
Name Data Type Description
Cell Text text The new text for the cell. Default is blank.
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableSetCellText'

Works with the following element types:

Scroll Into View

Scrolls the table cell into view

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.

The internal ID for this action is 'UIATableScrollIntoView'

Works with the following element types:

Get Rows

Gets the data in the specified rows

Parameters
Name Data Type Description
First Row Number number The 1-based row number indicating the first row to include in the collection. Defaults to 1 if not specified.
Last Row Number number The 1-based row number indicating the last row to include in the collection. Defaults to the last row in the table if not specified.

The internal ID for this action is 'UIATableRows'

Works with the following element types:

Add Row To Selection

Adds a row to the current selection.

Parameters
Name Data Type Description
Row Number number The 1-based row number indicating which row to act on.

The internal ID for this action is 'UIATableAddRowToSelection'

Works with the following element types:

Remove Row From Selection

Removes a row from the current selection.

Parameters
Name Data Type Description
Row Number number The 1-based row number indicating which row to act on.

The internal ID for this action is 'UIATableRemoveRowFromSelection'

Works with the following element types:

Clear Selection

Clears the current selection.

This action takes no parameters

The internal ID for this action is 'UIATableClearSelection'

Works with the following element types:

Get Selected Rows

Gets the selected rows as a collection.

This action takes no parameters

The internal ID for this action is 'UIATableGetSelectedRows'

Works with the following element types:

Get Row Count

Get the number of rows in the table.

This action takes no parameters

The internal ID for this action is 'UIATableRowCount'

Works with the following element types:

Get Column Count

Get the number of columns in the table.

This action takes no parameters

The internal ID for this action is 'UIATableColumnCount'

Works with the following element types:

Get Selected Row Number

Gets the number of the first selected row in the table.

This action takes no parameters

The internal ID for this action is 'UIATableSelectedRowNumber'

Works with the following element types:

Get Selected Column Number

Gets number of the first selected column in the table.

This action takes no parameters

The internal ID for this action is 'UIATableSelectedColumnNumber'

Works with the following element types:

Toggle Cell

Changes the Toggle state of the table cell.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableToggleCell'

Works with the following element types:

Get Checked

Gets checked state of the table cell.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableReadToggleState'

Works with the following element types:

Expand/Collapse Cell

Expands or collapses the table cell.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableExpandCollapse'

Works with the following element types:

Get Expanded Cell

Reads the current state of whether the cell element is expanded or collapsed.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableExpanded'

Works with the following element types:

Select Combobox Item

Selects an item from a combobox within the table cell element. If the Item Text parameter is supplied, this takes precedence over the Item Position parameter.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.
Item Position number The one-based index of the item to select
Item Text text The text value of the item to select

The internal ID for this action is 'UIATableSelectComboboxItem'

Works with the following element types:

Count Combobox Items

The number of items within a combobox inside the UI Automation element cell.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableCountComboboxItems'

Works with the following element types:

Get All Combobox Items

Get all items from a combobox within the cell element as a collection.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableGetAllComboboxItems'

Works with the following element types:

Get Selected Combobox Item

Gets the value of the selected item from a combobox in a table cell.

Parameters
Name Data Type Description
Column Number number The 1-based column number indicating which column to act on.
Row Number number The 1-based row number indicating which row to act on.
Element Number number Component index within the cell, 0 indicates the cell itself.

The internal ID for this action is 'UIATableGetSelectedComboboxItem'

Works with the following element types:

Drag

Start dragging from a given position over the window

Parameters
Name Data Type Description
X number The X coordinate of the point at which to start dragging, relative to the window
Y number The Y coordinate of the point at which to start dragging, relative to the window

The internal ID for this action is 'UIADrag'

Works with the following element types:

'''Global action''' - the target application must have focus.

Drop

Drop at the given position over the window - must follow a drag

Parameters
Name Data Type Description
X number The X coordinate of the point at which to perform the drop, relative to the window
Y number The Y coordinate of the point at which to perform the drop, relative to the window

The internal ID for this action is 'UIADrop'

Works with the following element types:

'''Global action''' - the target application must have focus.

Get Relative Bounds

Gets information about the bounding rectangle of the element, in coordinates relative to the parent.

This action takes no parameters

The internal ID for this action is 'UIAGetRelativeElementBounds'

Works with the following element types:

Get Screen Bounds

Gets information about the bounding rectangle of the element, in screen coordinates.

This action takes no parameters

The internal ID for this action is 'UIAGetElementScreenBounds'

Works with the following element types:

Global Mouse Click

Click the element at the specified position, using a global mouse click. The position is relative to the top left of the element's bounding rectangle. The mouse cursor will appear to jump across the screen during this method.

Parameters
Name Data Type Description
X number The X coordinate of the point at which to click, relative to the window
Y number The Y coordinate of the point at which to click, relative to the window
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'UIAMouseClick'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Mouse Click Centre

Click at the centre of the UIA element.

Parameters
Name Data Type Description
Mouse Button text Optional: the mouse button to use. Valid values are 'left' and 'right'; a null value implies 'left'

The internal ID for this action is 'UIAClickCentre'

Works with the following element types:

'''Global action''' - the target application must have focus.

Global Send Keys

Send keys to the active application

Parameters
Name Data Type Description
Text text The key-codes to be sent to the target application. Full details at [http://msdn2.microsoft.com/en-us/library/system.windows.forms.sendkeys.send.aspx MSDN Sendkeys.Send()].
Interval number The number of seconds to wait before each keypress. Note that if this is set to a non-zero value, 'Text' must not contain any control characters or an error will occur

The internal ID for this action is 'UIASendKeys'

Works with the following element types:

'''Global action''' - the target application must have focus.

Expand/Collapse

Expands or collapses the UI Automation element.

This action takes no parameters

The internal ID for this action is 'UIAComboExpandCollapse'

Works with the following element types:

Select Date

Set the date range for a control

Parameters
Name Data Type Description
Start Date date The start date of the range
End Date date The end date of the range

The internal ID for this action is 'SelectDateRange'

Works with the following element types:

Get Date

Get the date range for a control

This action takes no parameters

The internal ID for this action is 'GetDateRange'

Works with the following element types:

Get Horizontal Minimum

Get the minimum horizontal value

This action takes no parameters

The internal ID for this action is 'GetHorizontalMin'

Works with the following element types:

Get Horizontal Maximum

Get the maximum horizontal value

This action takes no parameters

The internal ID for this action is 'GetHorizontalMax'

Works with the following element types:

Get Horizontal Value

Get the current horizontal value

This action takes no parameters

The internal ID for this action is 'GetHorizontalValue'

Works with the following element types:

Set Horizontal Value

Set the horizontal value

Parameters
Name Data Type Description
Value number The new value

The internal ID for this action is 'SetHorizontalValue'

Works with the following element types:

Get Vertical Minimum

Get the minimum vertical value

This action takes no parameters

The internal ID for this action is 'GetVerticalMin'

Works with the following element types:

Get Vertical Maximum

Get the maximum vertical value

This action takes no parameters

The internal ID for this action is 'GetVerticalMax'

Works with the following element types:

Get Vertical Value

Get the current vertical value

This action takes no parameters

The internal ID for this action is 'GetVerticalValue'

Works with the following element types:

Set Vertical Value

Set the vertical value

Parameters
Name Data Type Description
Value number The new value

The internal ID for this action is 'SetVerticalValue'

Works with the following element types:

Get Selected Node Key

Get the key of the selected node in a treeview

This action takes no parameters

The internal ID for this action is 'GetSelectedNodeKey'

Works with the following element types:

Get Node Text

Get the text of the node with the specified key

Parameters
Name Data Type Description
Key text The key of the node

The internal ID for this action is 'GetNodeText'

Works with the following element types:

Double Click Node

Simulate double clicking the tree node

Parameters
Name Data Type Description
Text text The text of the node

The internal ID for this action is 'DoubleClickNode'

Works with the following element types:

Select

Selects an item

This action takes no parameters

The internal ID for this action is 'Select'

Works with the following element types:

Select Item

Selects an item identified by its position.

Parameters
Name Data Type Description
Item Position number The 1-based index of the item to be selected. This parameter is ignored unless the 'Item Text'

The internal ID for this action is 'SelectItemByIndex'

Works with the following element types:

Get Cell Value

Returns the text value of the currently selected cell in a Grid.

Parameters
Name Data Type Description
Cell row number The row number of the current cell
Cell column number The column number of the current cell

The internal ID for this action is 'GetCellValue'

Works with the following element types:

Set Focus

Places the focus for events on to a specific control.

This action takes no parameters

The internal ID for this action is 'SetFocus'

Works with the following element types:

Conditions

Get Text

Compares against drawn text retrieved from a rectangular region

Works with the following element types:

Get Text

Compares against drawn text retrieved from a list element in a rectangular region

Works with the following element types:

Get Text

Compares against drawn text retrieved from a grid cell in a rectangular region

Works with the following element types:

Matches Image

Compares against an image retrieved from a rectangular region

Works with the following element types:

Matches Image

Compares against an image retrieved from a list element in a rectangular region

Works with the following element types:

Matches Image

Compares against an image retrieved from a grid element in a rectangular region

Works with the following element types:

Contains Image

Determines if the region contains a particular image.

Works with the following element types:

Contains Image

Determines if the specified element in the list region contains a particular image.

Works with the following element types:

Contains Image

Determines if the specified element in the grid region contains a particular image.

Works with the following element types:

Contains Colour

Determines if the region contains a particular colour.

Works with the following element types:

Contains Colour

Determines if the specified element in the list region contains a particular colour.

Works with the following element types:

Contains Colour

Determines if the specified element in the grid region contains a particular colour.

Works with the following element types:

Uniform Colour

Determines if the region consists of a uniform colour.

Works with the following element types:

Uniform Colour

Determines if the specified element in the list region consists of a uniform colour.

Works with the following element types:

Uniform Colour

Determines if the specified element in the grid region consists of a uniform colour.

Works with the following element types:

Recognise Text

Compares text using character matching from a rectangular area on a window

Works with the following element types:

Recognise Text

Compares text using character matching from a list element in a rectangular area on a window

Works with the following element types:

Recognise Text

Compares text using character matching from a grid cell in a rectangular area on a window

Works with the following element types:

Get Text

Compares against text retrieved from a java element

Works with the following element types:

Count Items

Counts and returns the number of items contained in a listview or Treeview.

Works with the following element types:

IsFocused

Determines whether a java element is focused

Works with the following element types:

Get Field

Compares contents of a terminal field

Works with the following element types:

Get Window Text

Compares main text of a window or control

Works with the following element types:

Check Exists

Check the element exists - True or False

Works with the following element types:

Check Exists

Check that the Active Accessibility element exists - True or False

Works with the following element types:

Check Exists

Check that the Java element exists - True or False

Works with the following element types:

Check Exists

Check if the terminal field exists, with the text contained when spied - True or False

Works with the following element types:

Checked

Check if the item (e.g a checkbox) is checked - True or False

Works with the following element types:

Checked

Check if the item (e.g a checkbox) is checked - True or False

Works with the following element types:

Document Loaded

Check if the current document has loaded - True or False. Relevant only for browser applications. Do not use this unless you know you are already on the page which you are waiting to load, otherwise it is more appropriate to use Parent Document Loaded on an element on the target page. Parent Document Loaded includes an implicit Check exists on the element as well as a Document Loaded check.

Works with the following element types:

Parent Document Loaded

Check the element exists and that the entire page and all of its child frames are fully loaded. Parent Document Loaded includes an implicit Check exists on the element as well as a Document Loaded check.

Works with the following element types:

Check URL

Check if the URL of the currently loaded document equals a particular value. Relevant only for browser applications

Works with the following element types:

Check URL Domain

Check if the domain of the URL of the currently loaded document equals a particular value. Relevant only for browser applications

Works with the following element types:

Check Value

Check if the HTML element is a specific value

Works with the following element types:

Check DDE Element Readable

Checks whether the supplied DDE element can be located and its value can be read.

Works with the following element types:

Check DDE Topic Available

Checks whether a DDE conversation can be initiated with the specified Server/Topic pair. The Item attribute of the supplied element is ignored.

Works with the following element types:

Pressed

Check if the button has been pressed

Works with the following element types:

MouseLeftDown

Check if the left mouse button has been pressed

Works with the following element types:

Is Connected

Checks whether the business object is currently connected to the application (be it through launching or attaching).

Works with the following element types:

Check Window Active

Checks whether a window is the current active window - the window which receives user input.

Works with the following element types:

Count Items

Gets the number of items in the list

Works with the following element types:

Focused

Checks if the element has focus

Works with the following element types:

Count Items

Gets the number of items in the combo box

Works with the following element types:

Checked

Gets if the element is checked

Works with the following element types:

Checked

Gets if the element is checked

Works with the following element types:

Check Exists

Check that the Web element exists - True or False

Works with the following element types:

Check Window Attribute

Check the current value of a window attribute.

Works with the following element types:

Check AA Attribute

Get the current value of an Active Accessibility attribute.

Works with the following element types:

Check HTML Attribute

Get the current value of an HTML attribute.

Works with the following element types:

Check JAB Attribute

Get the current value of a Java Access Bridge attribute.

Works with the following element types:

Check UI Automation Attribute

Get the current value of a UI Automation attribute.

Works with the following element types:

Element Types

Application

An element representing the target application as a whole.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: Application

Edit

A standard Windows text edit field.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: Edit

Password

A Windows password text box.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: Password

List Box

A standard Windows List Box.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: ListBox

Radio button

A standard Windows Radio Button

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: RadioButton

Check box

A standard Windows check box

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: CheckBox

Check box (.NET)

A .NET check box

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: NetCheckBox

Button

A standard Windows Button

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: Button

Combo Box

A standard Windows Combo Box

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: ComboBox

List View

A standard Windows List View

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: ListView

List View

An ActiveX List View

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: ListViewAx

Tree View

A standard Windows Tree View

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: Treeview

Tree View

An ActiveX Tree View

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: TreeviewAx

Status Bar

An ActiveX Status Bar

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: StatusBarAx

Tab Control

A standard Windows Tab Control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: TabControl

Track Bar

A standard Windows Track Bar Control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: TrackBar

Up-Down Box

A standard Windows Up-Down Control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: UpDown

DateTime Picker

A standard Windows DateTime-Picker Control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: DateTimePicker

Month Calendar Picker

A standard Windows Month Calendar Picker Control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: MonthCalPicker

Scroll Bar

A standard Windows Scroll Bar

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: ScrollBar

Label

A standard Windows Label

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: Label

Link Label (.NET)

A standard .NET Link Label

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: NetLinkLabel

Toolbar

A standard Windows Toolbar

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: Toolbar

.NET DataGrid

A .NET DataGrid control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: DataGrid

.NET DataGridView

A .NET DataGridView control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: DataGridView

Window

A standard Windows Window.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: Window

MSFlexGrid

A Microsoft FlexGrid ActiveX Control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: MSFlexGrid

ApexGrid

An Apex Grid ActiveX Control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: ApexGrid

DTPicker

A VB6 Date Picker control

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: DTPicker

Region

A rectangular region within a Window identified using either coordinates or an image. For regions located using an image, actions and conditions will search the parent element in the application window for the region's image to identify its location - actions will raise an error if the region cannot be found.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: WindowRect

List Region

A list of contiguous regions within a window

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: Win32ListRegion

Grid Region

A table of regions within a window

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: Win32GridRegion

Field

A terminal emulator field

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: TerminalField

Active Accessibility

An Active Accessibility element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: AAElement

Button (AA)

An Active Accessibility Button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: AAButton

Check Box (AA)

An Active Accessibility Checkbox element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: AACheckBox

Combo Box (AA)

An Active Accessibility Combo Box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: AAComboBox

List Box (AA)

An Active Accessibility List Box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: AAListBox

Radio Button (AA)

An Active Accessibility Radio button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: AARadioButton

Edit (AA)

An Active Accessibility Edit box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: AAEdit

UI Automation

A generic UI Automation element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAElement

Button (UIA)

A UI Automation button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAButton

Check Box (UIA)

A UI Automation check box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIACheckBox

Radio Button (UIA)

A UI Automation radio button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIARadio

Combo Box (UIA)

A UI Automation combo box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAComboBox

Edit Box (UIA)

A UI Automation edit box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAEdit

Menu (UIA)

A UI Automation menu element

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAMenu

Menu Item (UIA)

A UI Automation menu item element

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAMenuItem

List (UIA)

A UI Automation list element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAList

List Item (UIA)

A UI Automation list item element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAListItem

Table (UIA)

A UI Automation table element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIATable

Tab Control (UIA)

A UI Automation Tab Control.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIATabControl

Tab Item (UIA)

A UI Automation Tab Item.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIATabItem

Hyperlink (UIA)

A UI Automation hyperlink element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAHyperlink

Tree View (UIA)

A UI Automation tree view element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIATreeView

Tree View Item (UIA)

A UI Automation tree view item element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIATreeViewItem

Window (UIA)

A UI Automation window element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: UIAWindow

Web Element

A generic Web element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebElement

Button (Web)

A Web page button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebButton

Check Box (Web)

A Web page check box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebCheckBox

Form (Web)

A Web form element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebForm

Hyperlink (Web)

A Web hyperlink element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebLink

List (Web)

A Web list element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebList

List Item (Web)

A Web list item element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebListItem

Menu (Web)

A Web menu element

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebMenu

Menu Item (Web)

A Web menu item element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebMenuItem

Progress Bar (Web)

A Web progress bar element

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebProgressBar

Radio Button (Web)

A Web radio button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebRadio

Slider (Web)

A Web slider element

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebSlider

Table (Web)

A Web table element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebTable

Table Item (Web)

A Web table item element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebTableItem

Text (Web)

A Web text element

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebText

Text Edit (Web)

A Web text edit element

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: WebTextEdit

HTML Element

An HTML DOM element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: HTML

HTML Button

An HTML Button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: HTMLButton

HTML Check Box

An HTML Checkbox element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: HTMLCheckBox

HTML Radio Button

An HTML Radio button element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: HTMLRadioButton

HTML Edit

An HTML Edit box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: HTMLEdit

HTML Combo Box

An HTML Combo box element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: HTMLCombo

HTML Table

An HTML Table element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: HTMLTable

Edit (Java)

A Java edit box.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: JavaEdit

Password Edit (Java)

A Java password edit field.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: JavaPasswordEdit

Check Box (Java)

A Java check box.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaCheckBox

Radio Button (Java)

A Java radio button.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaRadioButton

Toggle Button (Java)

A toggle button - ie a button that retains its pressed state until it is pressed again.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaToggleButton

Menu Item (Java)

A Java menu item.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaMenuItem

Menu (Java)

A Java menu, often found at the top of a main application window.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaMenu

Button (Java)

A Java button.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: JavaButton

Scrollbar (Java)

A Java scrollbar.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaScrollBar

ComboBox (Java)

A Java combobox.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaComboBox

Dialog Window (Java)

A dialog window, as often used in pop-up forms.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaDialog

Tab Page Selector (Java)

A tab in a tab control, which when selected changes the currently viewed page.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaTabSelector

Progess Bar (Java)

A Java progress bar.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaProgressBar

Track Bar (Java)

A track bar control, which consists of a pointer on a sliding scale to indicate a numeric value.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaTrackBar

Up-Down Box (Java)

An up-down box, consisting of a textbox with some up/down buttons for adjusting the value in the box.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaUpDown

Table (Java)

A java table - an analogous control to the windows listview, when viewed in details mode.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaTable

Tree View (Java)

A java tree view.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaTreeView

Tree Node (Java)

A java tree view node.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaTreeNode

List Box (Java)

A java list box.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaListBox

Tab Control (Java)

A java tab control.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaTabControl

Tool Bar (Java)

A java tool bar.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaToolBar

Popup Menu (Java)

A Java popup menu.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: JavaPopupMenu

Java

A Java element.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: Java

DDE Element

A Dynamic Data Exchange (DDE) field.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: DDEElement

SAP Status Bar

A SAP Status Bar.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPStatusBar

SAP Title Bar

A SAP Title Bar.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPTitleBar

SAP Main Window

A SAP Main Window.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPMainWindow

SAP Calendar

A SAP Calendar.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPCalendar

SAP GridView

A SAP grid view.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPGridView

SAP Password Field

A SAP password field.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPPasswordField

SAP TextBox

A SAP textbox.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPTextBox

SAP ComboBox

A SAP combobox.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPComboBox

SAP OK Code

A SAP OK Code Field.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPOkCodeField

SAP Button

A SAP button.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPButton

SAP Check Box

A SAP checkbox.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPCheckBox

SAP Radio Button

A SAP radio button.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPRadioButton

SAP Tab Strip

A SAP Tab Strip

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPTabStrip

SAP Tab

A SAP Tab

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPTab

SAP Treeview

A SAP Treeview

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPCtrlTree

SAP User Area

A user area - the main area of the application.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPUserArea

SAP Splitter Shell

A splitter shell - the child panes should contain useful elements.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPSplitter

SAP Gui Container Shell

A shell component.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPGuiContainerShell

SAP Toolbar

A toolbar - not useful directly, but should contain usable buttons.

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPToolbar

SAP Menubar

A menu bar

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPMenubar

SAP Label

A label

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPLabel

SAP Table

A table

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPTable

SAP Scrollbar

A scrollbar

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPScrollbar

SAP Scroll Container

A scroll container with (potentially) a horizontal and vertical scrollbar within.

Supports the following actions:

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPScrollContainer

SAP HTML Viewer

An HTML viewer

Supports the following read actions:

Supports the following conditions:

Internal ID: SAPHTMLViewer

Generic SAP Component

A generic SAP component

Supports the following read actions:

Supports the following conditions:

The following alternate types can be selected:

Internal ID: SAPComponent

Application Types

Windows Application

Windows Application

Internal ID: Win32

Subtypes

My application is launched from an executable file

My application is launched from an executable file

Internal ID: Win32Launch

My application will already be running - I want to attach to an existing instance

My application will already be running - I want to attach to an existing instance

Internal ID: Win32Attach

Java-based Application

Java-based Application

Internal ID: Java

Subtypes

My application is launched from an executable file

My application is launched from an executable file

Internal ID: JavaLaunch

My application will already be running - I want to attach to an existing instance

My application will already be running - I want to attach to an existing instance

Internal ID: JavaAttach

Browser-based Application (Chrome, Firefox)

Browser-based Application (Chrome, Firefox)

Internal ID: Browser

Subtypes

A browser which is already running

A browser which is already running

Internal ID: BrowserAttach

A browser that is launched from an executable file

A browser that is launched from an executable file

Internal ID: BrowserLaunch

Browser-based Application (Internet Explorer)

Browser-based Application (Internet Explorer)

Internal ID: HTML

Subtypes

A browser which is already running

A browser which is already running

Internal ID: HTMLAttach

A browser that is launched from an executable file

A browser that is launched from an executable file

Internal ID: HTMLLaunch

Mainframe Application

Mainframe Application

Internal ID: Mainframe

Subtypes

Generic HLLAPI

Generic HLLAPI

Internal ID: MainframeGEN

IBM iAccess For Windows (We do not currently support IBM iAccess Client Solutions) (EHLLAPI)

IBM iAccess For Windows (We do not currently support IBM iAccess Client Solutions) (EHLLAPI)

Internal ID: MainframeIAC

IBM Personal Communicator (COM API)

IBM Personal Communicator (COM API)

Internal ID: MainframeIBM

IBM Personal Communicator (HLLAPI)

IBM Personal Communicator (HLLAPI)

Internal ID: MainframePCH

Micro Focus Attachmate Extra! X-treme 9.3 (ATMAPI32)

Micro Focus Attachmate Extra! X-treme 9.3 (ATMAPI32)

Internal ID: MainframeATM

Micro Focus Infoconnect (WinHLLAPI)

Micro Focus Infoconnect (WinHLLAPI)

Internal ID: MainframeINF

Micro Focus Reflection 9.x and earlier (COM API)

Micro Focus Reflection 9.x and earlier (COM API)

Internal ID: MainframeART

Micro Focus Reflection for Desktop 16 (.NET API)

Micro Focus Reflection for Desktop 16 (.NET API)

Internal ID: MainframeARN

Micro Focus Rumba (EHLLAPI)

NeoWare (later WallData) Rumba terminal emulator, via the HLLAPI interface. With version 6 (Rumba 2000) the working directory must be the one where the emulator's HLLAPI DLLs reside, otherwise attempting to connect results in an 'invalid presentation space' error message.

Internal ID: MainframeRUM

OpenText HostExplorer (formerly Hummingbird) (COM API)

OpenText HostExplorer (formerly Hummingbird) (COM API)

Internal ID: MainframeHUM

OpenText HostExplorer (formerly Hummingbird) (EHLLAPI)

OpenText HostExplorer (formerly Hummingbird) (EHLLAPI)

Internal ID: MainframeHEE

Ericom PowerTerm InterConnect (HLLAPI)

Ericom PowerTerm terminal emulator, via standard HLLAPI interface. Version 6 is not supported due to a flawed HLLAPI implementation. Version 9 is fully supported. The status of versions 7 and 8 is unknown.

Internal ID: MainframePWT

HP Teemtalk (EHLLAPI)

Pericom (later HP) TeemTalk terminal emulator, via the HLLAPI interface. Version 4 of TeemTalk does not work with HLLAPI when using IBM 5250 emulation. (See issue #4976). It is known to work with IBM 3270. The status for other emulation modes on that version is unknown.Support for HLLAPI was completely removed from TeemTalk from version 7 onwards. We have never tested with versions 5 and 6.

Internal ID: MainframeTMT

NDL Active Conductor (HLLAPI)

NDL Active Conductor (HLLAPI)

Internal ID: MainframeCON

RMD (HTTP/XML)

RMD (HTTP/XML)

Internal ID: MainframeRMD

Rocket PASSPORT (COM API)

Rocket PASSPORT (COM API)

Internal ID: MainframePSS