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.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

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 multiple selection property.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

item

The name of the item(s) as it appears in the list.
To give multiple items, the items need to be separated using 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 of this parameter can be true or false.
If True – checks if the object exists
If False – checks if the object does not exist

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 of this parameter can be true or false.
If True – checks if the object is visible
If False – checks if the object is invisible

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

Items that need to be verified in the list
Data Type for this parameter is Array and each item needs to be separated with caret operator (^).
This action checks if the given items are a sublist of the actual items in the list

Yes

Array

existence

Value of this parameter can be true or false.
If True – checks if the object exists
If False – checks if the object does not exist

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"
Note:

  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.
Example:
Click

StorePropertyValue

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                               "value"                     "name"

SelectItemByIndex

This action selects an item from the list based on its index in the list.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

index

Specified index value of a list item that is to be selected in the list box. 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 the user wishes to select "Australia", then this action can be used as follows
SelectItemByIndex                         "3"

VerifyItemsInSequence

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

List of multiple items in expected sequence. The multiple items are to separated by a caret (^)

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 item(s) from the specified list box. Multiple items for deselection can be given only for the list box that has multiple selection property.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

Expected list item(s) that are to be deselected in the list box. If multiple items are to be passed for deselection, then the list items should be separated by a caret (^).

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 item(s) with the expected selected item(s) list. 
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

List item(s) that are expected to be selected in the list box. If multiple expected items are to be passed for verification, then the list items should be separated by caret (^)

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) in the specified list box with the expected number of items (size).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expectedSize

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. It allows only digits.

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 moves the focus to the specified object. 

Example:
SetFocus

MouseOver

This action simulates users hovering the mouse over the specified object.

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 particular point on the object.

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:

ClickAt           "5"               "10"

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

StoreItems

This action stores all the items of a list in a key. The items in the key are separated using caret operator.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The key in which the items of the list items will be stored.

Yes

String

Example:
Consider a list having the items 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 status will be fail as the list contains duplicate item "Monday"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value of this parameter can be true or false.

If True – checks if the checkbox is enabled
If False – checks if the checkbox is disabled

Yes

String

Example:
VerifyEnability                          "True"

StoreSelectedItems

This action stores all the selected items of a list in a key. The items in the key are separated using caret (^).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The key in which the selected items will be stored.

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

RightClick

This action right-clicks the particular webelement.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

Enter the context menu option number that needs to be clicked.

Yes

String


Example
RightClick         "3"

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

SelectItemAndWait

This action selects an item from the list and waits. It waits for the max sync time set in the Qualitia configuration (Execution) window for the key "Sync Time". If the page loads before the max sync time, then the action will stop waiting.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

item

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 to be selected.
In Webdriver we wait 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 will stop 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.

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 edit box and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:

ClickAndWait

In Webdriver we wait 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 will stop 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.

StoreExistence

This action stores existence of the object in a variable (key).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                        "Key"

StoreChildCount

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in 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 parameters. 

Example:

ScrollIntoView

  • No labels