Versions Compared

Old Version 3

changes.mady.by.user Dhiraj Chandanshive

Saved on

compared with

New Version Current

changes.mady.by.user Vrushank Salaskar

Saved on

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.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the URL that you want to open.

Yes

String

Example:

OpenUrl                               "http://www.google.com/ "

...

Parameter Name

Parameter Description

Mandatory

Data Type

String X

The X co-ordinate of the location

Yes

String

String Y

The Y co-ordinate of the location     

 Yes

String

Example: 
 String X = "100" , String Y = "100" . The right-click will occur at the location point (100,100).

...

Parameter Name

Parameter Description

Mandatory

Data Type

String X

The X co-ordinate of the location

Yes

String

String Y

The Y co-ordinate of the location     

 Yes

String

Example:

String X = "100" , String Y = "100" . The scrollbar scrolls to the location point (100 ,100).

...

Parameter Name

Parameter Description

Mandatory

Data Type

key

E

r Enter the key name to store page title.

Yes

String

...

This action selects the window using the URL address or URL pattern specified in the parameters.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

URL

Enter the URL address of the page you want to open.

Yes

String

URL Pattern

Specify whether the URL is patterned or not.
The value of this parameter can be True or False.

No

String

...

Parameter Name

Parameter Description

Mandatory

Data Type

windowName

Enter the name of the window that you want to close.

Yes

String

...

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

Enter the key which you want to press from the key board. 

Yes

String

...

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.

...

The data to be passed here is only ^F. However ^ has a special meaning in QAS, it must be preceded with an escape sequence ~. Hence the data passed is written as ~^F.
Make sure to prefix an escape sequence which is a tilda for the following characters which has a special meaning in Qualitia. The characters are {,}, ^, ~
Example:

  1. Code Block
    If key to be sent is {F1}, enter data as ~{F1~}.
  2. Code Block
    To send {TAB}, enter data as ~{TAB~}.
  3. Code Block
    To send {ENTER}, enter data as ~{ENTER~}.

Use the PressKeys action to send keystrokes to applications that have no automation interface. Most keyboard characters are represented by a single keystroke. Some keyboard characters are made up of combinations of keystrokes (CTRL+SHIFT+HOME, for example). To send a single keyboard character, send the character itself as the string argument. For example, to send the letter x, send the string argument "x".


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

...

This action helps to convert the date and time provided by the user into the expected time zone.

Input Parameters:

Parameter Name

Parameter Description 

Mandatory

Data Type

expectedTimeZoneID

Enter the zone ID in which you want to convert the date and time. Refer to the list below for the complete list of time zones (case-sensitive). 

Yes

String

currentTimeZoneID

Enter the current zone ID in which you are giving the date and time. Refer to the list below for the complete list of time zones (case-sensitive). 

Yes

String

dateTime

Enter the date and time that you want to convert in the expected time zone. 

Yes

String

dateTimeFormat

Enter the format in which you have given date and time format. Refer to the list below for the complete list of supported date and time formats (case-sensitive).

Yes

String

key

Enter the key under which you want to store the date and time of the expected zone. Key value can be retrieved using the key name. 

Yes

String

...

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

...

Example:
To change date from 1st jan 2007 to 15 feb 2007 user can use 2 ways

  1. Increment only the day value
    dayValue = 45, monthValue = 0 , yearValue = 0
    E.g.- ChangeDateAndStore                      "01-01-2007"                 "dd-MM-yyyy"              "45"             "0"               "0"         "key"

  2. Increment the complete date
    dayValue = 14, monthValue = 1 , yearValue = 0
    E.g.- ChangeDateAndStore                      "01-01-2007"                 "dd/MM/yyyy"              "14"             "1"               "0"         "key"

Hence the user can either give the exact end date or can give the no of days, months or years by which the date needs to be changed.

...

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"

...

The file types supported are xml, xls, and txt. The valid extensions are

  1. For text file - .txt

  2. For xml file- .xml

  3. For excel file- .xls

The Qualitia supports querying on the following database types:

...

Perform the following steps:

  1. From the Qualitia client, select the associated project.

  2. Click Settings > Project Configuration > Manage Dependent jar.

  3. Enter the location of DB jar.

  4. Click OK.

Connection to different databases 
1. Mysql: 
a. Driver - "com.mysql.jdbc.Driver" 
b. Connection url - jdbc:mysql://localhost:portNo/databasename?useUnicode=True&characterEncoding=utf8" 
i. Databasename -is the mysql database to which the user wishes to connect 

2. Oracle: 
a. Driver - "oracle.jdbc.driver.OracleDriver" 
b. Connection url - "jdbc:oracle:thin:@servername or ip:portNo:Databasename" 
i. Servername -is the name of the server .If the server is on local system, the server name is localhost. If the server is on remote system, the ip address of the remote server can be used. 
ii. portNo – is the port which shall listen the database connections. The default port for oracle is 1521. If the user has configured a specific port for listening, then that port number should be used here. 
iii. Databasename is the oracle database to which the user wishes to connect 

3. SQLServer: 
a. Driver - "com.microsoft.sqlserver.jdbc.SQLServerDriver" 
b. Connection url - "jdbc:sqlserver://servername/ip:port;database=databasename;" 
i. Servername -is the name of the server .If the server is on local system, the server name is localhost. If the server is on remote system, the ip address of the remote server can be used. 
ii. portNo – is the port which shall listen the database connections. The default port for oracle is 1433. If the user has configured a specific port for listening, then that port number should be used here. 
iii. Databasename is the sql server database to which the user wishes to connect 

4. MSAccess using dsn: 
a. Driver - "sun.jdbc.odbc.JdbcOdbcDriver" 
b. Connection url - "jdbc:odbc:dsn_name 
i. dsn_name -is the name of the dsn configured on the system . If multiple users are accessing the same dsn, then it needs to be configured on a shared path instead of local system path.

...

This action compares the database results in two files and displays only the difference in an Microsoft or a kingsoft Excel sheet. A link is generated in the log file. On clicking the link, the excel sheet opens in which the difference in the data is displayed. This action compares the following file types which contain DB results. These files contain the results after executing the queries using the actions "ExecuteQueryAndStoreInFile" or "StoreTableData". The supported file extension types are : txt, xml and xls.

  1. text and text

  2. text and excel

  3. text and xml

  4. xml and xml

  5. xml and excel

  6. excel and excel

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

sourceFile

Enter the source file to be used for the comparison. 

Yes

String

targetFile

Enter the target file against which you want to compare the source file.

Yes

String

resultFileType

The file type in which the difference between the two results need to be displayed. The file type supported is: 
MSExcel 

No

String

...

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"

...

This action deletes all the cookies that are visible to the current domain. This  This action does not have any parameter. 

...

Example:
AcceptDialogAndStoreMessage                  "AlertMessage"

...

ValidateSyntaxInFile

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

Input Parameters:

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: 

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

...

WriteToBuildProperty

This action reads a JSON file and updates the JSON key value as per the specified parameters and data typewrites a user defined property along with its value to the 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.

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.

propertyName

Property name to be written in qer.properties file

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.

Input Parameters:

...

Parameter Name

...

Parameter Description

...

Mandatory

...

Data Type

...

propertyName

...

Property name to be written in qer.properties file

...

Yes

...

String

...

propertyValue

...

Property value to be written in qer.properties file

...

Yes

...

String

Example:
WriteToBuildProperty             "propertyName"                 "propertyValue"

WindowsAuthenticationLogin

This action is required to add authentication details in the window to log into the application.

...

propertyValue

Property value to be written in qer.properties file

Yes

String

Example:
WriteToBuildProperty             "propertyName"                 "propertyValue"

WindowsAuthenticationLogin

This action is required to add authentication details in the window to log into the application.

Info

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.

...

This action sets the page load timeout when executing test cases. The time set here overrides the Page Timeout set in the associatedInput Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

timeoutinSeconds

Enter the expected timeout to load the page.  

Yes

String

...

This action stores the source of the page under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

keyPageSource

Enter the key name to store the page source in.   

Yes

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

...

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 requireduse polling interval and timeout, if required.

Info

  • 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

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.

...

Parameter Name

Parameter Description

Mandatory

Data Type

JavaScriptString

Enter the JavaScript code to run. 

NoYes

String

timeOut

Enter the timeout (in seconds) to wait for the exception. 

No

String

pollingInterval

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

No

String

keyJSThrowsExceptionStatus

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

...

Parameter Name

Parameter Description

Mandatory

Data Type

Inputdate

Enter the date whose format you want to change.

Yes

String

Interval

Enter the value for the format you want to update the date into. Value for this parameter can be as follows:

  • 0 – Converts current date into mm/dd/yy and time (if specified) into hh:mm:ss PM/AM.

  • 1 – Converts current date into weekday, monthname, year format.

  • 2 – Converts current date into mm/dd/yy format.

  • 3 – Converts current time into hh:mm:ss PM/AM format4 - Converts current time into hh:mm formatinto hh:mm:ss PM/AM format

  • 4 - Converts current time into hh:mm format.

Yes

String

Key

Enter the key name under which you want to store the modified date. The key value can be retrieved using the key name.

Yes

String

Example:

Date.ChangeDateFormat           “02/28/2021”     “1”    “Key”

Post execution, Key is stored in the new modified date format to Sunday, February 28, 2021.

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

Locator of an element to be dragged.

Yes

String

dragLocatorType

Locator type of the element to be dragged.

Yes

String

dropToLocator

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

Yes

String

Key

dropToLocatorType

Enter the key name under which you want to store the modified date. The key value can be retrieved using the key name

Locator type of the element where the element will be dragged.

Yes

String

Example:

Date.ChangeDateFormatDragAndDropToObject                    “02"//28/2021”     “1”    “Key”Post execution, Key is stored in the new modified date format to Sunday, February 28, 2021.div/img[@alt='abx']" "xpath" "abc" "id"

DragAndDropWithDelay

This action performs the drag and drop using various actions in Selenium’s Actions class with a delay between every action. Sometimes there is a delay on sites, which prevents any events from being fired by mistake. To perform the drag and drop and action we need to add this delay in our action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

DragLocator

dragLocator

Enter the dragLocator

Locator value that can be used to find the element to be dragged.

Yes

String

DragLocatorType

dragLocatorType

Locator type of the element to be dragged.

Yes

String

DropToLocator

dropToLocator

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

Yes

String

DropToLocatorType

dropToLocatorType

Locator type of the element where the element will be dragged.

Yes

String

DelayInAction

delayInAction

Enter the integer value to add the required delay in actions. It is in milliseconds.

Yes

String

Example:

DragAndDropWithDelay                   "//div/img[@alt='abx']" "xpath" "abc" "id" “10”

...

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

Excel.

...

StoreColumnDataOccurrance

This action stores the occurrence of the specific value into the specified column.

...

Parameter Name

Parameter Description

Mandatory

Data Type

filePath

Enter absolute path to the Excel file.

Yes

String

sheetname

Enter the sheet name from the Excel file in which you want to check for the data.

Yes

String

ColumnNumber

Enter the column ID or column name in which you want to add the value in the following format.
- Column ID either can be an index number of the column or column header (mentioned at the top of each column, starts from the letter A). For example: to specify 2nd column, use col::2 or col::B
- Column name: Enter the name of the column from which you want to store the value. This name is provided by the user while adding data.

Yes

String

ignoreBlankColumn

Specify whether you want to ignore the blank columns while calculation.

  • Enter True to ignore blank columns.

    • Enter False to consider even blank columns

    Data

    Enter the data in the specified Excel row. In case you are statically creating an array, values should be separated by caret (^).

    Yes

    String

    Key

    Enter the key name under which you want to store the occurrence.

    Yes

    String

    ...

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    File1

    Enter the absolute path to the source file from which you want to compare the content.

    Yes

    String

    File2

    Enter the absolute path to the target file with which you want to compare the source file content.

    Yes

    String

    CaseSensitive

    Enter whether you want to consider case-sensitivity when comparing content. Value for this parameter can be True or False.

    • Set True for case-sensitive comparison.

    • Set False for case-insensitive comparison.

    Yes

    String

    IgnoreWhitespace

    Enter whether you want to consider whitespaces when comparing file contents. Value for this parameter can be True or False.

    • Set True if you want to consider whitespaces.

    • Set False if you want to ignore whitespaces.

    Note: Only leading and trailing whitespaces will be ignored if you set this parameter to True. Whitespaces inside the content will not be considered.

    Yes

    Boolean

    Example:

    File.CompareFileContents                  “C:\Users\admin\Downloads\Cust_Info.txt”               “C:\Users\admin\Downloads\Client_list.txt”        “False”       “True”

    ...

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    FilePath

    Enter the absolute path to the file from which you want to store characters.

    Yes

    String

    Key

    Enter the key name in which you want to store the character count.

    Yes

    String

    IgnoreWhitespace

    Enter whether you want to consider whitespaces when storing character count. Value for this parameter can be True or False.

    • Set True if you do not want to consider tabs and spaces as characters.

    • Set False if you want to consider tabs and spaces as characters.

    Note: A space or a tab is counted as one character.

    Yes

    String

    Example:

    FILE.StoreCharacterCount        “C:\Users\admin\Downloads\Cust_Info.txt”        “Key”       “True”

    ...

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    FilePath

    Enter the absolute path to the file from which you want to store data.

    Yes

    String

    RowNumber

    Enter the row number from which you want to get and store the data.

    Yes

    String

    Key

    Enter the key name in which you want to store the data.  

    Yes

    String

    Example:

    FILE.StoreStringByLineNumber        “C:\Users\admin\Downloads\Cust_Info”     “2”    “Key”

    ...

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    FilePath

    Enter the absolute path to the file in which you want to verify data.

    Yes

    String

    Data

    Enter the data which you want to verify in the file.

    Yes

    String

    CaseSensitive

    Enter whether you want to consider case-sensitivity when verifying data. Value for this parameter can be True or False.

    • Set True for case-sensitive comparison.

    • Set False for case-insensitive comparison. 

    Yes

    String

    Example:

    FILE.VerifyStringExistInFile       “C:\Users\admin\Downloads\Cust_Info”     “Qualitia”    “True”

    ...

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    FilePath

    Enter the absolute path to the file which you want to verify.

    Yes

    String

    Example:

    File.VerifyFileExist        “C:\Users\admin\Downloads\Cust_List.txt”

    ...

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    FolderPath

    Enter the path to the folder which you want to verify.

    Yes

    String

    Example:

    File.VerifyFolderExist        “C:\Users\admin\Downloads\Cust_Info”

    ...

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    array data

    The array to be verified for ascending or descending order.
    The list of data provided should be carat(^) separated.

    Yes

    Array

    datatype

    This is the type of data considered for testing. Supported data types are
    STRING : These are combination of alphanumeric and special characters items. 
    INTEGER : These are strictly numerical items.

    Yes

    String-

    direction

    The way the data are to be sorted, i.e. in either ascending or descending. Supported directions are:
    1=indicates ascending
    2=indicates descending

    Yes

    String


    Example:
    IsArraySorted                  "0^1^4^10"               "Integer"             "1"

    ...

    Before executing this action, ensure you:

    1. Download XPDF Tools and

    2. Add XPDF tools directory to system path environment variables.

    Input Parameters:

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    pdfFile

    Enter the absolute path to the PDF file in which you want to find the text.

    Yes

    String

    textToFind

    Enter the text you want to find in the specified PDF file.

    Yes

    String

    Example:

    PDF.VerifyStringExistInPDF   “C:\Users\Qualitia\Cust_List.pdf”      “Qualitia”

    ...

    Before executing this action, ensure you:

    1. Download XPDF Tools and

    2. Add XPDF tools directory to system path environment variables.

    Input Parameters:

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    pdfFile

    Enter the absolute path to the PDF file in which you want to find the text.

    Yes

    String

    textToFind

    Enter the text you want to find in the specified PDF file.

    Yes

    String

    pageNumber

    Enter the page number on which you want to search the specified text.

    Yes

    String

    Example:

    PDF.VerifyStringExistInPDFPage   “C:\Users\Qualitia\Cust_List.pdf”      “Qualitia”       “2”

    ...

    Before executing this action, ensure you:

    1. Download XPDF Tools and

    2. Download and install GnuWin

    3. Add XPDF Tools and GnuWin installation directory to system path environment variables.
      For example: D:\XPDF\xpdf-tools-win-4.00;C:\Program Files (x86)\GnuWin32\bin

    Input Parameters:

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    Pdf1

    Enter the absolute path to the PDF file which you want to compare.

    Yes

    String

    Pdf2

    Enter the absolute path to the PDF file with which you want to compare the source file.

    Yes

    String

    diffFilePath

    Enter the absolute path to the text file in which you want to store the PDF comparison results.

    Yes

    String

    Example:

    PDF.ComparePDF   “C:\Users\Qualitia\Cust_List.pdf”      “C:\Users\Qualitia\Client_List.pdf”    “C:\Users\Qualitia\Diff.txt”

    ...

    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.

    ...

    WaitforAlertandStoreAcceptIfexist     “10“     “AlertMessage”

    WriteToTextFile

    This action allows users to write or append the text in the specified file.

    Info

    User performing this action should have write access to the corresponding file and folder.

    Input Parameters:

    Parameter Name

    Parameter Description

    Mandatory

    Data Type

    FilePath

    Enter the absolute path to the file in which you want to make changes.

    Yes

    String

    Text

    Enter the content to be overwritten or appended.

    Yes

    String

    Mode

    Value of this parameter can be OVERWRITE or APPEND. If user keeps mode empty, it will be considered as append.

    Yes

    String

    Example:
    WriteToTextFile                  "C:\Users\Notepad.txt"          "Qualitia"            "A