Desktop Automation - Action Documentation

Desktop Action Documentation

Article summary

Did you find this summary helpful?

Thank you for your feedback

Desktop actions are exposed in the Desktop Automation framework in Quality Modeller. The corresponding Git repository is available https://github.com/CuriositySoftwareIreland/TestModeller-FlaUI. This uses FlaUI with C# as the underlying automation technology.

When the framework is imported into Quality Modeller, the actions below are available in the 'DesktopGeneralActions' module. This provides an accelerator for automating common actions on Desktop applications. This class can be extended to incorporate your own keywords and actions as necessary.

QuickStart Desktop Test Automation

To learn how you can quickly get started with Desktop Automation in Quality Modeller: QuickStart Desktop Automation

Location Strategy

All keywords in the Quality Modeller DesktopGeneralActions library that need to find an element on the page take a locator argument. Locator is a string that specifies the element identifier to use for finding the element. We recommend you use FlaUIInspect to find the associated ID for an element, https://github.com/FlaUI/FlaUInspect.

Strategy	Example
XPath	xpath://input[id="username"]
Id	id:usernameId
Class	class:username
Text	text:#usernameId
Value	value:user
Help Text	helpText:usernameObj
Automation ID (Default)	usernameObjID

Library Usage

In order to use the library actions, you need to firstly open an application on the Windows desktop. To do this, you can use the command 'Open Application' with the parameter of the location of the application. e.g.

OpenApplication("c:\calc.exe")

Desktop Actions

Open Store Application (String appName)

Arguments

appName - Application name from store

Documentation

Launches an application from the Store.

Open Application (String appName)

Arguments

appName - Relative or absolute path to executable to launch

Documentation

Launches an application.

Use Main Window

Documentation
Use main window

Enter Text (String objectName, String text)

Arguments

objectName - Object identifier
text - Value to set to textbox

Documentation
Inputs value to a textbox module.

AssertLabelText(String objectName, String text)

Arguments

objectName - Object identifier

text - Text to assert label

Documentation

Close Application

Documentation
Closes the attached application.

Click (String objectName)

Arguments

objectName - Object identifier

Documentation
Click to element.

Right Click (String objectName)

Arguments

objectName - Object identifier

Documentation
Right click to element.

Double Click (String objectName)

Arguments

objectName - Object identifier

Documentation
Double click to element.

Select Combobox Item By Index (String objectName, int index)

Arguments

objectName - Object identifier

index - Index of the combobox item to select

Documentation
Selects item from combobox with given index number. Combobox will be automatic collapsed after selection is done.

Select Listbox Item By Index (String objectName, int index)

Arguments

objectName - Object identifier

index - Index of the list box item to select

Documentation
Selects item from listbox with given index number

Select Radiobutton (String objectName)

Arguments

objectName - Object identifier

Documentation
Select given radiobutton by xpath.

Close Window

Documentation

Close the current window open

Collapse All Treeitems (String objectName)

Arguments

objectName - Object identifier

Documentation
Collapse every collapsable tree items of the given tree.

Collapse Combobox (String objectName)

Arguments

objectName - Object identifier

Documentation
Collapse combobox.

Combobox Should Contain (String objectName, String itemName)

Arguments

objectName - Object identifier

itemName - Name the combobox should contain

Documentation
Checks if Combobox contains an item

Drag And Drop (String fromObject, String endObject)

Arguments

objectName - Object to drag from

endObject - Object to drag onto

Documentation
Clicks and hold the item with start_identifier and drops it at item with end_identifier.

Element Should Be Visible (String objectName)

Arguments

objectName - Object identifier

Documentation
Checks if element is visible. If element is visible True will be returned otherwise False.

Element Should Exist (String objectName)

Arguments

objectName - Object identifier

Documentation
Checks if element exists. If element exists True will be returned otherwise False.

Element Should Not Be Visible (String objectName)

Arguments

objectName - Object identifier

Documentation
Checks if element is visible.

Element Should Not Exist (String objectName)

Arguments

objectName - Object identifier

Documentation
Checks if element exists. If element exists False will be returned otherwise True.

Expand All Treeitems (String objectName)

Arguments

objectName - Object identifier

Documentation
Expands every expandable Tree Items items of the given tree.

Expand Combobox (String objectName)

Arguments

objectName - Object identifier

Documentation
Expand combobox.

Expand Treeitem (String objectName)

Arguments

objectName - Object identifier

Documentation
Expands item from tree by hybrid pointers, series of indexes and names.

Focus (String objectName)

Arguments

objectName - Object identifier

Documentation
Try to focus element.

Get Checkbox State (String objectName)

Arguments

objectName - Object identifier

Documentation
Return actual checked state from checkbox.

Get Combobox Items Count (String objectName)

Arguments

objectName - Object identifier

Documentation
Return actual count of items in combobox.

Get Grid Rows Count (String objectName)

Arguments

objectName - Object identifier

Documentation
Return count of rows from data grid.

Get Listbox Items Count (String objectName)

Arguments

objectName - Object identifier

Documentation
Return count of rows in listbox.

Get Name From Element (String objectName)

Arguments

objectName - Object identifier

Documentation
Return name value from element.

Get Radiobutton State (String objectName)

Arguments

objectName - Object identifier

Documentation
Return actual state from radiobutton.

Get Root Treeitems Count (String objectName)

Arguments

objectName - Object identifier

Documentation
Return count of items in the first level of the tree.

Get Text From Textbox (String objectName)

Arguments

objectName - Object identifier

Documentation
Return text from textbox element.

Verify Element Enabled (String objectName)

Arguments

objectName - Object identifier

Documentation
Verifies if element is enabled (true) or not (false).

Listbox Selection Should Be (String objectName, String name)

Arguments

objectName - Object identifier

name - Name of the selected listbox item should be

Documentation
Checks if the selected listbox items are same with the given ones.

Listbox Should Contain (String objectName, String name)

Arguments

objectName - Object identifier

name - Name the listbox should contain

Documentation
Checks if listbox contains the given item.

Move To Position (int xPos, int yPos)

Arguments

xPos - Move the cursor to the x coordinate

yPos - Move the cursor to the y coordinate

Documentation
Move mouse cursor to given position.

Move To Element (String objectName)

Arguments

objectName - Object identifier

Documentation
Move mouse cursor to given element.

Name Contains Text (String objectName, String text)

Arguments

objectName - Object identifier

text - Text the element should contain

Documentation
Verifies if element name contains to name.

Name Should Be (String objectName, String name)

Arguments

objectName - Object identifier

name - Name the element should be

Documentation
Verifies if name from element is equal.

Select Listbox Item By Name (String objectName, String name)

Arguments

objectName - Object identifier

name - Name of the listbox item to select

Documentation
Selects item from listbox by name.

Select Tab Item By Name (String objectName, String name)

Arguments

objectName - Object identifier

name - Name of the tab to select

Documentation

Select the item in the selected tab by name

Select Treeitem (String objectName)

Arguments

objectName - Object identifier

Set Checkbox State (String objectName, Boolean state)

Arguments

objectName - Object identifier

state - State of the checkbox

Documentation
Set checkbox state to True or False

Wait Until Element Is Responsive (String objectName)

Arguments

objectName - Object identifier

Documentation
Waits until element is responsive or timeout was reached.

What's Next

QuickStart Katalon Automation

Table of contents

Location Strategy
Library Usage
Desktop Actions