Versions Compared

Old Version 15

changes.mady.by.user Dhiraj Chandanshive

Saved on

compared with

New Version 16

changes.mady.by.user Dhiraj Chandanshive

Saved on

Key

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

...

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"

...

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"

...

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. 

JSON.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: 

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

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"]"        ""

End of the execution, this action adds a new node as state and value as CA and California under the node address.

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"

...

Parameter Name

Parameter Description

Mandatory

Data Type

width

Enter the expected width of the window in pixel. 

Yes

String

height

Enter the expected height of the window in pixel. 

Yes

String

Info

This action has some undefined behavior when values provided in the parameter are outside the allowed range depending on the device resolution or browser driver being used.

Example:

SetWindowSize          "1344"             "689"

...

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.StoreCoumnDataOccurrance

...

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.

...