Document toolboxDocument toolbox

A new version of Qualitia Automation Studio for Web and Mobile 7.2.x is now available. We highly recommend you upgrade. Find more details here.

WebList Actions

Owned by Sagar Dubewar (Unlicensed)
Last updated: Mar 02, 2018
5 min read

SelectItems

This action selects particular item or items from a list. Multiple items for selection can be given only for the list box that has multi-selection property.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

item

Enter the name of the item that needs to be selected. Separate multiple items by carat (^) operator. 

No

Array

Example:
SelectItem                                         "England^India^Australia"

Consider a list containing names of countries. If it contains list items "India", "England", "Australia" and the user wishes to select "England", then this action can be used as follows. If an empty data ("" or $NULL$) is passed as the data, the action will be passed only if there exist an item "" in the webList to be selected.

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false.

  • Set True if you want to check the existence.
  • Set False if you want to check the non-existence.

Yes

String

Example:
VerifyExistence                      "True"

On this page:

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value for this parameters can be true or false.

  • Set True if you want to check the visibility.
  • Set False if you want to check the invisibility.

Yes

String

Example:
VerifyVisibility                      "True"

VerifyItemsExist

This action verifies the existence of the objects in the specified list. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

Enter the items for which you want too check the existence. Separate multiple items by carat (^) operator. 

Yes

Array

existence

Value of this parameter can be either true or false.

  • Set true if you want to check the object existence.
  • Set false if you want to check the object non-existence. 

Yes

String

Example:
Consider a list containing names of countries "India", "Australia", "England", "South Africa". If the user wishes to verify if India, England, South Africa are in the list, then this action can be used as follows:
VerifyItemsExist            "India^South Africa^England"           "true"

  1. "^" in Qualitia is a delimiter for items in an array.
  2. If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList.

Click

This action clicks the specified object.

This action does not have any parameter.

Example:
Click

StorePropertyValue

This action stores the property of the specified object under the key name. The stored key value can be retrieved using the key name.

Some Android and iOS properties are not accessible.

List of accessible properties for Android: "name", "contentDescription", "className", "resourceId", "text", "enabled", "checkable", "checked", "clickable", "focusable", "focused", "longClickable", "scrollable", "selected", "displayed"

List of accessible properties for iOS: "name", "value", "label", "hint"

Input Parameters:

ParameterName

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which the property value will be stored.

Yes

 String

Property

Property/attribute name whose value needs to be stored under the specified key. This can be any accessible property of Android/iOS native object mentioned above.

Yes

 String

Example:
StorePropertyValue                            "key"                     "text"

SelectItemByIndex

This action selects the specified item from the list. Index starts from 1. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

index

Enter the index value of the list item that you want to select. Index starts at 1.

Yes

Integer

Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" and user wishes to select "Australia", then this action can be used as follows:
SelectItemByIndex                         "3"

VerifyItemsInSequence

This action verifies the actual sequence of items in the specified list box with the expected items' sequence.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

Enter the list of items in expected sequence. Separate multiple items by carat (^) operator. 

Yes

Array


Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" then to verify a sequence in the list, this action can be used as follows:

VerifyItemsInSequence                "India^England^Australia^SA"

DeSelectItems

This action deselects the specified selected items from the specified list box. Multiple items for deselection can be given only for the list box that has multi-selection property.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

Enter the expected list items that are to be deselected from the list box. Separate multiple items by carat (^) operator.

Yes

Array

Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" , if the user wishes to deselect "India and Australia", then this action can be used as follows:

DeSelectItems                                 "India^Australia"
(warning) If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList to be deselected.

VerifySelectedItems

This action verifies the selected items with the expected items list.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

Enter the list items that are expected to be selected from the list box. Separate multiple items by carat (^) operator.

Yes

Array

Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" , if India and England are selected and this needs to be verified, the this action can be used as follows
VerifySelectedItems                                       "India^England"
(warning) If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" selected item in the webList.

VerifySize

This action compares the actual number of items (size) from the specified list box with the expected number of items (size).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expectedSize

Enter the expected size of the list box that will be compared with the actual size of the list box.

The data type of this parameter is Numeric.

Yes

String

Example:
If a list contains the items "India","England,"S.A", then to verify its size this action can be used as follows.
VerifyListBoxSize                         "3"


SetFocus

This action sets the focus on the specified object.

This action does not have any parameter. 

Example:
SetFocus

MouseOver

This action simulates a mouse hovering over the specified object.

This action does not have any parameter. 

Example:
MouseOver

MouseUp

This action simulates the event that occurs when the user releases the mouse button.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Y

The x-coordinate of the click.

Yes

String

X

The x-coordinate of the click.

Yes

String

Example:

MouseUp        "5"         "10"

ClickAt

This action clicks at the specified point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The y-coordinate of the click.

Yes

String

Example
ClickAt        "5"            "10"

WaitForObject

This action waits for the object to appear or disappear for the maximum number of seconds specified.

If the object is found or not found before the maximum time specified, execution continues to the next steps.

If the wait time is "" then the wait time shall be the "Sync Time" set under the Configuration Settings (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

Enter the number of seconds to wait for the object to appear or disappear. This has to be 0 or any positive number.

Yes

String

existence

Value for this parameter can be true or false.

  • Set true if you want to check for the appearance of the object.
  • Set false if you want to check for the disappearance of the object.

Yes

String

Example:

WaitForObject              "10"            "true"
The action waits for maximum 10 seconds for the object to appear. If the object appears before 10 seconds elapses, execution continues to the next steps.
WaitForObject             "15"            "False"
The action shall wait for maximum 15 seconds for the object to disappear. If the object disappears before 15 seconds elapses,execution continues to the next steps.

StoreItems

This action stores all the items from the specified list under the key name. Items are separated by carat (^) operator and can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the key name under which you want to store the items. 

Yes

String

Example:
Consider a list having the items like, Monday, Tuesday, Wednesday.
StoreItems                       "Key"
The items in the key will be stored as Monday^Tuesday^Wednesday.

VerifyNoItemsDuplication

This action verifies that no items are duplicated in the list.

Example:

VerifyNoItemsDulication

Consider a list having the items Monday, Tuesday, Wednesday, Monday

The action will fail because the if the list contains duplicate item "Monday"

StoreSelectedItems

This action stores all the items of a list that are selected under the specified key. Multiple items are stored separated by carat (^) operator. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the key name under which you want to store the items. 

Yes

String

Example:

StoreSelectedItems                  "selectedItemsKey"

Consider a list having the items Monday, Tuesday, Wednesday, Thursday, Friday. Suppose Tuesday and Friday is selected in the list.

The items in the key will be stored as Tuesday^Friday

SelectItemAndWait

This action selects an item from the list and waits. It waits for the sync time set under the Configuration Settings (Execution) window. If the page loads before reaching the maximum sync time, then the action will stop waiting.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

item

Enter the item to be selected from the list.

Yes

String

Example:
Consider a list containing names of countries. If it contains list items "India", "England", "Australia" and the user wishes to select "England", then this action can be used as follows
SelectItemAndWait                      "India"

If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList.
Webdriver waits for the document to come in ready state. If it is in ready state it is assumed that the page is loaded completely and Webdriver stops waiting. The condition to wait till the document is in ready state and assume that the page is loaded could however not work as expected at all times.

RightClick

This action right-clicks the specified web element.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

The context menu option number that needs to be clicked.

Yes

String

Example:
RightClick             "3''

This will select the third option from the context-menu.

DragAndDrop

This action drags an object to a certain distance and drops it.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

offsetX

Offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10,…

Yes

String

offsetY

offset in pixels from the current location to which the element should be moved The offset parameter can be as -100,100 , +100

Yes

String

Example:

DragAndDrop                                       "-100"                             "500"

ClickAndWait

This action clicks the specified object and waits for the seconds specified in Sync Time under the Configuration Settings (Execution) window.

Default value is 20 seconds. If the page loads before reaching the maximum sync time execution continues to the next steps. 

This action does not have any parameter. 

Example:
ClickAndWait

Webdriver waits for the document to come in ready state. If it is in ready state it is assumed that the page is loaded completely and Webdriver stops waiting. The condition to wait till the document to load in ready state and assume that the page is loaded could however not work as expected at all times.

StoreExistence

This action stores existence of the object under the specified key. The key value can be retrieved using the key name. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which the existence's Boolean value will be stored. 

  • Stores True if the object exists.
  • Stores False if the object does not exist.

Yes

String

Example:

StoreExistence                               "Key"

StoreChildCount

This action stores the child count of the specified object under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which the child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameter. 

Example:

ScrollIntoView

ActionClick

This action clicks the specified object from the web application under test.

This action does not have any parameter.

Note: ActionClick uses underlying selenium WebDriver “Action” class to perform click action. Qualitia recommends using this action for web applications.

Example:

ActionClick

ClickJS

This action clicks the specified object from the web application under test.

This action does not have any parameter.

Note: ClickJS uses javascript code to perform the click action. Qualitia recommends using this action for web applications.

Example:

ClickJS

Not finding what you need?