Document toolboxDocument toolbox

Header

(8.6.X) General Web Actions

Owned by Dhiraj Chandanshive (Unlicensed)
Last updated: Jan 05, 2023 by Vrushank Salaskar
76 min read

Clipboard.Copy

This action copies the data given into the parameter to clipboard.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Text

Enter the text to add to the clipboard memory.

Yes

String

Example:

Clipboard.Copy            "Qualitia Software Pvt. Ltd."

Clipboard.Clear

This action clears the data present on the clipboard memory.

This action does not have any input parameters.

Example:

Clipboard.Clear

CloseCurrentWindow

This action will close current window.  

This action does not have any parameter.

Example:
 CloseCurrentWindow

CheckExcelProcess

This action will check if the excel process is running.

This action does not have any parameter.

Description: It will pass if the excel process is running on your system. Otherwise, it will fail.

Example:

CheckExcelProcess

ConcatString

This action will concatenate the two strings and stores result string into a variable. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

str1

First string for concatenation

No

String

str2

Second string for concatenation

No

String

Key

Key name under which the result of concatenation will be stored. 

No

String

Example:

ConcatString  “Hello “ “World” “Result”

ComparetwoStrings (Deprecated)

This action will compare two string values. As it is deprecated, Qualitia recommends to use CompareString.

 Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Str1

First string for comparison

No

String

Str2

Second string for comparison 

No

String

Example:

ComparetwoString  “hello“  “ hello”

ComparetwoInt

This action compares two integer numbers. Even a key can be passed as one of the parameters for comparison where the ComparetwoInt function will retrieve the value from the key and that value will be compared with another integer.

 Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

int1

First integer value for comparison 

No

String

int2

Second integer value for comparison

 No

String

Example:

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

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

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the URL that you want to open.

Yes

String

Example:

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

 

When using this action in Desktop projects, Qualitia defines its own set of system variables which can be used later when executing test cases. These variables are stored in Qualitia with their expressions (True or FALSE). Following is the list of system variables that Qualitia stores when executing the OpenURL action.

  • $$_ISIE: If browser type is set as IE (Internet Explorer), then this expression is stored as True. Here, other two ($$_ISFIREFOX and $$_ISCHROME) are stored as FALSE.

  • $$_ISFIREFOX: If browser type is set as FIREFOX (Mozilla Firefox), then this expression is stored as True. Here, other two ($$_ISIE and $$_ISCHROME) are stored as FALSE.

  • $$_ISCHROME: If browser type is set as CHROME (Google Chrome), then this expression is stored as True. Here, other two ($$_ISFIREFOX and $$_IE) are stored as FALSE.

Note: It is recommended to close all the unnecessary browsers before starting the test execution or object spying using UFT.

NavigateForward

This action navigates the browser to the next page.

This action does not have any parameter.

Example:

NavigateForward

NavigateBack

This action navigates the browser to the previous page.

This action does not have any parameter.

Example:

NavigateBack

RandomString

This action takes input as list of characters from user and gives random string as output of a specified length.

For example, if the string is "RTFTF" and length is "10", then it randomly generates a string as "RTFTTFRTFR".  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

CharacterList

The string given as input could be alphabetic, alphanumeric or numeric.

No

String

Length

The length of the random string to be generated.

No

String

strKey

The value of the random string is stored in strKey

No

String

Example:

RandomString  "32#$abd "            "12"      “abc”

ReplaceStringBySubString

This action replaces the specified part from the string with another string and stores the updated value into the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name in which you want to store the updated string.

Yes

String

inputString

Enter the string that you want to replace.

Yes

String

Find

Enter the part of the string that need to be replaced.

Yes

String

Replacewith

Enter the replacement text for the first string.

Yes

String

Start

Enter the start position. Default is 1. All characters before the start position will be removed.

No

String

count

Enter the number of substitutions to perform. Default is -1, which makes all possible substitutions.

No

String

Case Sensitive

Enter whether you want to consider case-sensitivity when comparing the string before replacement. Value for this parameter can be 0 or 1.

  • Set 0 for case-insensitive comparison.

  • Set 1 for case-sensitive comparison.

No

String

Example:

ReplaceStringBySubString          "Key"           "Australia"       "A"         "B"        "1"         "-1"        "1"

In this case,  the string Australia changes to Bustralia.

ReplaceAndStoreText

This action replaces a substring by another substring into a source string and stores the resulting string in the given key.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

SourceText

The complete path of the file to be executed.

No

String

TextToBeReplaced

Substring that is to be replaced from the SourceText.

No

String

TextToBeReplacedBy

Substring by which replacement is to be done.

No

String

IsCaseSensitive

Indicates case sensitive.

Yes

String

Key

Key in which final output will be stored.

Yes

String

Example:

ReplaceAndStoreText              "India"          "i"               "Z"          "True"         "key1"

The result string will be IndZa.

ReplaceSubString

This action replaces a substring of an original string with a specified string.

For example, if a string is "WELCOMEWELCOME" and if you want to replace the second occurence of the substring "come" with gone". Then, the new string generated is 'WELCOMEWELGONE".

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

MainString

The original string.

Yes

String

SubString

The substring of the original string.

Yes

String

 

ReplaceString

The new string with which the substring is to be replaced.

Yes

String

 

Soccurrence

The number of times the substring occurs in the original string.

Yes

String

 

Key

 

The resultant value is stored in the Key.

 

Yes

String

iscasesenstive

Enter as True if you want to replace only when the case of letters of specified occurrence and substring matches.

Enter as False if you want to replace irrespective of whether the case of letters of the specified occurrence and substring matches.

Note: The default value is True.

Yes 

 String

Example

ReplaceSubString “welcome” “come”  “gone”  “1”  "True" “abc”

RandomNumber

This action takes lower and upper limit of a range as integer input and gives an output of a random integer number within that range.

 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

min

The string stores the lower limit of the range.

No

String

max

The string stores the upper limit of the range.

No

String

strKey

The value of the random number is stored in strKey.

No

String

Example

RandomNumber  "1"   "100"      

StorePageURL

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the key name to store URL.

Yes

String

Example:

StorePageURL                   "Key"

RightClickTo(String X , String Y)

 

This action right-clicks at a definite location of the web page as specified by x and y coordinates. You cannot specify negative values to X and Y.

Parameter Name

Parameter Description

Mandatory

Data Type

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

ScrollTo(String X , String Y)

This action scrolls the Scrollbar of the web page to a definite location specified by x and y coordinates. You cannot specify negative values to X and Y.

Parameter Name

Parameter Description

Mandatory

Data Type

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

StoreFixNumber

This action stores the integer part of a specified number into the specified key. The stored key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name in which you want to store the updated string.

Yes

String

Number

Enter the number from which you want to store the integer part.

Yes

String

Example:

StoreFixNumber           "Key"              "6.4332"

In this case, the variable Key stores the value to 6.

StorePageTitle

This action stores the web page title under the specified key. The stored value can be retrieved using the key name. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the key name to store page title.

Yes

String

Example:

StorePageTitle                   "Key"

StoreVariable

This action stores a particular string value under the specified key. This value can be used when developing test cases.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the key name to store variable.

Yes

String

data

Enter the value to be stored under the key name.

No

String

Example:

StoreVariable                   "url"                     "http://www.bing.com/ "  

SecureStoreVariable

This action stores the specified value securely by encrypting it under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable under which the string data is to be stored.

Yes

String

data

Enter the data to be stored in encrypted mode.

No

String

Example:

SecureStoreVariable              "Password"                               "Encrypt(Abc)"

When the focus is moved away from the data ABC, Qualitia will automatically encrypt the text to "vHpmlfI4R3PQJskt3nuqw==þNWE3ZDdkNjE3N2JmNDM2ODgxMzQwYWI1MTA3YWNjMDc="

CalculateDifferenceInDateAndStore

This action calculates the difference between two specified dates as per the number of days. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

startDate

Enter the start date, that is, the date which is lesser.

Yes

String

startFormat

Enter the start date's date format.

Yes

String

endDate

Enter the end date, that is, the date which is greater.

Yes

String

endFormat

Enter the end date's date format.

Yes

String

Key

Enter a key to store the the difference in date as per the number of days.

  Yes

String

 Interval: The interval parameter can have the following values:

Example:
CalculateDifferenceInDateAndStore      "Key"            "D"        "01-Jan-2021"      "28-Feb-2021"

Sleep

This action adds the delay during execution for the given period of time (in seconds).

This action can be used when a particular action takes some time for execution. For instance, after performing an OpenUrl action, some amount of wait can be given till the URL is opened completely.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

seconds

Enter the number of seconds for which you want to wait. 

The default value is 2.

No

String

Example:
Sleep                   "20"

SelectPage

This action helps Qualitia users to move focus from one window/page to another as per the test case requirements. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

windowName

Enter the name of the window which you want to select. You may use "NULL" to select the main window.

No

String

Example:

Select Page                            "Name"

SelectWindowUsingURL

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

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

While executing a test case or test suite that uses the SelectWindowUsingURL action on a mobile web application, you must enter the appropriate values in UDID and Device Name in the associated execution profile.

Example:

SelectWindowUsingURL                      "www.google.com"                    "False"

ClosePopUpBrowser

This action closes the popup that appears on the web page. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

windowName

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

Yes

String

Example:
ClosePopUpBrowser                   "viewPage"

PressKeys

This action sends one or more keystrokes to the active window (as if typed on the keyboard).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

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

Yes

String

Example:

To open the Find dialog on the browser, which is done manually using Ctrl + F.  While using the PressKeys action, the data to be passed is ~^F where ^ means Control. See the list below for the keys and their meaning).

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.

Important Note:

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. If key to be sent is {F1}, enter data as ~{F1~}.
  2. To send {TAB}, enter data as ~{TAB~}.
  3. 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       "~"

Enter these characters by enclosing them within braces "{}". For example, to enter the plus sign, enter the string argument "{+}". Brackets "[ ]" have no special meaning when used with PressKeys, but you must enclose them within braces to accommodate applications that do give them a special meaning (for dynamic data exchange (DDE) for example).

  • To send bracket characters, enter the string argument "{[}" for the left bracket and "{]}" for the right one.

  • To send brace characters, enter the string argument "}" for the left brace and "{" for the right one.

  • To send a key combination that includes Ctrl key such as Ctrl + N send "~^n"

Some keystrokes do not generate characters (such as ENTER and TAB). Some keystrokes represent actions (such as BACKSPACE and BREAK). To send these kinds of keystrokes, enter the associated arguments as shown in the following table:

Key

Argument

Key

Argument

BACKSPACE

~{BACKSPACE~}, ~{BS~}, or ~{BKSP~}

BREAK

~{BREAK~}

CAPS LOCK

 ~{CAPSLOCK~}

DEL or DELETE

~{DELETE~} or ~{DEL~}

DOWN ARROW

~{DOWN~}

END

~{END~}

ENTER

~{ENTER~} or ~

ESC

~{ESC~}

HELP

~{HELP~}

HOME

~{HOME~}

INS or INSERT

~{INSERT~} or ~{INS~}

LEFT ARROW

~{LEFT~}

NUM LOCK

~{NUMLOCK~}

PAGE DOWN

~{PGDN~}

PAGE UP

~{PGUP~}

RIGHT ARROW

~{RIGHT~}

SCROLL LOCK

~{SCROLLLOCK~}

TAB

~{TAB~}

UP ARROW

~{UP~}

F1

~{F1~}

F2

~{F2~}

F3

~{F3~}

F4

~{F4~}

F5

~{F5~}

F6

~{F6~}

F7

~{F7~}

F8

~{F8~}

F9

~{F9~}

F10

~{F10~}

F11

~{F11~}

F12

~{F12~}

F13

~{F13~}

F14

~{F14~}

F15

~{F15~}

F16

~{F16~}

 

The PressKeys action is not tested on the F13 to F16 keys, which are generally not present on the keyboard.

To send keyboard characters that are comprised of a regular keystroke in combination with a SHIFT, CTRL, or ALT, create a compound string argument that represents the keystroke combination. You can do it by preceding the regular keystroke with one or more of the following special characters:

Key

Arguments

Key

Arguments

Shift

~+

Ctrl

~^

Alt

~%

 When used this way, these special characters are not enclosed within a set of braces.

To specify that a combination of SHIFT, CTRL, and ALT should be held down while several other keys are pressed, create a compound string argument with the modified keystrokes enclosed in parentheses. For example, to send the keystroke combination that specifies that the SHIFT key is held down while:

  • e and c are pressed, enter the string argument "+(ec)".

  • e is pressed, followed by a lone c (with no SHIFT), enter the string argument "+ec".

You can use the PressKeys action to send a pattern of keystrokes that consists of a single keystroke pressed several times in a row. To do this, create a compound string argument that specifies the keystroke you want to repeat, followed by the number of times you want it repeated. To do this, use a compound string argument of the form {keystroke number}. For example, to send the letter "x" ten times, you would send the string argument "~{x 10~}" where you need to ensure that you enter a space between keystroke and number.

  • The only keystroke pattern you can send is the kind that is comprised of a single keystroke pressed several times. For example, you can send "x" ten times, but you cannot do the same for "Ctrl+x".

  • You cannot automate the PRINT SCREEN key ~{PRTSC~} to an application.

  • To send a space, enter the string " ".

StoreDateTimeByZone

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

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

Example:

StoreDateTimeByZone          “EST”         “IST”      “2018-09-23 12:34:44”          “yyyy-mm-dd hh:mm:ss”       “ESTTime”

  • Result:

End of the execution, this action converts the given time into the expected time zone and stores it in under the key: ESTTime.

List of Zone IDs:

Here is the complete list of supported Zone IDs and their descriptions. Please note that these Zone IDs mentioned herein is case-sensitive and should be used in the upper case only.

ZoneID

Description

ZoneID

Description

EST

Eastern Standard Time 

HST

Hawaii Standard Time 

MST

Malaysia Standard Time 

ACT

Australia/Darwin

AET

Australia/Sydney 

AGT

America/Argentina/Buenos_Aires 

ART

Africa/Cairo

AST

America/Anchorage 

BET

America/Sao_Paulo

BST

Asia/Dhaka 

CAT

Africa/Harare

CNT

America/St_Johns 

CST

America/Chicago

CTT

Asia/Shanghai 

EAT

Africa/Addis_Ababa 

ECT

Europe/Paris

IET

America/Indiana/Indianapolis

IST

Asia/Kolkata

JST

Asia/Tokyo 

MIT

Pacific/Apia 

NET

Asia/Yerevan 

NST

Pacific/Auckland 

PLT

Asia/Karachi 

PNT

America/Phoenix

PRT

America/Puerto_Rico 

PST

America/Los_Angeles 

SST

Pacific/Guadalcanal 

VST

Asia/Ho_Chi_Minh 

List of supported dateTimeFormats:

Here is the complete list of date and time formats and their examples. Please note that these date and time formats mentioned herein are case-sensitive and should be used in the same way as mentioned in the table below. 

Date Time Formats 

Examples

Date Time Formats 

Examples

dd-MM-yy 

31-01-12 

dd-MM-yyyy

31-01-2012

MM-dd-yyyy

01-31-2012

yyyy-MM-dd 

2012-01-31

yyyy-MM-dd hh:mm:ss 

2012-01-31 23:59:00 

yyyy-MM-dd hh:mm:ss.SSSZ

2012-01-31 23:59:59.999+0100 

EEEEE MMMMM yyyy HH:mm:ss.SSSZ

Saturday November 2012 10:45:42.720+0100

 

StoreSubStringNew

This action stores a sub string of a string into a variable. The key value can be retrieved using the key name. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the sub-string is to be stored.

Yes

String

sourceString

Enter the string whose sub-string value is to be stored.

No

String

startIndex

Enter the index of the string from where the sub-string is to be fetched.

No

String

endIndex

The number of characters required in the string.

No

String


Example:
StoreSubStringNew                   "resultSubString"            "This is a test"                "2"                  "4"

StoreSubStringFromIndexForLength

The action stores the substring of a string from a specific index up to any number of characters that you want. The indexing starts from 1.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the variable to store the resulted substring.

Yes

String

sourceString

Enter the original string.

Yes

String

startIndex

Enter the index of the character in the original string from where you want to start your substring. The default value is 1.

No

String

length

Enter the number of the characters from the specified startIndex up to which you want to store.

Yes

String

Example:

StoreSubStringFromIndexForLength     "Key"    “Welcome"     “4”      “4”

The variable Key stores the value as come.

StoreStringToInteger

This action converts the provided string to the integer value and stores it into the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name in which you want to store integer value.

Yes

String

Number

Enter the number whose integer value you want to store into the key.

Yes

String

Example:

StoreStringToInteger            "Key"          "20"

StoreStringLength

This action increments the string length by the value specified by the user and stores it into a variable.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

The variable in which the length of the string is to be stored

Yes

String

strMainString

The string whose length is to be stored

No

String

intIncrement

The value by which the length needs to be incremented

No

String

Example:
StoreStringLength                             "length"                      "This is a test"            "3"

CompareString

This action compares two strings without trimming the spaces. The comparison can be either case-sensitive / non case-sensitive. Even a key can be passed as one of the parameters for comparison where the CompareString function will retrieve the value from the key and that value will be compared with expected.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

actualString

Enter the string value that you want to compare. You can pass the key name here enclosed in braces.

No

String

excpectedString

Enter the expected string value against which the actualString will be compared. You can pass the key name here enclosed in braces.

No

String

caseSensitive

Specify the kind of comparison; case-sensitive or case-insensitive.

  • Set True for case-sensitive comparison. 

  • Set False for case-insensitive comparison.
    Note: If you do not specify, by default, True is considered

No

String

 

CompareString           "{key}"           "Cancel"          "True"

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

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:

PrintMessageInReport         "Test case executed successfully without fail."                "Passed"

VerifyStringContainsValue

This action verifies whether a specific substring is present in the main string. Comparison can either be case-sensitive or case-insensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

strMainString

Enter the main string in which you want to search substring. You can pass the key name here enclosed in braces.

No

String

strSubstring

Enter the 2nd string value that you want to search. You can pass the key name here enclosed in braces.

No

String

blnCase

Specify the kind of comparison; case-sensitive or case-insensitive.

  • Set True for case-sensitive comparison.

  • Set False for case-insensitive comparison.

No

String

VerifyStringContainsValue      "{mainStrKey}"                               "the action"              "True"

In this case, the VerifyStringContainsValue action shall retrieve the value for the key mainStrKey and compare it with the expected with case sensitive comparison as True.
The action returns  the following values:

  • PASSED if the substring is found in the main string.

  • DEFECT if the substring is not found in the main string.

  • FAILED if the main string or substring is empty.

Empty and null main string as well as substrings are not  verified by this action.

ComparePattern

This action compares the data passed by user and verifies that it matches the pattern specified by the user.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

pattern

Enter the pattern against which the data specified by the user will be verified.

Yes

String

data

Enter the data which will be matched against the pattern specified by the user.

No

String

caseSensitive

Specify the kind of comparison; case-sensitive or case-insensitive.

  • Set True for case-sensitive comparison.

  • Set False for case-insensitive comparison.

Note: The default value is True.

No

String

Example:
Consider a bank application where on adding a user an account number is generated which is unique and consists of alphanumeric characters. The number of characters in that account number is 10 where the first 5 are alphabets and remaining five are numbers.

Suppose the account number is YuIFp96062. If this has to be verified for the pattern mentioned, we can use the action ComparePattern as follows:

  • strPattern -  [a-z]~{0,5~}[0-9]~{5~}

  • strData –  YuIFp96062

  • blnCase -    False

ComparePattern                 “[a-z]~{0,5~}[0-9]~{5~}“                   "YuIFp96062"                  "false"

Here the ComparePattern action shall verify that data mentioned matched the specified pattern .The action will return 0, if the data matches the specified pattern , else it will return 2 if the data does not match the pattern. In any other case it will return 1.

If the pattern is using Qualitia's special characters like {,},/,^ then they should be prefixed with ~.

Special characters and sequences are used in writing patterns for regular expressions. For a complete list of the regular expression syntax visit the VBScript syntax Guide for Regular Expressions.

CompareSubStringPattern

This action verifies whether a string or any of its substring is defined in the desired pattern that you want.

 

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

strPattern

Enter the desired pattern for the substring. If you want to match the pattern with whole string, then append '^' at the beginning and '$' at the end of the string.

Yes

String

strData

Enter the string that you want to compare with the desired pattern.

Yes

String

caseSensitive

Specify the kind of comparison:

  • Set True for case-sensitive comparison.

  • Set False for case-insensitive comparison.

Note: The default value is True.

No

String

The action returns the following values:

  • PASSED if the string or any of its substring matches with the desired pattern.

  • DEFECT if the string or any of its substring does not match with the desired pattern..

  • FAILED for any other reason, such as when no value is defined for strData or strPattern parameters.

Example:
CompareSubStringPattern [a-z]~{0,5~}[0-9]~{5~} YuIFp96062 True
In this case, the substring 'p96062' matches with the given case-sensitive pattern. Hence, the action will return Pass.

CompareSubStringPattern ~^[a-z]~{0,5~}[0-9]~{5~}$ YuIFp96062 True
In this case, the action matches the complete string with the specified pattern where it does not match. Hence, the action will return Defect.

VerifyDataType

This action verifies if the data type is numeric or string.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

data

Enter the data to verify.

Yes

String

dataType

The data type against which the data is to be verified.
The value of this is
• numeric
• string

Yes

string

Example:

VerifyDataType "4.78" "numeric"
This shall verify if 4.78 is numeric
VerifyDataType "This is a test" "string"
This shall verify if "This is a test" is a string
Anything which is not numeric shall be considered as a string.
Example: "Enter 123", "23/02/20" etc shall be considered as a string.

VerifyDifference

This action verifies the difference between two integer values and validates it with the expected difference value.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Int1

Enter the 1st numerical value to compare. You can pass the key name here enclosed in braces.

No

String

Int2

Enter the 2nd numerical value to compare. You can pass the key name here enclosed in braces.

No

String

expectedDifference

Enter the expected difference between the two numbers.

No

String

Example:
VerifyDifference                       "30"                 "40"               "10"

MaximizeBrowser

This action maximizes the browser.

This action does not have any parameter. 

Example:

MaximizeBrowser

SelectFrame

This action selects a frame within the current window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

locator

Enter the locator using which you want to select the frame. This parameter can have the values of the frame's: ID, Name, Xpath, CSS.

No

String

locatorType

Enter which locator type you want to use. It can be ID, Name, xpath, CSS and so on. In order to come out of all the frames, the parameters passed should be empty.

No

String

Example:

SelectFrame                        "mainFrame"               "name"

SelectFrameUsingUrl

This action is used to select a frame irrespective of the frame hierarchy. The frame can be either be an iframe or a normal frame, which are defined in html by <iframe> and <frame> tag respectively.

To pass the URL, do one of the following:

  • Set the StringisUrlPattern parameter to false to pass the exact URL of the frame that you want to select.

  • Set the StringisUrlPattern parameter to True to pass regex pattern for a particular URL.

In both cases, if the given URL has multiple frames, the first frame in the frame hierarchy is selected. If the frame URL does not exist, the context switches to either the first frame on the page, or the main document if the page contains iframes.

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

String URL

Enter the  URL of the frame.

No

String

StringisURLPattern

It takes the value True or false denoting whether URL is regex pattern or exact url.

  • Set True for if  URL is a regex pattern

  • Set False for URL is not a regex pattern

No

String

Example

The SelectFrameUsingUrl action will select first frame from the frame hierarchy which is found as per the regex pattern.

StoreCurrentDateInFormat

This action stores the current date in the specified format under the key name. The key value can be retrieved using the key name. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Format

Enter the format which you want to use to save the date. Use DD for day, MM for month and YYYY for year. 
For example: dd/MM/yyyy , MMM/dd/yyyy , dd-MM-yyyy etc 
dd = day 
MM = month represented as 01,02,03 etc 
MMM = month represented as Jan. Feb, Mar etc 
yyyy = year

Yes

String

key

Enter the key name under which the current date will be stored.

Yes

String

Example:
StoreCurrentDateInFormat                             "MM-dd-yyyy"                "currentDateKey"

StoreDateInFormat

This action stores the date provided by the user in a specific format under the key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

date

The date which needs to be stored in the specified format.

Yes

String

Format

Enter the format using which you want to save the date. Use DD for day, MM for month and YYYY for year.

For example: dd/MM/yyyy , MMM/dd/yyyy , dd-MM-yyyy, and so on.
dd = day 
MM = month represented as 01,02,03 etc 
MMM = month represented as Jan. Feb, Mar etc 
yyyy = year

Yes

String

resultFormat

Format in which the date given by the user needs to be stored.

Yes

String

key

Enter the key name under which the new result will be stored.

Yes

String

Example:
StoreDateInFormat                      "30/Jan/2009"                    "dd/MMM/yyyy"               "dd-MMM-yyyy"             "Datekey"

TrimAndStoreText

This action trims the preceding and succeeding spaces and stores the resulting string in the given key.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

strText

The string which has to be trimmed.

Yes

String

strKey

The key in which result is to be stored.

Yes

String


Example:
TrimAndStoreText                "     John Doe       "           "FullName"

Suppose, you give the strText as "    John Doe    " to store the final string inside the key "FullName". End of the execution, John Doe  will be stored in the key FullName.

TrimAndCompareString

This action compares two strings. The comparison can be either case-sensitive / non case-sensitive. Even a key can be passed as one of the parameters for comparison where the TrimAndCompareString function will retrieve the value from the key and that value will be compared with expected. The spaces of both the strings are trimmed before comparing.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

first-string

First string for comparison

No

String

secondString

Second string for comparison

No

String

CaseSensitive

True for case-sensitive comparison

False for case-insensitive comparison.

No

String

Example:

TrimAndCompareString      “Hello “     “ hello ”    “True”

VerifyDates

This action performs comparisons between two dates for various operations (equality, inequality, greater than, less than).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

actualDate

Enter the actual date which need to be verified. 

Yes

String

actualDateFormat

Enter the format of the actual date provided earlier.

Yes

String

expectedDate

Enter the expected date against which you want to verify the actual date. 

Yes

String

expectedDateFormat

Enter the format of the expected date provided earlier.

Yes

String

operation

Specify the operation to be performed between the first and second dates.

  • Use < to verify that the first date is less than (comes before) the second date.

  • Use > to verify that the first date is greater than (comes after) the second date.

  • Use == to verify that the dates are equal.

  • Use != to verify that the dates are unequal.

No

String

Example:

The result of this action shall be True or false depending on the operation performed.

VerifyDates                            "12-Jun-2008"                     "dd-MMM-yyyy"                          "04/12/2008"                      "dd/MM/yyyy"               "<"

ChangeCaseAndStore

This action changes the case of the provided string and stores the final value into the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name in which you want to store the updated string.

Yes

String

InputString

Enter the string whose case you want to change.

Yes

String

Case

Value for this parameter can be as follows:

  • Set Upper to change the case of the string to upper case.

  • Set Lower to change the case of the string to lower case.

Yes

String

 

Example:

ChangeCaseAndStore                "Key"               "Qualitia"             "Upper"

ChangeDateAndStore

This action modifies the day/month/year by the number specified by the user and stores the resulting date under the specified key in the same format as the input date. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

date

Enter the date that needs to be updated.

Yes

String

format

Enter the format of the date given by the user.

Yes

String

dayValue

Enter the value by which you want to increase/decrease the day. For example; "1", "-3".

Yes

String

monthValue

Enter the value by which you want to increase/decrease the month. For example; "1", "-3".

Yes

String

yearValue

Enter the value by which you want to increase/decrease the year. For example; "1", "-3".

Yes

String

key

Enter the key name under which the updated date will be stored. 

Yes

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.

CalculateDifferenceInDatesAndStore

This action calculates the difference in days between the two specified dates and stores the difference under the specified key. The key value can be used using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

startDate

Enter the start date to compare.

Yes

String

startformat

Enter the date format of the start date.

Yes

String

endDate

Enter the end date to compare.

Yes

String

endFormat

Enter the date format of the end date.

Yes

String

key

Enter the key name under which the difference (in days) will be stored. 

Yes

String

Example:
CalculateDifferenceInDatesAndStore                             "24-Jan-2007"                    "dd-MMM-yyyy"                     "01/26/2007"                      "MM/dd/yyyy            "diffKey"

VerifyDialogExistence

This action verifies if any dialog of the type alert/prompt/confirmation exists on the browser.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value of this parameter can be True or false.

  • Set True if you want to check for the presence.

  • Set False if you want to check for the absence.

No

String

Example:
VerifyDialogExistence                       "True"

AcceptDialog

This action clicks the OK button on the alert/prompt/confirmation pop up.

This action does not have any parameter.

Example:
AcceptDialog

DismissDialog

This action cancels the alert/prompt/confirmation pop up.

This action does not have any parameter.

Example:
DismissDialog

StoreDialogText

This action stores the message from the alert/prompt/confirmation pop up under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the key name under which you want to save the message.

Yes

String

Example:

StoreDialogText               "message"

ExecuteFile

This action executes the batch file specified by the user.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

batchFile

The absolute path to the batch file to be executed. Path should not have whitespace.

Yes

String

Example:
ExecuteFile                     "C:\test\batchfile1.bat"

AttachFile

This action sets a file path in the file object type in html. This action is applicable only for desktop web application.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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"



ExecuteQueryAndStoreInFile

This action executes data manipulation queries like select and stores the result into a file.

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:

  • MySql 5.1

  • Oracle 10g

  • MS Access

  • SQL Server 2008

If this action fails upon execution, refer to  Actions Related to DB Failed upon Execution.

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" (case-sensitive)
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.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Driver

Enter the driver for the database.

Yes

String

url

Enter the connection string to connect to the database.

Yes

String

username

Enter the user name to connect to the database.

Yes

String

Password

Enter the password to connect to the database.

Yes

String

Query

Enter the ddl query that needs to be executed.

Yes

String

File

Enter the absolute path of the file in which the results of the database query need to be stored.

Yes

String

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"

ExecutQueryAndStoreInKey

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

The Qualitia supports querying on the following database types:

  • MySql 5.1

  • Oracle 10g

  • MS Access

  • SQL Server 2008

If this action fails upon execution, refer to  Actions Related to DB Failed upon Execution.

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.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Driver

Enter the driver for the database.

Yes

String

url

Enter the connection string to connect to the database.

Yes

String

username

Enter the user name to connect to the database.

Yes

String

Password

Enter the password to connect to the database.

Yes

String

Query

Enter the dml query that needs to be executed.

Yes

String

key

Enter the key in which the result of the database query need to be stored.

Yes

String

Example:
ExecuteQueryAndStoreInKey "oracle.jdbc.driver.OracleDriver" "jdbc:oracle:thin:@localhost:1521:orcl" "scott" "tiger" "delete from test_table where id = 100" "Resultkey"

CompareTabularResults

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

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

Example
CompareTabularResults             "C:\DBResults\XML\ORACLE\Result.xml"                 "C:\DBResults\Excel\ORACLE\Result.xls"                     "MSExcel"

ComputeExpression

This action evaluates mathematical, relational, logical operations and stores the result under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

expression

The expression to be evaluated

Yes

String

strKey

The key under which the result of the evaluation will be stored.

Yes

String

Example:

Mathematical Expression
ComputeExpression                "24*2+4"              "Result"

Example:

Relational Expression
ComputeExpression               "10*2<30"             "Result"

Example:

Logical Expression
ComputeExpression             "10*2+1>19&10*2+2<23'"     "Result"

CompareArray

This action compares two arrays for equality.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

actualArray

Enter the array which you want to compare. Array items are separate by carat (^) sign.

No

Array

excpectedArray

Enter the expected array against which you want to com[are the actual array.

Array items are separate by carat (^) sign.

No

Array

match

This parameter specifies the type of comparison to be done. It can be one of the following: 

  • Exact – This will compare the items of the array for exact match that is size of the two arrays should match. The sequence in which the items occur in the arrays should match. This is a one to one comparison. 

  • Partial- This compares if the second array is a sub-list of the first. The sub-list items in the second array need not be in the same sequence as they appear in the first array. However, it is not vice versa, that is, it will not check if the first array is a sub-list of the seconds array. In this case, the action will fail.

No

String

Example :
CompareArray "1^2^3^4" "1^2^3^4"             "exact"
CompareArray "1^2^3^4^5^6" "2^1^3^4"      "partial"

StoreWindowHandle

This action fetches the handle (identifier) of a window 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.

Also, this action will have to be used immediately after every action which results in opening a new window. Only then user will be able to work on the new opened window. Thus, immediately after every action which opens a new window, this action will have to be used in order to fetch the identifier of the new window.

This action has to be used for every window of the application. For more information about this, please refer to the knowledge base here. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

Enter the key name to store the window handle.

Yes

String

Example: 
Object1                                   Click 
StoreWindowHandles            "new window" 
SelectPage                              "{new window}" 
EditObjectOnNewPage           Set                 Testing 
In the example above, on clicking on object1 a new window is opened on which actions need to be performed.

Use the action StoreWindowHandles to fetch the handle of the new window opened. Use the SelectPage action to select the window. Then user can work on an object present on the new page.

Also, when the action OpenUrl is used, user will have to store the handle on this main application window.

Example:

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

ExitTask

This action skips the execution of the next step and continue executing the next task. 

This action is not available for test case level step.

This action does not have any parameter.

Example:

ExitTask

ExitTCIteration

This action skips the execution of the current iteration of test case and execute next iteration. In case of a single TC Iteration the test case execution will stop.

This action does not have any parameter.

Example:

ExitTCIteration

ExitSuite

This action stops the execution of the test suite and no further test cases will be executed.

This action does not have any parameter.

Example:

ExitSuite

VerifyLinkOnPage

This action verifies if there is any hyperlink exists on the page.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Link

The locator of the link to be verified. This is the inner text of the link.

Yes

String

Example:
VerifyLinkOnPage                    "AdvancedSearch"

StoreChildCount

This action stores the child count for the specified locator. The action counts the last element in the Xpath which are placed inside the parent hierarchy. The child elements to be counted can be immediate children/descendants. The user should pass relevant Xpath to achieve children/descendants count.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type 

Parameter Name

Parameter Description

Mandatory

Data Type 

locator

The xpath of the object whose child count is to be retrieved.

It is mandatory that the input should be an xpath locator. This action will fail for any other locator type.

Yes

String

key

Enter the key name under which the count will be stored.

Yes

String

Example
StoreChildCount                      "//table[@id='12']/tbody/tr/td/div"         "Key"

DownloadFile

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

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



Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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"

RefreshPage

This action simulates the refresh operation on the currently selected page.

This action does not have any parameter. 

Example:

RefreshPage

DeleteCookiesOnCurrentDomain

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

If the page is www.google.co.in and the user runs the above action, then all the cookies created by www.google.co.in will be deleted.

If there is a link in www.google.co.in and on clicking, it navigates to www.apple.com.

Again , when the user runs the above action, then all the cookies create by www.apple.com will be deleted.

Reiterating, to delete www.google.co.in cookies, the application needs to be in www.google.co.in domain.

This action will automatically, pick up the current domain and will delete cookies of that domain. The user just needs to make sure that he runs this action only in the domain for which the cookies are to be deleted.

Note: In HTML, due to security reasons, the only website that can read/delete a cookie is the one that creates it.

Example:
DeleteCookiesOnCurrentDomain

AcceptDialogAndStoreMessage

This action accepts the dialog appeared on the Web page and stores the message under the specified key. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key in which the message will be stored.

Yes

String

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

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

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.


Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the URL to the web application.

Yes

String

Username

Enter the username to sign in.

Yes

String

Password

Enter the password to sign in.

Yes

String

Example:

WindowsAuthenticationLogin                      "http://www.abc.com"               "testuser1"        "passwduser1"

NoOps

This is a placeholder action and cannot be executed. Qualitia selects this action for the steps present under the activity when auto-populating test case.

You are requested to replace this action with Qualitia executable action.

This action does not have any parameters. 

When executing test cases with this action, test cases will be failed to notify Qualitia users about replacing such actions.

MinimizeWindow

This action minimizes the window.

This action does not have any parameter. 

Example:

MinimizeWindow

SetPageLoadTimeout

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

Parameter Name

Parameter Description

Mandatory

Data Type

timeoutinSeconds

Enter the expected timeout to load the page.  

Yes

String

Example:

SetPageLoadTimeout             "20"

StorePageSource

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

Parameter Name

Parameter Description

Mandatory

Data Type

keyPageSource

Enter the key name to store the page source in.   

Yes

String

Example:

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

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

This action changes the current Web execution platform from Desktop to Mobile. When used, web application test case will run on specified platform.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Platform

Platform to run web application on. Supported platforms are "Desktop" and "Mobile".

Yes

 String

Example:

SwitchWebExecutionPlatform                        "Mobile"

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

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"

SetWindowSize

This action sets the window size based on the parameters provided (height and width).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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

 

Example:

SetWindowSize          "1344"             "689"

StoreWindowSize

This action stores the current size of the window under the specified keys. These key values can be retrieved using the key names.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

KeyHeight

Enter the key name to store the height of the window.

Yes

String

KeyWidth

Enter the key name to store the width of the window.

Yes

String

Example:

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

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

Example:

SetWindowPosition          "123"             "232"

StoreWindowPosition

This action stores the current position of the window under the specified keys. These key values can be retrieved using the key names.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

keyXPosition

Enter the key name to store the X coordinate.

Yes

String

keyYPosition

Enter the key name to store the Y coordinate.

Yes

String

Example:

StoreWindowPosition          "XCordinateValue"             "YCordinateValue"

SetFullScreen

This action sets the browser in the full screen mode. 

This action does not have any parameter.

Example:

SetFullScreen

ClickAndHold

This action clicks (without releasing) at the current mouse location.

This action does not have any parameter.

Example:

ClickAndHold

DoubleClick

This action performs a double click action at the current mouse location.

This action does not have any parameter. 

Example:

DoubleClick

RightClick

This action performs a right-click action at the current mouse location.

This action does not have any parameter.

Example:

RightClick

SelectFrameByIndexWhenAvailable

This action waits for the specified frame to appear on the page and selects when it is available. You may specify the timeout and polling interval, if required.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

frameIndex

Enter the index of the frame which you want to wait and select for. Index starts at 0.   

No

String

timeOut

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

No

String

pollingInterval

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

No

String

key

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:

SelectFrameByIndexWhenAvailable       "3"         "10"      "500"       "Key"     "Defect" 

WaitForJavaScriptReturnsValue

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

JavaScriptString

Enter the JavaScript code to run. 

No

String

keyReturnValue

Enter the key under which the javascript return value will be stored. The key value can be retrieved using the key name. 

No

String

timeOut

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

No

String

pollingInterval

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

No

String

keyStatus

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:

WaitForJavaScriptReturnsValue       "return eval('2-1');"    "key"      "10"      "500"       "Key"     "Defect"  

WaitForJavaScriptThrowsNoExceptions

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

JavaScriptString

Enter the JavaScript code to run. 

Yes

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

Example:

WaitForJavaScriptThrowsNoExceptions       ""          "10"      "500"       "Key"     "Defect"  

WaitForTitleContains

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

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

Example:

WaitForTitleContains      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForTitleNotContains

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

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

Example:

WaitForTitleNotContains      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForTitleToBe

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

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

Example:

WaitForTitleToBe      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForTitleNotToBe

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

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

Example:

WaitForTitleNotToBe      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForURLContains

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

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

Example:

WaitForURLContains      "OAuth%9"          "5"          "500"        "Key"        "Defect"

WaitForURLNotContains

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

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

Example:

WaitForURLNotContains      "OAuth%9"          "5"          "500"        "Key"        "Defect"

WaitForURLToBe

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

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

Example:

WaitForURLToBe      "https://google.co.in"          "5"          "500"        "Key"        "Defect"

WaitForURLNotToBe

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

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

Example:

WaitForURLNotToBe      "https://google.co.in"          "5"          "500"        "Key"        "Defect"

WaitForURLPattern

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

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

Example:

WaitForURLPattern      "http[s]:\/\/www\.mysite\.com.*"          "5"          "500"        "Key"        "Defect"

WaitForAlertAndSendText

This action waits for the page to prompt an alert. After the alert is prompted, you can send the text specified in the parameter. You may specify the timeout and polling interval, if required.

After adding the required text, you can use the AcceptDialog or WaitForAlertAndSpecifyBehavior to continue test case execution on the main window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

textToSend

Enter the text you want to send in the alert. 

Yes

String

timeOut

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

No

String

pollingInterval

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

No

String

keyAlertAvailable

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:

WaitForAlertAndSendText      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForAlertAndSpecifyBehavior

This action waits for the web page to prompt an alert. After the alert is prompted, you can either accept the dialog or dismiss the dialog giving appropriate values in the parameters. You may specify the timeout and polling interval, if required.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

acceptOrDismiss

Parameter Name

Parameter Description

Mandatory

acceptOrDismiss

acceptOrDismiss

Values for this parameter can be: accept or dismiss.

  • Set accept if you want to accept the dialog. 

  • Set dismiss if you want to dismiss the dialog.  

No

String

timeOut

Enter the timeout (in seconds) to wait for an alert. 

No

String

pollingInterval

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

No

String

keyAlertAvailable

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:

WaitForAlertAndSpecifyBehavior      "accept"          "5"          "500"        "Key"        "Defect"

MinimizeWindow

This action minimizes the window.

This action does not have any parameter. 

Example:

MinimizeWindow

SetPageLoadTimeout

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

Parameter Name

Parameter Description

Mandatory

Data Type

timeoutinSeconds

Enter the expected timeout to load the page.  

Yes

String

Example:

SetPageLoadTimeout             "20"

StorePageSource

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

Parameter Name

Parameter Description

Mandatory

Data Type

keyPageSource

Enter the key name to store the page source in.   

Yes

String

Example:

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

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

This action changes the current Web execution platform from Desktop to Mobile. When used, web application test case will run on specified platform.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Platform

Platform to run web application on. Supported platforms are "Desktop" and "Mobile".

Yes

 String

Example:

SwitchWebExecutionPlatform                        "Mobile"

SetWindowSize

This action sets the window size based on the parameters provided (height and width).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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



Example:

SetWindowSize          "1344"             "689"

StoreWindowSize

This action stores the current size of the window under the specified keys. These key values can be retrieved using the key names.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

KeyHeight

Enter the key name to store the height of the window.

Yes

String

KeyWidth

Enter the key name to store the width of the window.

Yes

String

Example:

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

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

Example:

SetWindowPosition          "123"             "232"

StoreWindowPosition

This action stores the current position of the window under the specified keys. These key values can be retrieved using the key names.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

keyXPosition

Enter the key name to store the X coordinate.

Yes

String

keyYPosition

Enter the key name to store the Y coordinate.

Yes

String

Example:

StoreWindowPosition          "XCordinateValue"             "YCordinateValue"

SetFullScreen

This action sets the browser in the full screen mode. 

This action does not have any parameter.

Example:

SetFullScreen

ClickAndHold

This action clicks (without releasing) at the current mouse location.

This action does not have any parameter.

Example:

ClickAndHold

DoubleClick

This action performs a double click action at the current mouse location.

This action does not have any parameter. 

Example:

DoubleClick

RightClick

This action performs a right-click action at the current mouse location.

This action does not have any parameter.


Example:

RightClick

SelectFrameByIndexWhenAvailable

This action waits for the specified frame to appear on the page and selects when it is available. You may specify the timeout and polling interval, if required.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

frameIndex

Enter the index of the frame which you want to wait and select for. Index starts at 0.   

No

String

timeOut

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

No

String

pollingInterval

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

No

String

key

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:

SelectFrameByIndexWhenAvailable       "3"         "10"      "500"       "Key"     "Defect" 

AnswerForNextDialog (Deprecated)

This action sets the input as the answer for the next prompt. After setting the answer, webdriver by default may cancel the prompt.

In order to accept and submit your input in the prompt, this action should be used followed by the action "AcceptDialog".

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

answer

Enter the input which you want to set in the next prompt.

Yes

String

Example:

AnswerForNextDialog           "Hello"

StoreSubString (Deprecated)

This action stores a substring of a string into a variable. The key value can be retrieved using the key name. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the sub-string is to be stored.

Yes

String

sourceString

Enter the string whose sub-string value is to be stored.

No

String

startIndex

Enter the index of the string from where the sub-string is to be fetched.

No

String

endIndex

The number of characters required in the string.

No

String


Example:
StoreSubString                   "resultSubString"            "This is a test"                "2"                  "4"

StoreRandomAlphanumericString

This action generates any random alphanumeric string for a specific length that you want and stores the random value for the specified key. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which you want to store the random text.

Yes

String

Length

Specify the number of characters of the string you want to generate and store under the key name.

Yes

String

Example:

StoreRandomAlphanumericString               "Key"                       "10"

StoreRoundNumber

This action stores values specified by the user by rounding them off to the nearest whole number. The rounded off value stored in the key can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name in which you want to store rounded value.

Yes

String

Number

Enter the number whose value you want to store into the key.

Yes

String

Example:

StoreRoundNumber           "key"                 "6.43"

  • In this case, 6 will be stored into the key.

StoreRoundNumber           "key"                "6.55"

  • In this case, 7 will be stored into the key.

StoreRandomNumber

This action picks up any random number from the specified range and stores that number in the specified key. The key value can be retrieved using the key name.

Number can be duplicated, if you use this action multiple times in a single test case.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

MinNumber

Enter the minimum number.

Yes

String

MaxNumber

Enter the minimum number.

Yes

String

strKey

Enter the key name under which you want to store the random number.

Yes

String

Example:

StoreRandomNumber        “123”         “890”        “Key”

StoreStringConcat

This action concatenates (combines) two strings specified by the user and stores into the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

String1

Enter the string first string.

Yes

String

String2

Enter the another string.

Yes

String

Key

Enter the key name under which you want to store the combined value.

Yes

String

Example:

StoreStringConcat                "String1"          "String2"        "Key"

StoreRandomString

This action generates and stores any random string of the specified length into the key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which you want to store the random text.

Yes

String

Length

Specify the number of characters of the string you want to generate and store under the key name.

Yes

String

Example:

StoreRandomString               "Key"                    "23"

StoreStringFromRight

This action stores the specified number of characters from the right side of the given string. The stored key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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:

StoreStringFromRight         "Key"      "John Doe"         "3"        

In this case, the last three characters, that is, Doe will be stored under the key name.

StoreStringFromLeft

This action stores the specified number of characters from the left side of the given string. The key value can be retrieved using the key name.

Enter 0 if you want to store the empty string.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Number

Enter the number whose square root you want to store.

Yes

String

Key

Enter the key name under which you want to store the square root.

Yes

String


Example:

StoreSqRoot              "144"             "Key"

In this case, the 12 will be stored under key.


Example:

StoreStringFromLeft                      "John Doe"             "4"          "Key"

In this case, the first four characters i.e. Jonn will be stored under the key name.

StoreIntegerSign

This action stores an integer that indicates sign of the number specified in the parameter. The key value can be retrieved using the key name.

  • If number is greater than 0, stores 1.

  • If number is equal to 0, stores 0.

  • If number is lesser than 0, stores -1.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which you want to store the integer value.

Yes

String

Number



Enter the number whose integer value you want to store.



Yes

String

Example:

StoreIntegerSign                    "Key"             "12"

If you enter a negative integer, in this case, the -1 will be stored under key because the number is lesser than 0.

StoreAbsoluteValue

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Integer

Enter the integer whose absolute value you want to store.

Yes

String

Key

Enter the key name under which you want to store the absolute value.

Yes

String


Example:

StoreAbsoluteValue                "-3.6"              "Key"

In this case, the 3.6 will be stored under key.

StoreMatchesFromRegExPattern

This action fetches all the matches of a regular expression pattern from an InputString and stores the array of all the matches into the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

RegExPattern

Enter the regular expression pattern.

Yes

String

InputString

Enter the data from which you want to store the element.

Yes

String

Key

Enter the key name under which you want to store the matching element.

Yes

String

 

Example:

StoreMatchesFromRegExPattern                  "Cust1(\d?)"               "CustKey1 CustKey123Cust321"           "Key"

Array.IsArray

This action verifies whether the specified data is in the array form. If the data is not an array, reports a defect in the execution report.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data which you want to verify.

Yes

String

 

Example:

Array.IsArray              "ArrayKey"

Array.JoinArrayAndStore

This action joins the substrings from an existing array and stores them into the specified key. By default, these substrings are separated by the caret sign (^). The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data which you want to join.

Yes

String

Key

Enter the key name under which you want to store the joined array.

Yes

String

 

Example:

Array.JoinArrayAndStore                "ArrayKey"            "Key"

Array.Reverse

This action reverses the existing sequence of data given in an array.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data which you want to modify the sequence of.

Yes

String

 

Example:
Array.Reverse                     "ArrayKey"

Array.Sort

This action sorts the existing array data in an ascending order.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data which you want to sort in an ascending order.

Yes

String

 

Example:
Array.Sort               "ArrayKey"

Array.StoreArrayLength

This action stores the length of an existing array into the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data whose length you want to store.

Yes

String

Key

Enter the key name under which you want to store the array length.

Yes

String

Example:

Array.StoreArrayLength       "ArrayKey"               "Key"

Array.StoreElementByIndex

This action stores the element from the specified index of an array into the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data from which you want to store the element.

Yes

String

Index

Enter the index of the element which you want to store.

Yes

String

Key

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

Yes

String

Example:
Array.StoreElementByIndex                  "ArrayKey"          "5"           "Key"

Array.StoreElementIndex

This action stores the index of the specified element from an existing array into the specified key. The key value can be retrieved using the key name.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data from which you want to store the element index.

Yes

String

Element

Enter the element which you want to store.

Yes

String

Occurrence

Enter the number of occurrence from the array which you want to store.

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

Key

Enter the key name under which you want to store the index of an element.

Yes

String

Example:

Array.StoreElementIndex                    "ArrayKey"           "Sunday"           "1"           "True"         "Key"

Array.VerifyElementExist

This action verifies whether the specified item exists in an array and reports a defect in case of not finding the specified item.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

ArrayKey

Enter the key that holds an array data from which you want to verify the element.

Yes

String

Element

Enter the element which you want to verify.

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

Example:
Array.VerifyElementExists                        "ArrayKey"             "Sunday"             "True"

LeftTrimAndStore

This action removes or trims the blank spaces existing at the extreme left side of the specified string and stores the value under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which you want to store the final value.

Yes

String

InputString

Enter the string from which you want to trim the blank space.

Yes

String

Example:

LeftTrimAndStore         "Key"      "       John and family"            

In this case, the John and family will be stored under key. The blank space before john will be removed.

RightTrimAndStore

This action removes or trims the blank spaces existing at the extreme right side of the specified string and stores the value under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name under which you want to store the final value.

Yes

String

InputString

Enter the string from which you want to trim the blank space.

Yes

String

Example:

RightTrimAndStore         "Key"       "John and family           "           

In this case, the John and family will be stored under key. The blank space after john and family will be removed.

IMAGE.CompareTwoImages

This action compares two images. The file extension and resolution of both the images (source and target) should be same, otherwise, the step will fail.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

SourceImagePath

Enter the absolute path to the source image which you want to compare.

Yes

String

TargetImagePath

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

Yes

String

Example:

IMAGE.CompareTwoImages    “C:\Users\Qualitia\Cust_Sign.png”        “C:\Users\Qualitia\Cust_Logo.png”

Date.StoreModified Date

This action modifies the date interval based on the data provided by the user and stores the modified date in the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Inputdate

Enter the date to which you want to add the interval.

Yes

String

Interval

Enter the interval which you want to modify. Value for this parameter can be as follows:

  • yyyy - Year

  • q - Quarter

  • m - Month

  • y - Day of year

  • d - Day

  • w - Weekday

  • ww - Week of year

  • h - Hours

  • n - Minutes

  • s – Seconds

Yes

String

Data

Enter the number of intervals you want to add to the input date. The number can be positive for future dates and negative for dates in the past.

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:

Data.StoreModifiedDate “02/28/2001”     “yyyy”    “20”    “Key”

Post execution, Qualitia will store 02/28/2021 in the key.

Date.ChangedDateFormat

This action modifies format of the date and time based on the format specified by the user and stores the date and time in the modified format under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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

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

dropToLocatorType

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

Yes

String

Example:

DragAndDropToObject                  "//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

Parameter Name

Parameter Description

Mandatory

Data Type

dragLocator

Locator value that can be used to find the 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

dropToLocatorType

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

Yes

String

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

This action stores the value available in the specified cell. You can then use this data while developing tasks and test cases.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

filePath

Enter absolute path to the Excel file from which you want to get and store the value.

Yes

String

sheetname

Enter the sheet name from the Excel file from which value is to be stored.

Yes

String

rowNumber

Enter the row number of the cell from which you want to store the value.

Yes

String

column

Enter the column ID or column name from which you want to store 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

Key

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

Yes

String

Example:

EXCEL.StoreCellData               “D:\TrainingStatus.xlsx”           “Sheet1”         “3”      “Col::3”          “Key”

Excel.WriteToRow

This action adds specified value or a set of values into the specified row of the Microsoft excel file.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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 add the values.

Yes

String

rowNumber

Enter the row number in which you want to add the value.

Yes

String

column

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

data

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

Yes

Array

overWrite

Specify whether you want to overwrite the existing data or you want to add another row to add this data. Values for this parameter can be as follows:

  • Enter Previous to add a new row before the row specified above.

  • Enter Next to add a new row after the row specified above.

  • Enter Current to overwrite new values over the existing set of values.

No

String



Example:

EXCEL.WriteToRow                   “D:\TrainingStatus.xlsx”                “Sheet1”            “3”               “Col::3”         “PASS^PASS^FAIL^WIP”              “Current”

Excel.WriteToColumn

This action adds the specified value or a set of values into the specified column of the Microsoft Excel file.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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 add the values.

Yes

String

rowNumber

Enter the row number in which you want to add the value.

Yes

String

Column

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

Data

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

Yes

Array

Overwrite

Specify whether you want to overwrite the existing data or you want to add another row to add this data. Values for this parameter can be as follows:

  •  

    • Enter Previous to add a new column before the column specified above.

    • Enter Next to add a new column after the column specified above.

    • Enter Current to overwrite new values over the existing set of values.

No

String

Example:

EXCEL.WriteToColumn               “D:\TrainingStatus.xlsx”           “Sheet1”           “3”          “Col::3”         “USER1^ USER2^ USER3^ USER4”          “Previous”

Excel.StoreColumnCount

This action stores the total number of columns present in the specified sheet of Microsoft Excel.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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 from which you want to store the column count.

Yes

String

ignoreBlankColumn

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

  • To ignore blank columns, use True.

  • To consider even blank columns, use False.
    Note: The default value is True.

No

Boolean

Key

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

Yes

String

Example:

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

Excel.StoreRowCount

This action stores the total number of rows present in the specified sheet of Microsoft Excel.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

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

           Yes

String

filePath

Enter the absolute path to the Excel file.

Yes

String

sheetname

Enter the sheet name from the Excel file from which you want to store the row count.

Yes

String

ignoreBlankRows

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

  • To ignore blank rows, use True.

  • To consider even blank rows, use False.

No

String

 

Example:

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

Excel.StoreColumnDataOccurrance

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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

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

 

Example:

Excel.StoreColumnDataOccurrance              “D:\TrainingStatus.xlsx”    "Sheet1”   "5"        “True”        “Key”

Excel.StoreCellDataFromFile

This action checks the condition added by the user and stores the matching data from specified Excel cell into the specified key.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

filename

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

Yes

String

sheetName

Enter the name of the sheet from which you want to fetch the data.

Yes

String

colName

Enter the column name from which you want to fetch the data.

Yes

String

Condition

Enter the condition which you want to match for getting the desired data.

Yes

String

Separator

Specify the separator which you have used to separate column name and data while adding the condition. You can use any character as a separator (equal to [=] sign in the example mentioned below). Use caret sign (^) as a connection string. 

Yes

String

strKey

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

Yes

String


Example:

EXCEL.StoreCellDataFromFile

Suppose there is list of employees and you want to store the employee ID of the specific employee from the list. (refer to the image below). To store the employee ID of Jane, you can use this action as follows:

"D\Book1.xlsx" "Sheet1"                "Employee ID"             "FirstName=Jane^LastName=Doe^Designation=Asst.Manager"          "="          "ID"

End of the execution, action stores the Employee ID of Jane i.e. 232 into the specified key ID.

File.CompareFileContents

This action is used to compare two text files to validate whether their content is same.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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”

FILE.StoreCharacterCount

This action stores the total number of characters present in the specified text file. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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”

FILE.StoreStringByLineNumber

This action stores data from the specified row of the specified text file in the key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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”

FILE.VerifyStringExistInFile

This action verifies whether the specified data exists in the specified text file.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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”

File.VerifyFileExist

This action verifies the existence of the specified file at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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”

File.VerifyFolderExist

This action verifies the existence of the specified folder at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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”

IsArraySorted

This action verifies whether the array is sorted in ascending/descending order.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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"

PDF.VerifyStringExistInPDF

This action searches specified text in the PDF file.

Prerequisite:

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

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”

PDF.VerifyStringExistInPDFPage

This action searches specified text on the specified page of the PDF file.

Prerequisite:

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

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”

PDF.ComparePDF

This action compares two PDFs and validates whether content inside them is identical and stores differences in the temporary text file.

Prerequisite:

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

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”

StoreClipboardData

This action stores the data present on the clipboard into the specified key. The key value then can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

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

Yes

String

 

Example:

StoreClipboardData                 "key"

StoreFixNumber

This action stores the integer part of a specified number into the specified key. The stored key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the key name in which you want to store the updated string.

Yes

String

Number

Enter the number from which you want to store the integer part.

Yes

String


Example:

StoreFixNumber           "Key"              "6.4332"

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

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"

WaitForJavaScriptReturnsValue

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

JavaScriptString

Enter the JavaScript code to run. 

No

String

keyReturnValue

Enter the key under which the javascript return value will be stored. The key value can be retrieved using the key name. 

No

String

timeOut

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

No

String

pollingInterval

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

No

String

keyStatus

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:

WaitForJavaScriptReturnsValue       "return eval('2-1');"    "key"      "10"      "500"       "Key"     "Defect"  

WaitForJavaScriptThrowsNoExceptions

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

JavaScriptString

Enter the JavaScript code to run. 

No

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

Example:

WaitForJavaScriptThrowsNoExceptions       ""          "10"      "500"       "Key"     "Defect"  

WaitForTitleContains

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

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

Example:

WaitForTitleContains      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForTitleNotContains

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

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

Example:

WaitForTitleNotContains      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForTitleToBe

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

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

Example:

WaitForTitleToBe      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForTitleNotToBe

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

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

Example:

WaitForTitleNotToBe      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForURLContains

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

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

Example:

WaitForURLContains      "OAuth%9"          "5"          "500"        "Key"        "Defect"

WaitForURLNotContains

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

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

Example:

WaitForURLNotContains      "OAuth%9"          "5"          "500"        "Key"        "Defect"

WaitForURLToBe

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

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

Example:

WaitForURLToBe      "https://google.co.in"          "5"          "500"        "Key"        "Defect"

WaitForURLNotToBe

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

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

Example:

WaitForURLNotToBe      "https://google.co.in"          "5"          "500"        "Key"        "Defect"

WaitForURLPattern

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

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

Example:

WaitForURLPattern      "http[s]:\/\/www\.mysite\.com.*"          "5"          "500"        "Key"        "Defect"

WaitForAlertAndSendText

This action waits for the page to prompt an alert. After the alert is prompted, you can send the text specified in the parameter. You may specify the timeout and polling interval, if required.

After adding the required text, you can use the AcceptDialog or WaitForAlertAndSpecifyBehavior to continue test case execution on the main window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

textToSend

Enter the text you want to send in the alert. 

Yes

String

timeOut

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

No

String

pollingInterval

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

No

String

keyAlertAvailable

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:

WaitForAlertAndSendText      "Qualitia"          "5"          "500"        "Key"        "Defect"

WaitForAlertAndSpecifyBehavior

This action waits for the web page to prompt an alert. After the alert is prompted, you can either accept the dialog or dismiss the dialog giving appropriate values in the parameters. You may specify the timeout and polling interval, if required.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

acceptOrDismiss

Parameter Name

Parameter Description

Mandatory

acceptOrDismiss

acceptOrDismiss

Values for this parameter can be: accept or dismiss.

  • Set accept if you want to accept the dialog. 

  • Set dismiss if you want to dismiss the dialog.  

No

String

timeOut

Enter the timeout (in seconds) to wait for an alert. 

No

String

pollingInterval

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

No

String

keyAlertAvailable

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:

WaitForAlertAndSpecifyBehavior      "accept"          "5"          "500"        "Key"        "Defect"

WaitForPageToLoad (Deprecated)

This actions waits for the page to load for the specified number of seconds. If the wait time is "" then the wait time value is taken from the "Sync Time" set under the Qualitia Configuration (Execution) window. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

Enter the number of seconds to wait.

No

String

Example:
WaitForPageToLoad                        "10"

In Webdriver, we wait for the object to come in ready state. If it is in ready state it is assumed that the page is loaded completely and Webdriver will stop waiting. The condition to wait till the object is in ready state and assume that the page is loaded could however not work as expected at all times.

WaitforAlertAndStoreAcceptIfexist

This action waits for the page to prompt an alert. After the alert is prompted, it stores the alert text in the variable. You may specify the timeout if required. After storing the required text, It clicks the OK button on the alert/prompt/confirmation pop up.


Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Parameter Name

Parameter Description

Mandatory

Data Type

Timeout

Seconds to wait for an alert to display on the screen..

No

String

Key

Key name under which the alert message will be stored.

No

String

Example:

WaitforAlertandStoreAcceptIfexist     “10“     “AlertMessage”

WriteToTextFile

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

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

Footer