SelectItems
This action clicks the link/element which will populate a download window, and then downloads the file.
The action supports and is explicitly tested for FF3, IE7, IE8. The action will not wait till the file is downloaded, this have to be handle externally by the user.
This action requires AutoIt to be installed.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- After the set up is completed, AutoIT installation path should be set against the Qualitia's configfile key "AutoITPath"
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 |
The path where the file is to be download. Please check Table 1 "Parameter Mandate" to validate in the situation where this parameter will be mandatory. In case the parameter Mandatory; the user should take care that the folder path exists. The action does not validates whether the folder exist
Yes
String
Filename
The filename of the downloadable file, to be given incase the user requires to give specific name and not depend on the default name of the file. In case, the file already exist, similar window like below will appear. Such windows are not handled by the action. Incase, the user does not provide this data, the action will pick the default file name available while download. This parameter is not mandatory
Yes
String
| title | Important Notes: |
|---|
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads.
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669
2. When a download window is populated, the following window will also exist.
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.
Important Notes for Firefox: Firefox uses the default Firefox instance:-
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
Table 1: Parameter Mandate
Browser
locator
folderPath
fileName
Internet Explorer
Mandatory
Mandatory
Not mandatory
Above is the default download setting in the default Firefox instance invoke my Selenium.
Mandatory
Mandatory
Not mandatory
DownloadFile "C:/ProgramData" "Qualitia"
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.
Enter the name of the item that needs to be selected. Separate multiple items by carat (^) operator. | No | Array |
Example:
SelectItem "England^India^Australia"
| Note |
|---|
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. |
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
On this page:
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
VerifyItemsExist
This action verifies the existence of the objects in the specified objectlist.
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. |
If True – checks if the edit box exists
If False – checks if the edit box does not exist
| Yes | String |
Example:
VerifyExistence 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"
VerifyVisibility
This action verifies the visibility of the specified object."true"
| Note |
|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
SelectItemByIndex
This action selects the specified item from the list. Index starts from 1.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|
visibility
Value of this parameter can be true or false.
If True – checks if the edit box is visible
If False – checks if the edit box is not visible
Yes
String
Example:
VerifyVisibilityindex | 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 "True3"
VerifyItemsInSequence
This action clicks the specified object.
Example:
Click
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", "label", "hint"
Input Parameters:
ParameterNameverifies 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"
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 |
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 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 "key" "text"
SetFocus
This action sets the focus to the specified object.
Example:
SetFocus
MouseOver
This action simulates the user hovering mouse over the specified object.
Example:MouseOver
MouseDown
This action simulates the user pressing the left mouse button at the specified locationIndia^England" 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 |
|---|
X
The x-coordinate of the click.
Yes
String
Y
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:
MouseDown "5" "10"
If a list contains the items "India","England,"S.A", then to verify its size this action can be used as follows.
VerifyListBoxSize "3"
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
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"
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
This action clicks at a particular point on the object
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
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 |
|---|
X
key | Enter the key name under which you want to store the items. | Yes | String |
Y
The x-coordinate of the click.
Yes
String
Example:
ClickAt "5" "10"
ClickIfExists
This action clicks the object if the specified object exists. .
Example
ClickIfExists
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) windowExample:
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 |
|---|
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
key | Enter the key name under which you want to store the items. | Yes | String |
Example:
WaitForObject StoreSelectedItems "10" "trueselectedItemsKey"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.
DragAndDrop
This action drags the specified object to a certain distance and drops itConsider 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:
DragAndDropParameter 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,…
NO
0
offsetY
offset in pixels from the current location to which the element should be moved. The offset parameter can be as -100,100 , +100
NO
0
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 "-100" "500India"
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
| Note |
|---|
| Note |
If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList. |
ClickandchooseOkOnNextConfirmation
This action clicks the specified object. After clicking the object, if an alert or confirmation comes up this action will accept it by clicking on OK. If the link is clicked and no alert or confirmation comes up the action will fail.
Example:
ClickandchooseOkOnNextConfirmation
RightClick
This action right-clicks the specified object.
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
DragAndDrop
This action drags an object to a certain distance and drops it.
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
|---|
option
StoreExistence
This action stores existence of the object under a key. 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 existence (true/false) of the object is stored.
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 |
RightClick "3"
Note: This will select the third option from the context menu.
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:
StoreExistence DragAndDrop "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 -100" "Key"
ScrollIntoView
This action scrolls to view the specified object.
This action does not have any parameters.
Example:
ScrollIntoView500"
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|
| Multiexcerpt include macro | ||||
|---|---|---|---|---|
|