WebLink Actions

Click

This action clicks the specified object.

This action does not have any parameter.

Example:

Click

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

ClickandchooseOkOnNextConfirmation (Deprecated)

This action handles the alert or confirmation that comes up post clicking the OK button. This action fails if the button is clicked and no alert or confirmation comes up.

This action does not have any parameter.

Example:

ClickandchooseOkOnNextConfirmation

ClickAction

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:

ClickAction

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.	No	String
Y	The y-coordinate of the click.	No	String

Example

ClickAt        "5"            "10"

ClickIfExists

This action clicks the object if the specified object exists.

This action does not have any parameters.

Example

ClickIfExists

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

ClickJSAndSelectWindowUsingURL

This action is used to click the web element or object that opens single or multiple windows from which a specific window is selected.
This action accepts 'waitTimeForWindow' for the specific window to open.

This action is used in the following 2 scenarios:

• When a single window opens after clicking the web element/object, you need to give only 'waitTimeForWindow' parameter. 

• When multiple windows open after clicking the web element or object, then you can provide the exact URL or regex patterned URL  window. You must give the URL and 'isURLPatternString' parameters.
  Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
waitTimeForWindow	Enter the wait time for the window to open.	Yes	String
URL	Enter a specific URL or regex pattern of URL for the window you want to select.	No	String
isURLPatternString	Enter one of the following: True: If you want to apply the regex pattern to URL. False: If you do not want to apply the regex pattern to URL.	No	String

Example 1

String waitTimeForWindow : "5",

String url : null(do not give any value)

String isURLPatternString : null(do not give any value)

Expected Result - Here you do not need to provide URL or isURLPatternString as after clicking the object or element opens. The action waits up to 5 seconds for the window to appear after clicking the web element or object and then select the window.

Example 2

String waitTimeForWindow - "5",

String url - "https://bflsme--preprod.cs57.my.salesforce.com/_ui/common/data/LookupPage?                                                             lkfm=editPage&lknm=cas3&lktp=003&lksrch=",

String isURLPatternString - "False",

The action waits for up to 5 seconds for multiple windows to appear after clicking web element or object and it selects the window with the url "https://bflsme--preprod.cs57.my.salesforce.com/_ui/common/data/LookupPage?lkfm=editPage&lknm=cas3&lktp=003&lksrch=". As the isURLPatternString parameter is 'false' , the action finds as per the given URL.  

Example 3

String waitTimeForWindow - "5",

String url - "www.([A-Z])\w+",

String isURLPatternString - "True",

Expected Result - The action waits for up to 5 seconds for multiple windows to open after clicking web element/object and it selects the window which matches the regex pattern  "www.([A-Z])\w+" as provided in the URL parameter. As the isURLPatternString parameter is 'True', the action treats the URL parameter as a regex pattern. In case there are multiple windows satisfying the regex pattern, the action selects the first window.

DoubleClick

This action double-clicks the specified web element.

This action does not have any parameter.

Example:

DoubleClick

DownloadFile

This action clicks the link/element that opens a download window, which is used to download the files. You need to handle the action externally as it does not wait until the file is downloaded.

Qualitia uses its internal mechanism to handle the Download File pop-up screen.

You can also use AutoIT to execute this action on Windows operating systems only. You need to install AutoIT.

After installing AutoIT, you can configure the AutoIT Install path in Qualitia client as follows: Project Configuration > General > Settings > AutoIT Install Path. The default AutoIT path is C:\Program Files (x86)\AutoitV3.

To configure the Auto Install Path for an offline suite:

• Open the Qualitia Offline Configuration Manager.

• Select the Offline Suite and the associated execution profile.

• Click Qualitia Settings > General > AutoIT Path.

Input Parameters:

Parameter Name	Parameter Description	Mandatory	Data Type
folderPath	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.	No	String

Example:

Open

Open

Example 

DownloadFile               "C:/ProgramData"           "Qualitia" 

On this page:

• 1 Click
• 2 ClickAndWait
• 3 ClickandchooseOkOnNextConfirmation (Deprecated)
• 4 ClickAction
• 5 ClickAt
• 6 ClickIfExists
• 7 ClickJS
• 8 ClickJSAndSelectWindowUsingURL
• 9 DoubleClick
• 10 DownloadFile
• 11 DragAndDropToOffset 
• 12 MouseOver
• 13 MouseUp
• 14 MouseDown
• 15 RightClick
• 16 ScrollIntoView
• 17 SetFocus
• 18 SetValueAttribute
• 19 StoreChildCount
• 20 StoreCSSProperty
• 21 StoreExistence
• 22 StoreLocation
• 23 StorePropertyValue
• 24 StoreSize
• 25 StoreText
• 26 StoreValueAttribute
• 27 VerifyEnability
• 28 VerifyExistence
• 29 VerifyVisibility
• 30 ClickandChooseOkOnNextConfirmation (Deprecated)
• 31 StoreVisibility 
• 32 WaitForAttributeContains
• 33 WaitForAttributeNotContains
• 34 WaitForAttributeNotToBe
• 35 WaitForAttributeNotToBeEmpty
• 36 WaitForAttributeToBe
• 37 WaitForAttributeToBeEmpty
• 38 WaitForChildElement
• 39 WaitForClickability
• 40 WaitForExistence
• 41 WaitForInnerTextContains
• 42 WaitForInnerTextMatchesPattern
• 43 WaitForInnerTextNotContains
• 44 WaitForInnerTextNotToBe
• 45 WaitForInnerTextToBe
• 46 WaitForInvisibility
• 47 WaitForNonClickability
• 48 WaitForNonExistence
• 49 WaitForNumberOfElementsToBe
• 50 WaitForNumberOfElementsToBeLessThan
• 51 WaitForNumberOfElementsToBeMoreThan
• 52 WaitForStaleness
• 53 WaitForVisibility
• 54 ClickAndWait (Deprecated)
• 55 WaitForObject (Deprecated)

DragAndDropToOffset 

This action drags and drops the specified web element at the specified location.  

Input Parameters:

Example:

DragAndDropOffset            "100"              "500"

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:

Example

MouseUp         "5"          "10"

MouseDown

This action simulates left-click at the specified location on the screen.

Input Parameters:

Example:

MouseDown                 "5"           "10"

RightClick

This action right-clicks the specified web element.

Input Parameters:

Example:

RightClick             "3''

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

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameter. 

Example:

ScrollIntoView

SetFocus

This action sets the focus on the specified object.

This action does not have any parameter. 

Example: SetFocus

SetValueAttribute

This action sets the data specified in the 'value' attribute of the object.

Input Parameters:

Example:

SetValueAttribute           "#ff0990"

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:

Example:
StoreChildCount                               "Key"

StoreCSSProperty

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

Input Parameters:

Example:
StoreCSSProperty     "Key"       "display"

StoreExistence

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

Example:
StoreExistence                               "Key"

StoreLocation

This action stores the current location of the object under the specified keys. The key values can be retrieved using the key names. 

Input Parameters:

Example:
StoreLocation        "Height"            "Width"

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:

Example: StorePropertyValue                            "key"                     "text"

StoreSize

This action stores the size of the specified object in terms of height and width. The key values can be retrieved using key names.

Input Parameters:

Example:

StoreSize           "Height"                   "Width"

StoreText

This action stores the text existing inside the specified object under the specified keys. The key values can be retrieved using the key names. 

Input Parameters:

Example:

StoreText        "Key" 

StoreValueAttribute

This action stores the data present in the "value" attribute of the object.

Example:
StoreValueAttribute        "Key"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Example:

VerifyEnability                          "True"

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Example:

VerifyExistence                      "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Example:

VerifyVisibility                      "True"

ClickandChooseOkOnNextConfirmation (Deprecated)

This action handles the alert or confirmation that comes up post clicking the OK button. This action fails if the button is clicked and no alert or confirmation comes up.

This action does not have any parameter.

Example:

ClickandChooseOkOnNextConfirmation

StoreVisibility 

This action stores the visibility status for a web element under the specified key name in the following conditions:

• True: If the web element is visible.

• False: If the web element is not visible.

Input Parameters:

Example: StoreVisibility   "Key"

WaitForAttributeContains

This action waits till the value of the specified attribute changes to the expected partial value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required. 

Input Parameters:

Example:

WaitForAttributeContains      "id"           "we323es"        "5"          "500"     "Key"       "Defect"

WaitForAttributeNotContains

This action waits until the specified attribute's value of the object changes to other than the partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required. 

Input Parameters:

Example:

WaitForAttributeValueContains      "id"           "232waf"        "5"          "500"     "Key"       "Defect"

WaitForAttributeNotToBe

This action waits until the specified attribute's value of the object changes to other than the exact parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Input Parameters:

Example:

WaitForAttributeNotToBe      "id"           "232waf"        "5"          "500"     "Key"       "Defect"

WaitForAttributeNotToBeEmpty

This action waits until the specified attribute's value of the object gets filled with some value. You may specify the timeout and polling interval, if required.

Input Parameters: