Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ComparetwoInt  “123“  “ 234”

DragAndDropToObject

This action drags the specified object and drops it in the position of another specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

dragLocator

Enter the locator value of an element to be dragged.

Yes

String

dragLocatorType

Enter the locator type of the element to be dragged.

Yes

String

dropToLocator

Enter the locator of an element whose location (i.e., whose centre-most pixel) will be the point where dragLocator is dropped.

Yes

String

dropToLocatorType

Enter the locator type of the element where the element will be dragged.

Yes

String

Example:
DragAndDropToObject                   "//div/img[@alt='abx']"            "xpath"           "abc"        "id"

OpenURL

This action opens the specified URL in the browser selected in the associated execution profile.

...

The action returns 0, if the key is pressed successfully else it will return 1 in any other case. 

Note: If a PressKeys action does not execute on an Inactive Screen, refer to PressKeys Action does not Execute on an Inactive Screen.

...


You can use PressKeys to send more than one keystroke at a time. To do this, create a compound string argument that represents a sequence of keystrokes by appending each keystroke in the sequence to the one before it. For example, to send the keystrokes a, b, and c, you need to send as "abc". The PressKeys method uses some characters as modifiers of characters (instead of using their face-values). This set of special characters consists of parentheses, brackets, braces, and the:

  • plus sign       "~{+~}",

  • caret             "^", (use with an escape character [~])

  • percent sign "%"

  • tilde       "~"

...

Info

You can create your own combinations and formats using the patterns mentioned here. These patterns mentioned herein are case-sensitive such as entering as dd-mm-yyyy instead of dd-MM-yyyy will result in wrong output. Ensure that you use them in a correct way in order to achieve the desired output. 

...

Here the CompareString action shall retrieve the value for the key (here Cancel) and compare it with the expected (here Cancel) with case sensitive comparison as True. The action will return 0, if the strings match else it will return 2 if the strings do not match. It will return 1 in any other case (like an error).

PrintMessageinReport

This action helps you to print the desired message in Qualitia test case execution report. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

message

Enter the desired message you want to print into the Qualitia test case execution report.

Yes

String

status

Values for this parameter can be Pass, Fail, Passed, Failed, Defect, and NotExecuted.

Note: The value is not case-sensitive.

No

String

...

Parameter Name

Parameter Description

Mandatory

Data Type

fileInputlocator

Enter the locator of the input box where the file is to be selected.

Yes

String

locatorType

Enter the type of locator used for the locator of the file input object. 
This could be Id, xpath, name, CSS.

Yes

 String

filePath

Enter the absolute or relative path of the file. 

Yes

String

Example:

AttachFile                    "fileBox"                "id"                 "c:/Folder/test.txt"

...

Example
ExecuteQueryAndStoreInFile "oracle.jdbc.driver.OracleDriver" "jdbc:oracle:thin:@localhost:1521:orcl" "scott" "tiger" "select * from test_table where id = 100" "C:\DBResults\XML\ORACLE\Result.xml"

...

ExecuteQueryAndStoreInKey

This action executes data definitions queries like update, delete and stores the result into a key.

...

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 validate whether the folder exist

Yes

String

Filename

The filename of the downloadable file, to be given in case the user requires to give a specific name and not depend on the default name of the file. In case, the file already exists, similar window like below will appear. Such windows are not handled by the action. In case, the user does not provide this data, the action will pick the default file name available while downloading.

No

String

locator

Enter the locator value.

Yes

String

locatorType

Enter which locator type you want to use. It can be ID, Name, xpath, CSS and so on.

Yes

String


Example:

...


Example  DownloadFile               "C:/ProgramData"           "Qualitia"       "DOWNLOAD SAMPLE DOC FILE"       "Link"

...

Example:
AcceptDialogAndStoreMessage                  "AlertMessage"

...

ValidateSyntaxInFile

This action validates the data given in the specified JSON or XML file.

...

Parameter Name

Parameter Description

Mandatory

Data Types

FilePath

Enter the absolute path to the JSON/XML file on which you want to validate the data.

Yes

String

Example: 

ValidateSyntaxinFile  ValidateSyntaxInFile           "C:\Users\Qualitia\Cust_Details.json" 

End of the execution, if the data from the specified file is valid, action will pass, else action will fail

UpdateValueFromJson

This action reads a JSON file and updates the JSON key value as per the specified parameters and data type.

Input Parameters:

...

Parameter Name

...

Parameter Description

...

Mandatory

...

Data Type 

...

FilePath

...

Enter the absolute file path to the JSON file where you want to add the node.

...

Yes

...

String

...

JSONPath

...

Enter the JSON path where you want to add the new node. 

Use $ if you want to add the node at root level.

...

Yes

...

String

...

JSONValue

...

Enter the value to be added for the JSONValue key.

...

Yes

...

String

...

JSONValueType

...

Specify the data type of the value being added.

Value type can be Boolean or Numeric.

Keep the value type blank if the data type is JSONObject, JSONArray, or String.

...

No 

...

String

Example:

  • Updating single value: 

...

.

...

 

...

This action will update the value of the attribute postalCode of type Numeric to the value given in the parameter (6300194).

  • Updating value from the array: 

.UpdateValueInJson    “C:\Users\Qualitia\Cust_Details.json”        “$[0].address.postalCode”         “6300194”         “ Numeric“

This action will update the value of the attribute postalCode of address at 0th index, type Numeric to the value given in the parameter (6300194).

  • Updating value of type String:

“C:\Users\Qualitia\Cust_Details.json”        “$.address”         “StateCode”        "["CA" , "California"]"        ""

...

WriteToBuildProperty

This action writes a user defined property along with its value to qer.properties file. This customized information can be used in email notifications sent by Jenkins provided all the required email specific settings are done there in Jenkins.

...

StorePageSource             "PageSource"

StoreWindowHandleAtIndex

This action fetches the handle (identifier) of the specified window in the index and stores under the specified key.  This key can the be used in action like SelectPage and ClosePopupBrowser to work on the specific page. This action can be used when the name of the window on which user needs to work on is not known.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

Enter the key name to store the window handle.

Yes

String

index

Enter the index of the page whose handle you want to store.

Yes

String

Example : 

StoreWindowHandleAtIndex              "Key"                   "4"

SwitchWebExecutionPlatform

...

WaitForNumberofWindowsToBe

This action waits until the number of open windows reaches the count specified in the parameter. You may use polling interval and timeout, if required.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expectedNumber

Enter expected number of windows.   

No

String

timeOut

Enter the timeout (in seconds) to wait. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check whether the specified count has reached. 

No

String

keyNumOfWindows

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForNumberOfWindowsToBe       "3"         "10"      "500"       "Key"     "Defect"

...

StoreWindowSize          "Height"             "Width"

SetWindowPosition

This action sets the position of the console window as per the specified position.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

xPosition

Enter the x coordinate of the position to set.

Yes

String

yPosition

Enter the y coordinate of the position to set.

Yes

String

...

This action runs the parameterized JavaScript code until it returns the value. You may specify the timeout and polling interval, if required.

...

This action runs the parameterized JavaScript code until it throws the execption. You may specify the timeout and polling interval, if required.

...

This action waits for the web page title to contain expected partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.

Input Parameters: 

Parameter Name

Parameter Description

Mandatory

Data Type

title

Enter the expected partial value of the web page title.

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyTitleContains

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the web page title 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:

Parameter Name

Parameter Description

Mandatory

Data Type

title

Enter the expected partial value which should not be in the web page title. 

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyTitleNotContains

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits for the web page title to contain exact expected parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.

Input Parameters: 

Parameter Name

Parameter Description

Mandatory

Data Type

title

Enter the expected exact value of the web page title.

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyTitleToBe

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the web page title changes to other than the parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

title

Enter the expected exact value which should not be in the web page title. 

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyTitleNotToBe

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits for the web page URL to contain expected partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the expected partial value of the web page URL. 

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyURLContains

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the web page URL 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:

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the expected partial value which should not be in the web page URL. 

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyURLNotContains

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits for the web page URL to contain exact expected parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the expected the web page URL. 

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected URL. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected URL before exhausting timeout. 

No

String

keyURLToBe

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the specified web page URL value changes to other than the parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the URL which should not be the web page URL.

No

String

timeOut

Enter the timeout (in seconds) to wait for the URL to change. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the URL before exhausting timeout. 

No

String

keyURLNotToBe

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the specified web page URL value changes to the parameterized regular expression pattern. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

urlRegx

Enter the expected pattern for the URL. Pattern should be regular expression. Step fails in case the pattern is invalid.

No

String

timeOut

Enter the timeout (in seconds) to wait for the URL to change. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the URL before exhausting timeout. 

No

String

keyURLPattern 

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

StorePageSource             "PageSource"

StoreWindowHandleAtIndex

This action fetches the handle (identifier) of the specified window in the index and stores under the specified key.  This key can the be used in action like SelectPage and ClosePopupBrowser to work on the specific page. This action can be used when the name of the window on which user needs to work on is not known.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

Enter the key name to store the window handle.

Yes

String

index

Enter the index of the page whose handle you want to store.

Yes

String

Example : 

StoreWindowHandleAtIndex              "Key"                   "4"

SwitchWebExecutionPlatform

...

StoreWindowSize          "Height"             "Width"

SetWindowPosition

This action sets the position of the console window as per the specified position.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

xPosition

Enter the x coordinate of the position to set.

Yes

String

yPosition

Enter the y coordinate of the position to set.

Yes

String

...

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which you want to store the specified number of characters.

Yes

String

InputString

Enter the input string from which you want to store the characters.

Yes

String

Length

Specify the number of characters you want to store under the key name. Enter 0 if you want to store an empty string.

Yes

String

Example:

StoreStringFromLeft     "Key"  "John Doe"    "4"    

In this case, this action stores the value of Key as John.

StoreSqRoot

This action stores the square root of the specified number under the key. The stored key value can be retrieved using the key name.

...

Excel.StoreRowCount       “Key”    “D:\TrainingStatus.xlsx”       “Sheet1”    “True”

Excel.StoreColumnDataOccurrance

...

WaitForNumberofWindowsToBe

This action waits until the number of open windows reaches the count specified in the parameter. You may use polling interval and timeout, if required.

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

...

Parameter Name

Parameter Description

Mandatory

Data Type

expectedNumber

Enter expected number of windows.   

No

String

timeOut

Enter the timeout (in seconds) to wait. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check whether the specified count has reached. 

No

String

keyNumOfWindows

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

Example:

WaitForNumberOfWindowsToBe       "3"         "10"      "500"       "Key"     "Defect"

...

This action runs the parameterized JavaScript code until it returns the value. You may specify the timeout and polling interval, if required.

...

This action runs the parameterized JavaScript code until it throws the execption. You may specify the timeout and polling interval, if required.

...

This action waits for the web page title to contain expected partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.

Input Parameters: 

Parameter Name

Parameter Description

Mandatory

Data Type

title

Enter the expected partial value of the web page title.

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyTitleContains

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the web page title changes to other than the partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

...

This action waits for the web page title to contain exact expected parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

Input Parameters: 

Parameter Name

Parameter Description

Mandatory

Data Type

title

Enter the expected exact value of the web page title.

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected value. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. 

No

String

keyTitleToBe

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the web page title changes to other than the parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

...

This action waits for the web page URL to contain expected partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

...

This action waits until the web page URL changes to other than the partial parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

...

This action waits for the web page URL to contain exact expected parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the expected the web page URL. 

No

String

timeOut

Enter the timeout (in seconds) to wait for the expected URL. 

No

String

pollingInterval

Enter the frequency (in milliseconds) after which you want to check for existence of the expected URL before exhausting timeout. 

No

String

keyURLToBe

Enter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.

No

String

statusIfConditionNotSatisfied

Enter the status of the step you want to show in the report in case the expected condition is not satisfied. value for this parameter can be Pass, Fail, and Defect.

No

String

...

This action waits until the specified web page URL value changes to other than the parameterized value. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

...

This action waits until the specified web page URL value changes to the parameterized regular expression pattern. This comparison is case-sensitive. You may specify the timeout and polling interval, if required.  

Info

Note:

  • For the WaitFor actions to complete successfully, the specified object must exist.

  • Only for all the Wait actions, you can override the actual execution result with that of your choice using the statusIfConditionNotSatisfied parameter. For example, if you set the statusIfConditionNotSatisfied parameter to Pass, the action execution result will always be Pass, irrespective of whether the actual execution result was Fail or Defect.

...