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.

MobileList Actions

ClickElement

This action clicks the element present at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

listItemIndex

Enter the list item index which you want to select. Index starts at 1.

Yes

 String

listItemMemberIndex

Enter the list item member from the list which you want to select. Index starts at 1.

Yes

String 

Example:
ClickElement                      "3"                    "2" 

VerifyText

This action verifies the actual data of the specified location matches with the expected data.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

data

Enter the data which you want to verify (case-sensitive).

Yes

 String

listItemIndex

Enter the list item index from which you want to verify the data.

Yes

String

listItemMemberIndex

Enter the list item member index from which you want to verify the data.

Yes

 String

Example: 
VerifyText                     "Qualitia"                 "3"                "1" 

On this page:


StoreListItemMembersCount

This action stores the total count of the specified list item members 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 you want to store the count.

Yes

String

Example:

StoreListItemMembersCount                       "Key"

DeSelectCheckboxAtListItemMember

This action deselects the check box present at given list item index.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

listItemIndex

Enter the list item index from where check box is to be deselected.

Yes

String

listItemMemberIndexEnter the list item member index from where check box is to be deselected.YesString

Example: 

DeSelectCheckboxAtListItemMemberIndex                             "3"             "7"

VerifyListItemCount

This action verifies the total count of items present under the list with the expected specified count.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expectedListItemsCount

Enter the expected count.

Yes

String

Example:

VerifyListItemCount               "5"

StoreListItemIndexContainingMinValue

This action stores the list item index which contains the minimum value. This action only works with numerical data.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

KeyEnter the key in which the list item index will be saved.YesString

listItemMemberIndex

Enter the list item member index in which the data is to be checked.

Yes

String

Example:

StoreListItemIndexContainingMinValue             "Key"             "1"

StoreListItemIndexContainingMaxValue

This action stores the list item index which contains the maximum value. This action only works with numerical data.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

KeyEnter the key in which you want to save the list item index.YesString

listItemMemberIndex

Enter the list item member index in which you want to look for the data.

Yes

String

Example:

StoreListItemIndexContainingMaxValue             "Key"             "1"

StoreListItemIndexContainingText

This action stores the list item index which contains the specified text. 

The comparison is case-sensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

KeyEnter the key in which you want to save the list item index.YesString
textToVerifyEnter the text that you want to verify.YesString

listItemMemberIndex

Enter the list item member index in which you want to check the data.

Yes

String

Example:

StoreListItemIndexContainingText             "Key"              "Qualitia"              "1"

CompareListItemMembersData

This action compares the data present at the specified list item member index.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

listItemMemberIndex

Enter the list item member index where you want to compare the data.

Yes

String

expectedListItemMembersDataEnter the expected data to verify.YesArray

Example:

CompareListItemData             "2"              "Qualitia^QTP^WebDriver" 

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"

VerifyListItemMemberCount

This action verifies the list item member count with the expected specified count.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expectedListItemMembersCount

Enter the expected count.

Yes

String

Example:

VerifyListItemMemberCount               "5"

VerifyDataExistenceInListItemMembers

This action verifies the existence of the data present in the specified list item member index. 

The data comparison is case-sensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

listItemMemberIndexEnter the list item member index where existence is to be verified.YesString

expectedListItemMembersData

Enter the expected data separated by carrot. You can provide one or more expected strings.

Yes

Array

existenceEnter the expected existence of the data (true or false).YesString

Example:

VerifyDataExistenceInListItemMembers               "5"                  "49"              "True"

VerifyDataExistenceInListItemMembers               "5"                  "Qualitia^6"              "False"

VerifyDataExistenceInListItem

This action verifies the existence of the data in the specified list item.

The data comparison is case-sensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

listItemIndexEnter the list item index where you want to verify the existence.YesString

expectedListItemsData

Enter the expected data separated by carrot. You can provide one or more expected strings.

Yes

Array

existenceEnter the expected existence of the data (true or false).YesString

Example:

VerifyDataExistenceInListItem                     "7"                  "40"              "True"

VerifyDataExistenceInListItem                     "7"                  "Zensoft^9"              "True"

SelectCheckboxAtListItemMember

This action selects the check box present in the specified list item member. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

listItemIndexEnter the list item index from where you want to select the check box.YesString
listItemMemberIndexEnter the list item member index from where you want to select the check box.YesString

Example:

SelectCheckboxatListItemMember                     "5"           "4"

StorePropertyValue

This action stores the property of the specified object under the key name. The stored 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", "type", "visible", "label", "enabled", "accessible", "rect", "frame", "accessibilityContainer", "wdName", "wdValue", "wdType", "wdVisible", "wdLabel", "wdEnabled", "wdAccessible", "wdRect", "wdFrame", "wdAccessibilityContainer"

Input Parameters:

ParameterName

Parameter Description

Mandatory

Data Type

Key

Variable in which the property value will be stored

Yes

 String

Property

Property/attribute name whose value needs to be stored in "Key". This can be any accessible property of Android/iOS native object.

Yes

 String


Example:
StorePropertyValue                            "key"                     "text"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value for this parameters can be true or false.

  • Set True if you want to verify that the object is enabled. 
  • Set False if you want to verify that the object is disabled.

Yes

String

Example:
VerifyEnability                          "True"

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"

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.

StoreListItemIndexContainingTextInArray

This action checks if each string separated by caret is part of the list item member data.

For example, if list item member data is abc,def,ghi and input data is d^f then listItemIndex 2 will be stored under the key name.

The comparison is case-sensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name in which the index number will be stored.

Yes

String

textArrayToVerifyEnter the text array to be verified.YesArray
listItemMemberIndexEnter the list item member from where the text is to be taken.YesString

Example:

StoreListItemIndexContainingTextInArray                 "Key"               "d^f"                 "3"

Swipe

This action performs swipe and finds object until timeout occurs.

Input Parameters:

ParameterName

Parameter Description

Mandatory

Data Type

upDownLeftRight

Enter the direction of swipe:

  • Up: Move finger from down to up on the device screen.
  • Down: Move finger from up to down on the device screen.
  • Left: Move finger from right to left on the device screen.
  • Right: Move finger from left to right on the device screen.

No

String

timeoutInSeconds

Enter the timeout in seconds.

No

String

swipePageInSeconds

Enter in how many seconds one page should be swiped. Default is 1 second.

(warning) Use this parameter with caution only when control on swipe speed is required.

No

String


Example:
Swipe                  "up"                   "10"             "1"

StoreListItemCount

This action stores the count of list items in 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 in which you want to store the item count.

Yes

String

Example:

StoreListItemCount                  "Key"

Click

This action clicks the specified object.

This action does not have any parameter.

Example:
Click

LongPress

This action performs the long press event on the specified object. 

This action does not have any parameter.

Example:
LongPress

Not finding what you need?