Versions Compared

Key

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

OpenURL

This action opens the specified URL in the browser selected under Configuration Settings.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

url

Enter the URL that you want to open.

Yes

String

Example:

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

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

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

key

Enter the key name to store URL.

Yes

String

Example:

StorePageURL                   "Key"

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

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

key

Enter the key name to store variable.

Yes

String

data

Enter the value to be stored under the key name.

Yes

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

key

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

Yes

String

data

Enter the data to be stored in encrypted mode.

Yes

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

On this page:

Table of Contents
maxLevel2
minLevel2
absoluteUrltrue

Multiexcerpt include macro
nameDragandDroptoObject
pageDOC:General Web Actions

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

seconds

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

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

windowName

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

Yes

String

Example:

Select Page                            "Name"

ClosePopUpBrowser

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

Input Parameters:

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

Info

This action is applicable only for desktop web applications.

This action does not work when executing test cases in remote environment. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

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

Yes

String

Example:

Suppose the user want to open the Find dialog on the Browser window under test. Manually this is done by pressing the keys Control and F simultaneously. This opens the Find dialog on the browser window. The same thing can be done using the action PressKeys .The data to be passed to the action in this case will be given as ~^F where ^ means Control. (See the list below for the keys and their meaning.

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

Important Note:

Ideally the data to be passed here is only ^F, however as ^ has a special meaning in Qualitia it has to be preceded with an escape sequence ~. Hence the data passed will be ~^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 {,}, ^, ~
Ex:

  1. If key to be sent is {F1} then user should pass data as ~{F1~}
  2.  To send {TAB} then user should pass data as ~{TAB~}
  3.  To send {ENTER} user should pass data as ~{ENTER~}

Use the PressKeys method 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 would send the string argument "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 "%",
  • and tilde       "~"

Send these characters by enclosing them within braces "{}". For example, to send the plus sign, send 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, send the string argument "{[}" for the left bracket and "{]}" for the right one.
  • To send brace characters, send the string argument "}" for the left brace and "{" for the right one.
  • If you want to send a key combination that includes Ctrl key, send it like this: to send 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, send the arguments shown in the following table:

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

PRINT SCREEN

~{PRTSC~}

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

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 do this by preceding the regular keystroke with one or more of the following special characters:

KeyArguments
Shift~+
Ctrl~^
Alt~%

(info) 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, send the string argument "+(ec)".
  • e is pressed, followed by a lone c (with no SHIFT), send the string argument "+ec".

You can use the PressKeys method 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. You do this using 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}". Be sure to include a space between keystroke and number.

Note
  • 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 send the PRINT SCREEN key ~{PRTSC~} to an application.
  • To send a space, send the string " ".

StoreDateTimeByZone

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

Input Parameters:

Parameter NameParameter Description MandatoryData Type
expectedTimeZoneIDEnter 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). YesString
currentTimeZoneIDEnter 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). YesString
dateTimeEnter the date and time that you want to convert in the expected time zone. YesString
dateTimeFormatEnter 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).YesString
keyEnter 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. YesString

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.

ZoneIDDescription
ESTEastern Standard Time 
HSTHawaii Standard Time 
MSTMalaysia Standard Time 
ACTAustralia/Darwin
AETAustralia/Sydney 
AGTAmerica/Argentina/Buenos_Aires 
ARTAfrica/Cairo
ASTAmerica/Anchorage 
BETAmerica/Sao_Paulo
BSTAsia/Dhaka 
CATAfrica/Harare
CNTAmerica/St_Johns 
CSTAmerica/Chicago
CTTAsia/Shanghai 
EATAfrica/Addis_Ababa 
ECTEurope/Paris
IETAmerica/Indiana/Indianapolis
ISTAsia/Kolkata
JSTAsia/Tokyo 
MITPacific/Apia 
NETAsia/Yerevan 
NSTPacific/Auckland 
PLTAsia/Karachi 
PNTAmerica/Phoenix
PRTAmerica/Puerto_Rico 
PSTAmerica/Los_Angeles 
SSTPacific/Guadalcanal 
VSTAsia/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
dd-MM-yy 31-01-12 
dd-MM-yyyy31-01-2012
MM-dd-yyyy01-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.SSSZ2012-01-31 23:59:59.999+0100 
EEEEE MMMMM yyyy HH:mm:ss.SSSZSaturday November 2012 10:45:42.720+0100


Info

You can create your own combinations and formats using the patterns mentioned here. These patterns mentioned herein are case-sensitive. Ensure you use them in a correct way in order to achieve the desired output. 

StoreSubStringNew

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

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.

Yes

String

startIndex

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

Yes

String

endIndex

The number of characters required in the string.

Yes

String


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

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

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

Yes

String

intIncrement

The value by which the length needs to be incremented

Yes

String

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

CompareString

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

firstString

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

Yes

String

mainString

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

Yes

String

caseSensitive

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

  • Set True for case-sensitive comparison.
  • Set False for case-insensitive comparison.

Yes

String


Example:
StoreVariable             "Cancel"           "key"

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

The action can also compare strings having a new line character.
The spaces of both the strings are trimmed before comparing.


VerifyStringContainsValue

This action verifies that the substring is present within the main string. Comparison can either be case sensitive or insensitive.

This action verifies that the substring is present within the main string. Comparison can either be case sensitive or insensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

MainString

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

Yes

String

Substring

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

Yes

String

caseSensitive

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

  • Set True for case-sensitive comparison.
  • Set False for case-insensitive comparison.

Yes

String

Example:
StoreVariable                           "Testing the action"                   "mainStrKey"

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

Here 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 will return 0, if the sub-string is found in the main string, else it will return 2 if the sub-string is not found in the main string. In any other case it will return 1.

Empty and null substrings will not be 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

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.

Yes

String

caseSensitive

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

  • Set True for case-sensitive comparison.
  • Set False for case-insensitive comparison.

Yes

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]/{5/}[0-9]/{5/}$
  • strData –  YuIFp96062
  • blnCase -    False

ComparePattern                 "/^[a-z]/{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.


VerifyDifference

This action verifies the difference between two integer values and stores it in a variablevalidates it with the expected difference value.

Input Parameters:

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.

Yes

String

Int2

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

Yes

String

difference

Enter the expected difference between the two numbers.

Yes

String

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

StoreSplitString

This action splits the string based on the specified delimiter and stores a particular instance from the splits into a variable.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

Enter the key name under which instance of the split string will to be stored.

Yes

String

mainString

Enter the string which you want to split.

Yes

String

Delimiter

Enter the delimiter which you want to use while splitting the mainString.

(info) If the delimiter is a java special character, ensure you escape the character using backslash (\) prior to the delimiter character.

Yes

String

instance

The instance of the split string that is required.

Yes

String

Example:
StoreSplitString                "SplitKey"                    "This. is. a. test"              "\."                     "3"

Here, in the example above, the delimiter character is period (.) which is given with the escape character backslash (\).

MaximizeBrowser

This action maximises 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

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.

Yes

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.

Yes

String

Example:

SelectFrame                        "mainFrame"               "name"

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

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

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"

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

startDate

Enter the start date which needs to be verified.

Yes

String

startformat

Enter the format of the start given date.

Yes

String

endDate

Enter the end date which needs to be compared with the start date.

Yes

String

endFormat

Enter the format of the end given date.

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.

Yes

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

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

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

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

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.

Yes

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

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

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

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 path of the file. 

Yes

String

Example:

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

Multiexcerpt macro
nameAttachFile-Note

This action is designed to upload files from the local directory when executing the test case. In case your test execution environment is other than Local, such as Remote, Sauce, Perfecto, and so on, files will be uploaded from where you initiate the test case execution.
Also, execution of this action highly depends on the browser and driver version you are using.

For example: On Sauce Labs, this action found working seamlessly on Google Chrome version 60 and below and Mozilla Firefox version 47 and below with their default drivers. If the Google Chrome browser version is 61 to 64, you must use chromedriver version 2.29 for this action to work. This action does not work with Mozilla Firefox version 48 and above, Internet Explorer, and Safari browsers.

These findings are tested and verified at the time of documenting this information and are subject to change based on the changes made to the respective browser and driver versions.


ExecuteQueryAndStoreInFile

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

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

  1. For text file - .txt
  2. For xml file- .xml
  3. For excel file- .xls

The databases tested are my sql 5.1, Oracle 10g,MS Access, SQL Server 2008.

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

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.

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

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

firstFile

The complete location of the first file to be compared

Yes

String

secondFile

The complete location of the second file to be compared

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

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

firstArray

The first array whose items are separate by carat (^) operator.

No

Array

secondArray

The second array whose items are separate by carat (^) operator.

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

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

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 

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/element which will populate a download window, and then downloads the file.
The action supports and is explicitly tested for FF3, IE7, IE8. The action will not wait till the file is downloaded, this has to be handled externally by the user.
This action requires AutoIt to be installed.

  1. Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
  2. Click on Download AutoIt v3.
  3. Choose full installation.
  4. After the set up is completed, AutoIT installation path should be set against the Qualitia's configfile key "AutoITPath"

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

folderName

The path where the file is to be download. Please check Table 1 "Parameter Mandate" to validate in the situation where this parameter will be mandatory. In case the parameter Mandatory; the user should take care that the folder path exists. The action does not validates whether the folder exist

Yes

String

Filename

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

No

String


Example:



Example  DownloadFile               "C:/ProgramData"           "Qualitia" 

 This action is tested on IE8, FF & chrome. This action is not supported on IE9, IE10, and Google Chrome <16.

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

Key

Enter the key in which the message will be stored.

Yes

String

Example:
AcceptDialogAndStoreMessage                  "AlertMessage"

WriteToBuildProperty

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

propertyName

Property name to be written in qer.properties file

Yes

String

propertyValue

Property value to be written in qer.properties file

Yes

String

Example:
WriteToBuildProperty             "propertyName"                 "propertyValue"

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

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

Multiexcerpt include macro
nameWindowsAuthenticationLogin
pageDOC:General Web Actions

MinimizeWindow

This action minimizes the window.

This action does not have any parameter. 

Example:

Minimizes

SetPageLoadTimeout

This action sets the page load timeout when executing test cases. The time set here overrides the Page Timeout set under Configuration Settings > Execution.  

Input Parameters:

Parameter NameParameter DescriptionMandatoryData Type
timeoutinSecondsEnter the expected timeout to load the page.  YesString

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 NameParameter DescriptionMandatoryData Type
keyPageSourceEnter the key name to store the page source in.   YesString

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

strKey

Enter the key name to store the window handle.

Yes

String

indexEnter the index of the page whose handle you want to store.YesString

Example : 

StoreWindowHandleAtIndex              "Key"                   "4"

WaitForNumberOfWindowsToBe

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

Input Parameters:

Parameter Name
Parameter Description
Mandatory
Data Type
expectedNumber Enter expected number of windows.   YesString
timeOutEnter the timeout (in seconds) to wait. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check whether the specified count has reached. NoString
keyNumOfWindowsEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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 NameParameter DescriptionMandatoryData Type
widthEnter the expected width of the window in pixel. YesString
heightEnter the expected height of the window in pixel. YesString


Info

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

Example:

SetWindowSize          "1344"             "689"

StoreWindowSize

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 NameParameter DescriptionMandatoryData Type
KeyHeightEnter the key name to store the height of the window.YesString
KeyWidthEnter the key name to store the width of the window.YesString

Example:

StoreWindowSize          "Height"             "Width"

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 NameParameter DescriptionMandatoryData Type
keyXPositionEnter the key name to store the X coordinate.YesString
keyYPositionEnter the key name to store the Y coordinate.YesString

Example:

StoreWindowPosition          "XCordinateValue"             "YCordinateValue"

SetWindowPosition

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

Input Parameters:

Parameter NameParameter DescriptionMandatoryData Type
xPositionEnter the x coordinate of the position to set.YesString
yPositionEnter the x coordinate of the position to set.YesString

Example:

SetWindowPosition          "123"             "232"

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.

Info

Selenium requires a click action to be performed in case this (RightClick) action is used two times in a single test case. In case you do not use any click action between two RightClick actions, the second instance of the RightClick will not be visible.


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
frameIndexEnter the index of the frame which you want to wait and select for. Index starts at 0.   YesString
timeOutEnter the timeout (in seconds) to wait for the frame. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for the frame before exhausting timeout. NoString
keyEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
JavaScriptStringEnter the JavaScript code to run. YesString
keyReturnValueEnter the key under which the javascript return value will be stored. The key value can be retrieved using the key name. NoString
timeOutEnter the timeout (in seconds) to wait for the value. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for the value before exhausting timeout. NoString
keyStatusEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
JavaScriptStringEnter the JavaScript code to run. YesString
timeOutEnter the timeout (in seconds) to wait for the exception. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for the execption before exhausting timeout. NoString
keyJSThrowsExceptionStatusEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

Example:

WaitForJSThrowsNoExceptions       ""          "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
titleEnter the expected partial value of the web page title.YesString
timeOutEnter the timeout (in seconds) to wait for the expected value. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. NoString
keyTitleContainsEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
titleEnter the expected partial value which should not be in the web page title. YesString
timeOutEnter the timeout (in seconds) to wait for the expected value. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. NoString
keyTitleNotContainsEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
titleEnter the expected exact value of the web page title.YesString
timeOutEnter the timeout (in seconds) to wait for the expected value. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. NoString
keyTitleToBeEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
titleEnter the expected exact value which should not be in the web page title. YesString
timeOutEnter the timeout (in seconds) to wait for the expected value. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. NoString
keyTitleNotToBeEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
titleEnter the expected partial value of the web page URL. YesString
timeOutEnter the timeout (in seconds) to wait for the expected value. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. NoString
keyURLContainsEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
titleEnter the expected partial value which should not be in the web page URL. YesString
timeOutEnter the timeout (in seconds) to wait for the expected value. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the expected value before exhausting timeout. NoString
keyURLNotContainsEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
urlEnter the expected the web page URLYesString
timeOutEnter the timeout (in seconds) to wait for the expected URL. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the expected URL before exhausting timeout. NoString
keyURLToBeEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
urlEnter the URL which should not be the web page URL.YesString
timeOutEnter the timeout (in seconds) to wait for the URL to change. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the URL before exhausting timeout. NoString
keyURLNotToBeEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
urlEnter the expected pattern for the URL. Pattern should be regular expression. Step fails in case the pattern is invalid.YesString
timeOutEnter the timeout (in seconds) to wait for the URL to change. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the URL before exhausting timeout. NoString
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.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
textToSendEnter the text you want to send in the alert. YesString
timeOutEnter the timeout (in seconds) to wait for the alert. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the alert before exhausting timeout. NoString
keyAlertAvailableEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

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
Data Type
behavior

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.  
YesString
timeOutEnter the timeout (in seconds) to wait for an alert. NoString
pollingIntervalEnter the frequency (in milliseconds) after which you want to check for existence of the alert before exhausting timeout. NoString
keyAlertAvailableEnter the key name under which the status of this step will be stored. Stores 0 for Pass, 1 for Fail, and 2 for Defect.NoString
statusIfConditionNotSatisfiedEnter 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.NoString

Example:

WaitForAlertAndSpecifyBehavior      "accept"          "5"          "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

answer

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

Yes

String

Example:

AnswerForNextDialog           "Hello"

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

waitTime

Enter the number of seconds to wait.

Yes

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.

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

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.

Yes

String

startIndex

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

Yes

String

endIndex

The number of characters required in the string.

Yes

String


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