Document toolboxDocument toolbox

A new version of Qualitia Automation Studio 7.2.x is now available. We highly recommend you upgrade. Find more details here.

Qualitia Web Actions

General Class

OpenURL

This action opens the specified url in the selected browser.

Input Parameters:

ParameterName

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

Example:

NavigateForward

NavigateBack

This action navigates the browser to the previous page.

This action does not have any parameters.

Example:

NavigateBack

StorePageURL

This action stores the page URL under the key name. 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 page title under the key name. 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 in a variable (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 to store variable.

Yes

String

data

Enter the data to be stored.

Yes

String

Example:

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

SecureStoreVariable

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in 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="

Sleep

This action introduces a 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 an 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

The number of seconds to wait for

Yes

String


Example:
Sleep                   "20"

SelectPage

This action selects a popup browser window using a window name as the locator; once the popup window is selected, all commands are sent to the selected page/window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

windowName

This is the name of the window on which the actions need to be performed.
To select the main browser window again, use "null" as the windowName.

Yes

String


Example:

Select Page                            "Name"

ClosePopUpBrowser:

This action closes the popup on from the browser.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

windowName

This is the name of the window which needs to be closed

The data type of this parameter is String

Yes

String


Example:
ClosePopUpBrowser                    "viewPage"

PressKeys:

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

Note: This action is applicable only for desktop web applications.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

The key to be pressed for the browser window

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} then 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             "^",
  • 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.

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:
Key  Special Character
SHIFT  +
CTRL  ^
ALT  %
Note: 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.

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


StoreSubString:

This action stores a substring of a string into a variable.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

The variable in which the substring is to be stored

Yes

String

strMainString

The string whose substring is to be stored

Yes

String

intStart

The index of the string from where the substring is to be fetched

Yes

String

intLength

The number of characters required in the string.

Yes

String


Example:
StoreSubString                   "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

String 1 to be compared
Even a key name can be passed here enclosed in braces
Data type of this parameter is alphanumeric

Yes

String

mainString

String 2 to be compared. Even a key name can be passed here enclosed in braces.
Data type of this parameter is alphanumeric.

Yes

String

caseSensitive

The kind of comparison to be done
If True  - Case sensitive comparison
If False – 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.

 Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

MainString

The main String in which the substring will be searched for.
Even a key name can be passed here enclosed in braces.
Data type of this parameter is alphanumeric.

Yes

String

Substring

The string to be searched for in the main string.
Even a key name can be passed here enclosed in braces.Data type of this parameter is alphanumeric.

Yes

String

caseSensitive

This can be set as True or False.
If True  - Case sensitive comparison
If False – 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 substring is found in the main string, else it will return 2 if the substring 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

Verifies that the data passed by the user matches the pattern specified by the user . Match can either be case sensitive or insensitive.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Pattern

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

Yes

String

Data

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

Yes

String

caseSensitive

The data type can be set as true or false.
If True  - Case sensitive comparison
If False – 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 validates it with the expected difference value.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Int1

Enter the interger 1 to verify difference.

Yes

Integer

Int2

Enter the interger 1 to verify difference.

Yes

Integer

difference

The expected difference between the two integers

Yes

String

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

StoreSplitString

This action splits the string based on the specified delimiter character and stores the value that is contained between its previous occurrence of the delimiter 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. This can be any alphanumeric or special character.

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

In case there are multiple delimiter characters in the mainString, it stores string backwardly from the specified delimiter up to the next instance of the delimiter character. (see example for more details)

Yes

String

instance

Enter the occurrence of the item which you want to store under the specified key. The instance starts from 1.

Yes

String

Example:

StoreSplitString                "spaceKey"                    "https://my.atlassian.net/wiki/rest/api/content?spaceKey=QASM=limit=500&start=0"              "="                     "2"

Here, the delimiter is =, as there are multiple occurrences of =in the mainString,,  after this action is executed, the text between 2nd and 1st delimiter character (QASM) will be stored under the specified key spaceKey

MaximizeBrowser

This action maximizes the  browser.

Example:

MaximizeBrowser

SelectFrame

This action selects a frame within the current window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

locator

This locator can have the values of the frame's: Id, Name, Xpath, css

Yes

String

locatorType

This is the type of locator used. It can be Id, name, xpath, 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 in a variable.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Format

This parameter specifies the format in which the current date is to be stored. The valid formats are of the form dd for day, MM for month and yyyy for year. The combination of the same shall be the date format.
E.g.: 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

The variable in 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 in a key.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

date

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

Yes

String

Format

This parameter specifies the format of the date provided by the user.
The valid formats are of the form dd for day, MM for month and yyyy for year. The combination of the same shall be the date format.
E.g.: 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

The variable in which the date in the new result format 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

The start date which needs to be verified.

Yes

String

startformat

The format of the start date given by the user.

Yes

String

endDate

The end date which needs to be verified with the start date.

Yes

String

endFormat

This is the format of the end date.

Yes

String

operation

Operation to be performed between the first and second dates ("<,>,==,!=").

Yes

String


Example:

  • To verify if the first date is less than (comes before) the second date use the operation "<"
  • To verify if the first date is greater than (comes after) the second date use the operation ">"
  • To verify if the dates are equal use the operation "=="
  • To verify if the dates are not equal use the operation "!="


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

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

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. 

ChangeDateAndStore

This action modifies the day/month/year by the number specified by the user. The resulting date shall be stored in a key in the same format as the input date.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

date

The date which needs to be changed

Yes

String

format

The format of the date given by the user.

Yes

String

dayValue

Value by which the day needs to increased/decreased. E.g.: "1","-3"

Yes

String

monthValue

Value by which the month needs to increased/decreased. E.g.: "0","-3"

Yes

String

yearValue

Value by which the year needs to increased/decreased. E.g.: "1","-3"

Yes

String

key

Variable in which the modified date is 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 two dates and stores the difference in a key
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

startDate

The start date given by the user.

Yes

String

startformat

The format of the start date given by the user.

Yes

String

endDate

The end date given by the user.

Yes

String

endFormat

The format of the end date.

Yes

String

key

Variable in which the difference in days is 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.

If True – checks if the alert is present
If False – checks if the alert is not present

Yes

String


Example:
VerifyDialogExistence                       "True"

AnswerForNextDialog

This action sets the input as the answer for the next prompt. After setting the answer, webdriver by default may cancel the prompt. So for the input to be accepted in the prompt, this action should be used followed by the action "AcceptDialog"

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

answer

The input that to be set in the next prompt

Yes

String

Example:

AnswerForNextDialog           "hello"

AcceptDialog

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

This action does not have any parameters.

Example:
AcceptDialog

DismissDialog

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

This action does not have any parameters.

Example:
DismissDialog

StoreDialogText

This action stores the message on the alert/prompt/confirmation pop up in a key.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the pop up message is to be stored.

Yes

String

Example:

StoreDialogText               "message"

ExecuteFile

This action executes the batch file specifies by the user.


Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

batchFile

The absolute path of the file to be executed. Value with whitespace in this parameter is not accepted.

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

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

Yes

String

locatorType

The type of locator used for the locator of the file input object.
This could be Id, xpath, name, css class.

Yes

 String

filePath

The absolute path of the file. It is assumed that the file exists.

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, 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"
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 MSExcel or a kingsoft excel sheet. A link is generated in the log file. On clicking on the link, the excel sheet opens in which the difference in the data is displayed. This action compares the following file types which contain the DB results. These files contain the results after executing the queries using the actions "ExecuteQueryAndStoreInFile" or "StoreTableData". The 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 files types supported are
MSExcel
This parameter is for future enhancements

NO

"MSExcel"

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 in a key.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expression

The expression to be evaluated

Yes

String

strKey

The key on which the result of the evaluation need to 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
i.e 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 Sublist of the first. The sublist 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 i.e it will not check if the first array is a sublist of the seconds array.This case will fail.

NO

Exact


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

For every window in the application, this action will have to be used.
For example: If the windows have the following order
Login Window------New child window 2 ------- then this action will have to be used for all the 3 windows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strKey

The key on which the handle of the window need to be stored

Yes

String


Example :
Object1                                   Click
StoreWindowHandles            "new window"
SelectPage                              "{new window}"
EditObjectOnNewPage           Set                 Testing
In the above example, 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

If this action in used, execution of next step is skipped and execution continues with the next task.

This action is not available for test case level step.

This action does nothave any parameters.

Example:

ExitTask

ExitTCIteration

If this action is used, execution will skip 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 parameters.

Example:

ExitTCIteration

ExitSuite

If this action is used, execution will stop and no further test cases will be executed.

This action does not have any parameters.

Example:

ExitSuite

VerifyLinkOnPage

This action verifies if the link is present 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"

DragAndDropToObject

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

dragLocator

Locator of an element to be dragged.

Yes

String

dragLocatorType

Locator type of the element to be dragged.

Yes

String

dropToLocator

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

Yes

String

dropToLocatorType

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

Yes

String

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

WindowsAuthenticationLogin

Using this action, the user can login into applications that have basic authentication window. This action supports Internet Explorer and Firefox browsers only. Selenium does not support such window by default.

This action is applicable only for desktop web applications. 
This action use AutoIT to interact with the authentication windows. It Mandatory to install AutoIT to run this action. All the actions dependent on AutoIT are sensitive to the object focus.

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

url

The url of the application to be navigated

Yes

String

Username

The correct/valid username to logon

Yes

String

Password

The correct/valid password to logon

Yes

String

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

Note: This action is tested on IE9 and FF23

StoreChildCount

This action stores the child count for the given 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

The variable/key in which the count will be stored.

Yes

String

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

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 have to be handle 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

locator

The download link/element which is to be click.

Yes

String


locatorType

The type of locator used for the locator of the file input object. This could be Id, xpath, name, css class

Yes

String

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 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. This parameter is not mandatory

NO

String


 Important Notes:


1. During execution, IE blocks download window. You will get a similar message below. 
 
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads. 
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669 
2. When a download window is populated, the following window will also exist. 
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.

Important Notes for Firefox: 
Firefox uses the default Firefox instance:- 
 
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
 


Table 1: Parameter Mandate

Browser

locator

folderPath

fileName

Internet Explorer

Mandatory

Mandatory

Not mandatory

Firefox [Default instance invoke my Selenium]


Above is the default download setting in the default Firefox instance invoke my Selenium.

Mandatory

Mandatory

Not mandatory


Example

DownloadFile "//a[@id='Download']" "xpath" "D:\Download" "xyz.zip"
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.

WaitForPageToLoad

This actions waits for the page to load for the specified number of seconds. If the wait time is "" then the wait time is the "SyncTime" time set on the Qualitia Configuration (Execution) window. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

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.

RefreshPage

This action simulates the user clicking the Refresh button of the current page selected.

Example:
RefreshPage

DeleteCookiesOnCurrentDomain

This action deletes all the cookies that are visible to the current domain. 

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 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 clicks the OK button on the dialog appeared on the Webpage and stores the message in the key. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Enter the Key in whcich 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"

WebFile

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

AttachFile

This action selects the specified file. 

This action is applicable only for desktop web application.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

filePath

Enter the absolute path of the file to be attached.

Yes

String

Example:
AttachFile                   "c:/Folder/test.txt"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value of this parameter can be true or false.
If True – checks if the edit box is enabled
If False – checks if the edit box is disabled

Yes

String

Example:
VerifyEnability                          "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the edit box is visible 
If False – checks if the edit box is not visible

Yes

String

Example:
VerifyVisibility                      "True"

StorePropertyValue

This action stores the property of the specified object under the key name. The stored value can be retrieved using the key name.

Some Android and iOS properties are not accessible.

List of accessible properties for Android: "name","contentDescription","className","resourceId","text","enabled","checkable","checked","clickable","focusable","focused","longClickable","scrollable","selected","displayed"

List of accessible properties for iOS: "name", "value", "label", "hint"

Input Parameters:

ParameterName

Parameter Description

Mandatory

Data Type

Key

Variable in which the property value will be stored

Yes

 String

Property

Property/attribute name whose value needs to be stored in "Key". This can be any accessible property of Android/iOS native object.

Yes

 String


Example
:

StorePropertyValue                            "key"                     "text"

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false. 
If True – checks if the edit box exists 
If False – checks if the edit box does not exist

Yes

String


Example
:

VerifyExistence                      "True"

StoreExistence

This action stores existence of the object under a key. 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 existence (true/false) of the object is stored.

Yes

String

Example:

StoreExistence                               "Key"

StoreChildCount

This action stores the child count for the specified object under the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable/key in which the count will be stored.

Yes

String

Example
StoreChildCount                     "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

WebEdit Class

Set

This action enters the expected value into the specified edit box.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

strValue

Value which will be entered into the specified edit box.
The data type of this parameter is Alphanumeric. It allows digits as well as characters.

Yes

String

Example:
Set                            "Qualitia"

ClearText

This action clears the text present in the specified object (can be a text box).

This action does not have any parameters.

Example:

ClearText

SecureSet

This action enters the expected value into the specified edit box. The value set in the parameter is encrypted once the focus is moved for security purposes.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Text

Needs to use Encrypt to enclose the Text that needs to be secured

NO

String

Example:
SetSecure "Encrypt(Abc)"
When the focus is moved away from the parameter Qualitia will automatically encrypt the data ABC and result in a secured text like "vHpmlfI4R3PQkCN4sZnuqw==þNWE3ZDdkNjE3N2JmNDM2ODgxMzQwYWI1MTA3YWNjMDc="

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false.
If True – checks if the edit box exists
If False – checks if the edit box does not exist

Yes

String


Example:
VerifyExistence                      "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the edit box is visible
If False – checks if the edit box is not visible

Yes

String

Example:
VerifyVisibility                      "True"

Click

This action clicks the edit box.

Example:
Click

StorePropertyValue

This action stores the property of the specified object under the key name. The stored value can be retrieved using the key name.

Some Android and iOS properties are not accessible.

List of accessible properties for Android: "name","contentDescription","className","resourceId","text","enabled","checkable","checked","clickable","focusable","focused","longClickable","scrollable","selected","displayed"

List of accessible properties for iOS: "name", "value", "label", "hint"

Input Parameters:

ParameterName

Parameter Description

Mandatory

Data Type

Key

Variable in which the property value will be stored

Yes

 String

Property

Property/attribute name whose value needs to be stored in "Key". This can be any accessible property of Android/iOS native object.

Yes

 String

Example:
StorePropertyValue                            "key"                     "text"

StoreText

This action stores the text entered in an edit box into a variable. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the text is stored

Yes

String

Example:
StoreText                   "textKey"

SetFocus

This action sets the focus to the specified edit box.

Example:
SetFocus

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value of this parameter can be true or false.
If True – checks if the edit box is enabled
If False – checks if the edit box is disabled

Yes

String

Example:
VerifyEnability                          "True"

ClickAt

This action clicks at a particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example
ClickAt                               "5"               "10"

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example
WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

ClickAndWait

This action clicks the edit box and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.


StoreExistence

This action stores existence of the object under a key. 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 existence (true/false) of the object is stored.

Yes

String


Example:
StoreExistence                               "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

WebButton Class

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

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 have to be handle 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


 Important Notes:


1. During execution, IE blocks download window. You will get a similar message below. 
 
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads. 
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669 
2. When a download window is populated, the following window will also exist. 
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.

Important Notes for Firefox: 
Firefox uses the default Firefox instance:- 
 
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
 


Table 1: Parameter Mandate

Browser

locator

folderPath

fileName

Internet Explorer

Mandatory

Mandatory

Not mandatory

Firefox [Default instance invoke my Selenium]


Above is the default download setting in the default Firefox instance invoke my Selenium.

Mandatory

Mandatory

Not mandatory


Example
 
DownloadFile               "C:/ProgramData"           "Qualitia" 
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false. 
If True – checks if the edit box exists 
If False – checks if the edit box does not exist

Yes

String


Example
:

VerifyExistence                      "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the edit box is visible 
If False – checks if the edit box is not visible

Yes

String

Example:
VerifyVisibility                      "True"

StorePropertyValue

Click

This action clicks the specified object.

This action does not have any parameter.

Example:
Click

StorePropertyValue

This action stores the property of the specified object under the key name. The stored value can be retrieved using the key name.

Some Android and iOS properties are not accessible.

List of accessible properties for Android: "name","contentDescription","className","resourceId","text","enabled","checkable","checked","clickable","focusable","focused","longClickable","scrollable","selected","displayed"

List of accessible properties for iOS: "name", "value", "label", "hint"

Input Parameters:

ParameterName

Parameter Description

Mandatory

Data Type

Key

Variable in which the property value will be stored

Yes

 String

Property

Property/attribute name whose value needs to be stored in "Key". This can be any accessible property of Android/iOS native object.

Yes

 String


Example
:

StorePropertyValue                            "key"                     "text"

SetFocus

This action sets the focus on the specified object.

This action does not have any parameters. 

Example:
SetFocus

MouseOver

This action simulates a user hovering a mouse over the specified button.

Example:
MouseOver

MouseDown

This action simulates the user pressing the left mouse button at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The x-coordinate of the click.

Yes

String

Example:

MouseDown "5" "10"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value of this parameter can be true or false.
If True – checks if the edit box is enabled 
If False – checks if the edit box is disabled

Yes

String

Example:
VerifyEnability                          "True"

MouseUp

simulates the event that occurs when the user releases the mouse button.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The x-coordinate of the click.

Yes

String


Example
MouseUp         "5"          "10"

ClickAt

This action clicks at a particular point on the object.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The x-coordinate of the click.

Yes

String

Example
ClickAt        "5"            "10"


WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

ClickAndWait

This action clicks the edit box and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.


ClickandchooseOkOnNextConfirmation

This action clicks a button. After clicking the button, if an alert or confirmation comes up this action will accept it by clicking on Ok. If the button is clicked and no alert or confirmation comes up the action will fail.

This action does not have any parameter.

Example:
ClickandchooseOkOnNextConfirmation

StoreExistence

This action stores existence of the object under a key. 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 existence (true/false) of the object is stored.

Yes

String

Example:

StoreExistence                               "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

WebCheckBox Class

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView


VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false. 
If True – checks if the edit box exists 
If False – checks if the edit box does not exist

Yes

String


Example
:

VerifyExistence                      "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the edit box is visible 
If False – checks if the edit box is not visible

Yes

String

Example:

VerifyVisibility                      "True"

IsChecked

This action verifies that specified check box is selected.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

state

The value of this parameter can be true or false.

If True – checks if the checkbox is selected
If False – checks if the checkbox is deselected

Yes

String

Example:
IsChecked                           "true"

Check

This action selects the specified check box.

This action does not have any parameter.

Example:
Check

UnCheck

This action deselects the specified check box. 

This action does not have any parameter.

Example:
UnCheck

Click

This action clicks the specified check box. 

This action does not have any parameter.

Example:
Click

StorePropertyValue

This action stores the property value of the specified object under the key name. The stored value can be retrieved by using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored.

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.

This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue               "value"               "name"

SetFocus

This action sets the focus to the specified check box.

Example:
SetFocus

SelectByIndex

This action selects the specified checkbox based on its index number. The indexes start from 1.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

groupName

The group name to which the checkbox belongs. This is the name attribute in html.

Yes

String

index

Index of the checkbox in the group. Index starts at 1.

Yes

String

Example:

SelectByIndex                               "Occupation"              "3"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value of this parameter can be true or false.
If True – checks if the edit box is enabled 
If False – checks if the edit box is disabled

Yes

String

Example:

VerifyEnability                          "True"

ClickAt

This action clicks at a particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example

ClickAt                               "5"               "10"

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

CheckIfTrue

This action selects the checkbox, only if the parameter passed is true.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

check

Value of this parameters can be true or false.


Yes

String

Example
CheckIfTrue                        "TRUE"

ClickAndWait

This action clicks the object and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.

StoreExistence

This action stores existence of the object under a key. 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 existence (true/false) of the object is stored.

Yes

String

Example:

StoreExistence                               "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

WebRadioButton Class

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false. 
If True – checks if the edit box exists 
If False – checks if the edit box does not exist

Yes

String

Example:
VerifyExistence                      "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the edit box is visible 
If False – checks if the edit box is not visible

Yes

String


Example:

VerifyVisibility                      "True"

IsSelect

This action verifies whether the specified radio button selected or not.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

state

Value of this parameter can be true or false.
If True – checks if the edit box is visible 
If False – checks if the edit box is not visible

Yes

String

Example:
IsSelect                        "true"

Select

This action selects the specified radio button.

Example:
Select

Click

This action clicks the specified radio button.

Example:
Click

StorePropertyValue

This action stores the property value of the specified property name of an object against a key name. The stored value can be retrieved by using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                                    "value"                 "name"

SetFocus

This action sets the focus to the specified object. 

Example:
SetFocus

SelectByIndex

This action selects the specified radio button based on its index number. The indexes start from 1. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

groupName

The group name to which the radio button belongs. This is the name attribute in html.

Yes

String

index

Index of the radio button in the group. Index starts at 1

Yes

String

Example:
SelectByIndex                                  "Selection"        "3"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value of this parameter can be true or false.
If True – checks if the edit box is enabled 
If False – checks if the edit box is disabled

Yes

String

Example:
VerifyEnability                          "True"

ClickAt

This action clicks at a particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

ClickAt                               "5"               "10"

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

SelectIfTrue

This action selects the radio button, only if the parameter passed is true.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

check

This is a boolean parameter and accepts either true/false only,
irrespective of the case.

NO

TRUE

Example
SelectIfTrue "TRUE"

ClickAndWait

This action clicks the edit box and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.

ClickandchooseOkOnNextConfirmation

This action clicks a radio button. After clicking the radio button, if an alert or confirmation comes up this action will accept it by clicking on OK. If the radio button is clicked and no alert or confirmation comes up the action will fail.

Example:
ClickandchooseOkOnNextConfirmation

StoreExistence

This action stores existence of the object under a key. 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 existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                               "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

WebImage Class

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 have to be handle 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. This parameter is not mandatory

Yes

String


 Important Notes:


1. During execution, IE blocks download window. You will get a similar message below. 
 
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads. 
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669 
2. When a download window is populated, the following window will also exist. 
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.

Important Notes for Firefox: 
Firefox uses the default Firefox instance:- 
 
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
 


Table 1: Parameter Mandate

Browser

locator

folderPath

fileName

Internet Explorer

Mandatory

Mandatory

Not mandatory

Firefox [Default instance invoke my Selenium]


Above is the default download setting in the default Firefox instance invoke my Selenium.

Mandatory

Mandatory

Not mandatory


Example
 
DownloadFile               "C:/ProgramData"           "Qualitia.txt" 
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.


VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false. 
If True – checks if the edit box exists 
If False – checks if the edit box does not exist

Yes

String

Example:

VerifyExistence                      "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the edit box is visible 
If False – checks if the edit box is not visible

Yes

String

Example:

VerifyVisibility                      "True"

Click

This action clicks the specified object. 
Example:
Click

StorePropertyValue

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.

This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                                        "value"                     "name"

SetFocus

This action sets the focus to the specified object.

Example:
SetFocus

MouseOver

This action simulates the user hovering mouse over the specified object. 
Example:
MouseOver

MouseDown

This action simulates the user pressing the left mouse button at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The Y-coordinate of the click.

Yes

String


Example:
MouseDown                                   "5"                             "10"

MouseUp

This action simulates the event that occurs when the user releases the mouse button.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The Y-coordinate of the click.

Yes

String

Example:

MouseUp                       "45"                "56"


ClickAt

This action clicks at a particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The Y-coordinate of the click.

Yes

String

Example
ClickAt                     "5"                     "10"

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

DragAndDrop

This action drags an image to a certain distance and drops it.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

offsetX

Offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10,…

Yes

String

offsetY

offset in pixels from the current location to which the element should be moved The offset parameter can be as -100,100 , +100

Yes

String

Example
DragAndDrop                                       "-100"                             "500"

ClickAndWait

This action clicks the edit box and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.


StoreExistence

This action stores the existence of an object 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 in which the existence (true/false) of the object is stored.

Yes

String


Example:
StoreExistence                             "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

WebLink Class

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 have to be handle 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. This parameter is not mandatory

Yes

String


 Important Notes:


1. During execution, IE blocks download window. You will get a similar message below. 
 
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads. 
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669 
2. When a download window is populated, the following window will also exist. 
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.

Important Notes for Firefox: 
Firefox uses the default Firefox instance:- 
 
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
 


Table 1: Parameter Mandate

Browser

locator

folderPath

fileName

Internet Explorer

Mandatory

Mandatory

Not mandatory

Firefox [Default instance invoke my Selenium]


Above is the default download setting in the default Firefox instance invoke my Selenium.

Mandatory

Mandatory

Not mandatory


Example
 
DownloadFile               "C:/ProgramData"           "Qualitia" 
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value for this parameters can be true or false. 
If True – checks if the edit box exists 
If False – checks if the edit box does not exist

Yes

String

Example:
VerifyExistence                      "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the edit box is visible 
If False – checks if the edit box is not visible

Yes

String

Example:

VerifyVisibility                      "True"


Click

This action clicks the specified object.
Example:
Click

StorePropertyValue

This action stores the property of the specified object under the key name. The stored value can be retrieved using the key name.

Some Android and iOS properties are not accessible.

List of accessible properties for Android: "name","contentDescription","className","resourceId","text","enabled","checkable","checked","clickable","focusable","focused","longClickable","scrollable","selected","displayed"

List of accessible properties for iOS: "name", "value", "label", "hint"

Input Parameters:

ParameterName

Parameter Description

Mandatory

Data Type

Key

Variable in which the property value will be stored

Yes

 String

Property

Property/attribute name whose value needs to be stored in "Key". This can be any accessible property of Android/iOS native object.

Yes

 String


Example
:

StorePropertyValue                            "key"                     "text"

SetFocus

This action sets the focus to the specified object.
Example:
SetFocus

MouseOver

This action simulates the user hovering mouse over the specified object.


Example:

MouseOver

MouseDown

This action simulates the user pressing the left mouse button at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The x-coordinate of the click.

Yes

String

Example:

MouseDown "5" "10"

MouseUp

This action simulates the event that occurs when the user releases the mouse button.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The x-coordinate of the click.

Yes

String

Example:

MouseUp              "5"       "10"

ClickAt

This action clicks at a particular point on the object

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate of the click.

Yes

String

Y

The x-coordinate of the click.

Yes

String

Example:

ClickAt "5" "10"

ClickIfExists

This action clicks the object if the specified object exists. .
Example
ClickIfExists

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.


DragAndDrop

This action drags the specified object to a certain distance and drops it.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

offsetX

Offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10,…

NO

0

offsetY

offset in pixels from the current location to which the element should be moved. The offset parameter can be as -100,100 , +100

NO

0


Example
DragAndDrop                       "-100"                "500"

ClickAndWait

This action clicks the edit box and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.


ClickandchooseOkOnNextConfirmation

This action clicks the specified object. After clicking the object, if an alert or confirmation comes up this action will accept it by clicking on OK. If the link is clicked and no alert or confirmation comes up the action will fail.

Example:
ClickandchooseOkOnNextConfirmation

RightClick

This action right-clicks the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

The context menu option number that needs to be clicked.

Yes

String


Example
RightClick       "3"
Note: This will select the third option from the context menu.

StoreExistence

This action stores existence of the object under a key. 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 existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                               "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

WebListClass

SelectItems

This action selects particular item or items from a list. Multiple items for selection can be given only for the list box that has multiple selection property.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

item

The name of the item(s) as it appears in the list.
To give multiple items, the items need to be separated using carat (^) operator.

NO

Array

Example:
SelectItem                                         "England^India^Australia"

Consider a list containing names of countries. If it contains list items "India", "England", "Australia" and the user wishes to select "England", then this action can be used as follows. If an empty data ("" or $NULL$) is passed as the data, the action will be passed only if there exist an item "" in the webList to be selected.

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value of this parameter can be true or false.
If True – checks if the object exists
If False – checks if the object does not exist

Yes

String


Example:
VerifyExistence                                      "True"

VerifyVisibility

This action verifies the visibility of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the object is visible
If False – checks if the object is invisible

Yes

String

Example:
VerifyVisibility                             "True"

VerifyItemsExist

This action verifies the existence of the objects in the specified list. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

Items that need to be verified in the list
Data Type for this parameter is Array and each item needs to be separated with caret operator (^).
This action checks if the given items are a sublist of the actual items in the list

Yes

Array

existence

Value of this parameter can be true or false.
If True – checks if the object exists
If False – checks if the object does not exist

Yes

String

Example:
Consider a list containing names of countries "India", "Australia", "England", "South Africa". If the user wishes to verify if India, England, South Africa are in the list , then this action can be used as follows:
VerifyItemsExist "India^South Africa^England""true"
Note:

  1. "^" in Qualitia is a delimiter for items in an array.
  2. If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList.

Click

This action clicks the specified object.
Example:
Click

StorePropertyValue

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                               "value"                     "name"

SelectItemByIndex

This action selects an item from the list based on its index in the list.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

index

Specified index value of a list item that is to be selected in the list box. Index starts at 1.

Yes

Integer

Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" and the user wishes to select "Australia", then this action can be used as follows
SelectItemByIndex                         "3"

VerifyItemsInSequence

Verifies the actual sequence of items in the specified list box with the expected items sequence.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

List of multiple items in expected sequence. The multiple items are to separated by a caret (^)

Yes

Array


Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" then to verify a sequence in the list, this action can be used as follows
VerifyItemsInSequence                                               "India^England^Australia^SA"

DeSelectItems

This action deselects the specified selected item(s) from the specified list box. Multiple items for deselection can be given only for the list box that has multiple selection property.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

Expected list item(s) that are to be deselected in the list box. If multiple items are to be passed for deselection, then the list items should be separated by a caret (^).

Yes

Array


Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" , if the user wishes to deselect "India and Australia", then this action can be used as follows.
DeSelectItems                                 "India^Australia"
Note: If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList to be deselected.

VerifySelectedItems

This action verifies the selected item(s) with the expected selected item(s) list. 
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

items

List item(s) that are expected to be selected in the list box. If multiple expected items are to be passed for verification, then the list items should be separated by caret (^)

Yes

Array

Example:
Consider a list containing names of countries. If it contains list items in the order "India", "England", "Australia" , "SA" , if India and England are selected and this needs to be verified, the this action can be used as follows
VerifyMultipleSelectedListBoxItems                                       "India^England"
Note: If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" selected item in the webList.

VerifySize

This action compares the actual number of items (size) in the specified list box with the expected number of items (size).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

expectedSize

The expected size of the list box that will be compared with the actual size of the list box.
The data type of this parameter is Numeric. It allows only digits.

Yes

String

Example:
If a list contains the items "India","England,"S.A", then to verify its size this action can be used as follows.
VerifyListBoxSize                         "3"

SetFocus

This action moves the focus to the specified object. 

Example:
SetFocus

MouseOver

This action simulates users hovering the mouse over the specified object.

Example:
MouseOver

MouseUp

This action simulates the event that occurs when the user releases the mouse button.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

Y

The x-coordinate of the click.

Yes

String

X

The x-coordinate of the click.

Yes

String

Example:

MouseUp 5 10

ClickAt

This action clicks at the particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Y

The x-coordinate of the click.

Yes

String

X

The x-coordinate of the click.

Yes

String

Example:

ClickAt           "5"               "10"

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

StoreItems

This action stores all the items of a list in a key. The items in the key are separated using caret operator.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The key in which the items of the list items will be stored.

Yes

String

Example:
Consider a list having the items Monday, Tuesday, Wednesday.
StoreItems                       "Key"
The items in the key will be stored as Monday^Tuesday^Wednesday.

VerifyNoItemsDuplication

This action verifies that no items are duplicated in the list.

Example:

VerifyNoItemsDulication

Consider a list having the items Monday, Tuesday, Wednesday, Monday

The action status will be fail as the list contains duplicate item "Monday"

VerifyEnability

This action verifies the enability of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

enability

Value of this parameter can be true or false.

If True – checks if the checkbox is enabled
If False – checks if the checkbox is disabled

Yes

String

Example:
VerifyEnability                          "True"

StoreSelectedItems

This action stores all the selected items of a list in a key. The items in the key are separated using caret (^).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The key in which the selected items will be stored.

Yes

String

Example:

StoreSelectedItems                  "selectedItemsKey"

Consider a list having the items Monday, Tuesday, Wednesday, Thursday, Friday. Suppose Tuesday and Friday is selected in the list.

The items in the key will be stored as Tuesday^Friday

RightClick

This action right-clicks the particular webelement.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

Enter the context menu option number that needs to be clicked.

Yes

String


Example
RightClick         "3"

This will click the third option from the context-menu.

SelectItemAndWait

This action selects an item from the list and waits. It waits for the max sync time set in the Qualitia configuration (Execution) window for the key "Sync Time". If the page loads before the max sync time, then the action will stop waiting.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

item

Item to be selected from the list

Yes

String

Example:
Consider a list containing names of countries. If it contains list items "India", "England", "Australia" and the user wishes to select "England", then this action can be used as follows
SelectItemAndWait                      "India"

If an empty data ("" or $NULL$) is passed as the data, the action will passed only if there exist an "" item in the webList to be selected.
In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.

DragAndDrop

This action drags an object to a certain distance and drops it.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

offsetX

Offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10,…

Yes

String

offsetY

offset in pixels from the current location to which the element should be moved The offset parameter can be as -100,100 , +100

Yes

String

Example:

DragAndDrop                                       "-100"                             "500"


ClickAndWait

This action clicks the edit box and waits.It waits for the max sync time set in the Qualitia Configuration (Execution) window.

If the page loads before the maximum sync time, then the action will stop waiting.

Example:

ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.

StoreExistence

This action stores existence of the object in a variable (key).

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                        "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

WebTable Class

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Value of this parameter can be true or false.
If True – checks if the object exists
If False – checks if the object does not exist

Yes

String


Example:
VerifyExistence                                      "True"

VerifyVisibility

This action verifies the visibility of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Value of this parameter can be true or false.
If True – checks if the object is visible
If False – checks if the object is invisible

Yes

String

Example:
VerifyVisibility                             "True"

StoreColumnCount

This action stores the column count of the specified table in the specified key.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable name to store the table's column count.

Yes

String

row

The row number whose column count has to be stored.

Yes

String

Example:
StoreColumnCount                                   "key"           "2"

StoreRowCount

This action stores the row count of the specified table under the specified key.  

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable name to store the table's row count.

Yes

String


Example:
StoreRowCount                          "Key"

StoreCellText

This action stores the text of a table cell in a variable. The stored value can be retrieved using the variable name. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable name in which the cell text is to be stored.

Yes

String

Row

The row number of the cell. Row number starts at 1.

Yes

String

Column

The column number of the cell. Column number starts at 1.

Yes

String


Example:
StoreCellText                                              "cellTextKey"         "1"        "3"

ClickLinkAtCell

This action clicks the link present in the specified cell.

This is applicable for tables having same number of columns in all the rows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Link

Enter the URL to be clicked.

Yes

String

Row

The row number of the cell in which the link is present. Row number starts at 1

Yes

String

Column

The column number of the cell in which the link is present. Column number starts at 1

Yes

String


Example:
ClickLinkAtCell                         "http://www.google.com"             "2"       "3"

If Link is an empty data ("" or $NULL$), and there are multiple links in the cell, then the first link in the cell will be click. If there is only one link in the cell, then the link will be click. However, if there is no link available in the cell, the action will fail with an error message that no link is available in the cell.

StoreRowNoOfCellText

This action stores the row number of the cell having the specified data in specified column. This comparison is case-sensitive. When multiple cells in the column specified contain the expected data, then the first row number shall be stored in the variable. This can also be applicable for tables where each row in the table has different number of columns.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number is to be stored.

Yes

String

cellText

Cell data to be searched for in the table.

Yes

String

Column

Column number of the cell data to be searched for. Column number starts at 1.

Yes

String

Example:
StoreRowNoOfCellText                           "key"                   "Testing"        "2"

Click

This action clicks the specified object.

This action does not have any parameter. 

Example:
Click

StorePropertyValue

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored.

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                                                "value"          "name"

ClickImageInCell

This action clicks the specified image in the cell. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

altorindex

This can be any of the attribute of the image alt or title. This parameter can also be an index[starting from 1].
Following will be the preference in which the action will assume the incoming data:
If the data is a number
Then it will be considered as index
Else
The first preference then goes to title. If an image with specified title is found then click else search for an image with property
Alt = incoming data

Yes

String

Row

The row number of the cell in which the image is present. Row number starts at 1

Yes

String

Column

The column number of the cell in which the image is present

Yes

String

Example:
ClickImageInCell                                        "2"                "2"           "3"

StoreRowNoContainingCellText

This action stores the row number of the cell whose data contains the text specified by the user. This comparison is case-sensitive .When multiple cells in the column specified contain the expected data, then the first row no shall be stored in the variable. This can also be applicable for tables where each row in the table has different number of columns. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number is to be stored

Yes

String

cellText

Cell data to be searched for in the table

Yes

String

Column

The column number of the cell in which the data is present

Yes

String


Example:
StoreRowNoContainingCellText                              "key"           "word"         "2"

SetTextinCellEdit

This action sets text in the specified cell of the table.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

The row number of the cell in which the text is to be entered. Row number starts at 1.

Yes

String

Column

The column number of the cell in which the text is to be entered. Column number starts at 1.

Yes

String

text

The text data to be entered in the cell.

Yes

String

Example:
SetTextinCellEdit                                   "3"       "2"    "Qualitia"

SecureSetTextinCellEdit

This action sets secured text in the specified cell of the table.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

The row number of the cell in which the text is to be entered. Row number starts at 1.

Yes

String

Column

The column number of the cell in which the text is to be entered. Column number starts at 1.

Yes

String

text

Needs to use Encrypt to enclose the Text that needs to be secured

NO

String

Example:
SetTextinCellEdit        "3"            "2"        "Encrypt(Abc)"

When the focus is moved away from the parameter Qualitia will automatically encrypt the data ABC and result in a secured text like "vHpmlfI4R3PQkCN4sZnuqw==þNWE3ZDdkNjE3N2JmNDM2ODgxMzQwYWI1MTA3YWNjMDc="


DeSelectCheckBoxInCell

This action deselects the check box in the specified table cell. This can also be applicable for tables where each row in the table have different number of columns.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

The row number to refer to a particular cell of table where a checkbox is expected to be present. Row number starts at 1.

Yes

Integer

Column

The column number to refer to a particular cell of table where a checkbox is expected to be present. Column number starts at 1.

Yes

Integer

Example:
DeSelectCheckBoxInTableCell                                    "2"          "5"
This will deselect the checkbox present in the second row and the fifth column cell in the table. If the checkbox is already deselected, then the action will pass.

CompareRowData

This action compares the entire record in the specified row with the expected array data.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

Row number in which data will be compared. Row number starts from 1.

Yes

Integer

rowData

The entire row data expected to be present in a specified row.
This is an array data hence it will be de markated by ^.

Yes

Array.

Example:
Consider a table containing the data India, Australia, England in row 2. If this data needs to be verified, the action can be used as follows.

CompareTableRowData      "2"        "India^Australia^ England"

CompareColumnData

This action compares the actual data from the specified column in a table with the specified array data. This is only applicable for tables having same number of columns in all the rows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Column

Column number of table in which the data will be compared. Column starts from 1.

Yes

Integer

colData

The entire column data expected to be present in a specified column.
This is an array data hence it will be demarcated by ^.

Yes

Array

Example:
Consider a table containing the data
India, Australia, England in Column 4. If this data needs to be verified, the action can be used as follows
CompareColumnData                                    "4"         "India^Australia^ England"

VerifyDataExistenceInColumn

This action verifies whether the expected data exists in the specified column. The expected data can be sub-list of the actual column data in the table.

This is only applicable for tables having same number of columns in all the rows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Column

The column number to refer to a particular cell of table where the data is to be searched. Column number starts at 1.

Yes

Integer

data

Data to be searched in a column. Multiple items can be separated with the (^).

Yes

Array

existence

Data type of this parameter can be true or false.
If True – checks if the data exists.
If False – checks if the data does not exist.

Yes

String

Example:
VerifyDataExistenceInColumn       "2"            "Test"          "True" 

This will verify if the data Test is present in the column 2 of the table.

VerifyDataExistenceInColumn        "2"            "Test"       "False"

This will verify if the data Test is not present in the column 2 of the table.

StoreInstanceOfDataFromColumn

This action stores the number of occurrences of the specified data in columns. The data comparison is case-sensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the number of occurrences will be stored.

Yes

String 

Column

The column number to refer to a particular cell of table where the data is to be searched. Column number starts at 1.

Yes

Integer

Data

Data to be searched in a column.

Yes

String

Example:
StoreInstanceOfDataFromColumn          "result"        "3"         "Qualitia"

StoreRowNumWithRowData

This action stores the row number of the table which contains the specified row data.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

rowData

The entire row data expected to be present in a specified row.
The data needs to be separated using Caret (^).

Yes

Array

Key

The variable in which the row number is to be stored

Yes

String

Example:
Consider a table containing the data
India is in column 1 of a row,
Australia is in column 3 of the same row,
England is in column 6 of the same row,
If the row number for this entry is to be retrieved, the action can be used as follows

StoreRowNumWithRowData                                         "1^India^3^Australia^6^ England"    "rowNo"

Thus it will check the data "India" in the first column of the table, "Australia" in the third column and "England" in the 6th column in a particular row. Thus, the data needs to be present in the same row.

SelectCheckboxInCell

This action selects a checkbox from the specified cell of the table. This can also be applicable for tables where each row in the table have different number of columns.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

The row number of the cell in which the checkbox to be clicked is present. Row number starts at 1.

Yes

String

column

The column number of the cell in which the checkbox to be clicked is present. Column number starts at 1.

Yes

String

Example:
SelectCheckboxInCell          "2"         "3"

If the check box is already selected, the action will pass.

VerifyImageInCell

This action verifies that the image present in the specified cell is having the specified scr/title attribute.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

The row number of the cell in which the image is to be verified. Row number starts at 1.

Yes

String

column

The column number of the cell in which the image is to be verified. Column number starts at 1.

Yes

String

ScrTitle

Either the scr/title data of the image.
The order of precedence is, first verify the source property with the actual source, if not present then verify the title property.

Yes

String

Example:
VerifyImageIncell                             "4"          "6"         "Review"

ClickAt

This action clicks at the particular point on the object.
Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The X-coordinate of the click.

Yes

String

Y

The Y-coordinate of the click.

Yes

String

Example
ClickAt        "5"     "10"

VerifyLinkTitleAtCell

This action verifies title of link in the given cell. It does not perform an exact match. It performs a contains match.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

link

Title data of the link

Yes

String

row

The row number of the cell in which the link title is to be verified. Row number starts at 1.

Yes

String

column

The column number of the cell in which the link title is to be verified. Column number starts at 1.

Yes

String

Example
VerifyLinkTitleAtCell ClickHere                                "5"      "10"

ClickCell

This action clicks at the specified cell in the table.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

row

The row number of the cell that is to be clicked. Row number starts at 1.

Yes

String

column

The column number of the cell that is to be clicked. Column number starts at 1.

Yes

String

Example
ClickCell   "5"      "10"

ClickRadioButtonInCell

This action clicks a radio in the specified cell of the table. This can also be applicable for tables where each row in the table has different number of columns.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

row

The row number of the cell in which the radio button to be clicked is present. Row number starts at 1.

Yes

String

column

The column number of the cell in which the radio button to be clicked is present. Column number starts at 1.

Yes

String

Example:
ClickRadioButtonInCell                "2"            "3"

StoreTableData

This action stores the data of multiple columns in a table into a file. To store the data laid out in the table across multiple pages, the parameter "noOfPageNext" can be used.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

locatorOfPageNext

The locator of the object which is used to navigate to the next page. If the table is not to be navigated, then this parameter can be "". The locator has to be only an XPATH

Yes

String

columsToStore

The index of columns whose data needs to be stored in the file. If multiple columns need to be stored, then separate the column index with the carat operator

Yes

Array

noOfPageNext

To store the data laid out in a table across multiple pages, set the no of times page next needs to be clicked. If only the current page table data needs to be stored, this parameter should be set to "0".

Yes

String

fileToStore

The complete path of the file which in which the data needs to be stored. The file types supported are xml, xmls and txt. The valid extensions are
For text file - .txt
For xml file- .xml
For excel file- .xls

Yes

String


Example
StoreTableData                                            "//[@id=":cf"]"        "1^2^3 2"                "0"      "C:\DBResults\Excel\ORACLE\Result.xls"

StoreColumnNumber

This action stores the column number with the specified column name. This is only applicable for tables having same number of columns in all the rows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the column number is to be stored

Yes

String

columnName

The name of the column whose number is to be stored

No

String

Example:
StoreColumnNumber            "key"         "Column 1"

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist 
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example:

WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.
WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.


StoreColumnData

This action stores the column data of the specified column number. This is only applicable for tables having same number of columns in all the rows.

The data is separated by caret (^). 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the column number is to be stored

Yes

String

column

The column number of the cell whose data need to be stored. Column number starts at 1.

Yes

String

Example:
StoreColumnData        "key"         "2"

StoreRowData

This action stores the row data of the column for the specified row number.

The data is separated by caret (^). 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the row data is to be stored

Yes

String

row

The row number of the cell whose data need to be stored. Row number starts at 1.

Yes

String

Example:
StoreRowData                           "key"     "2"

VerifyDataExistenceInRow

This action verifies whether the expected data exists in the specified row. The expected data can be a sublist of the actual column data in the table. This is only applicable for tables having same number of columns in all the rows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

The row number to refer to a particular cell of table where the data is to be searched.
Row number starts at 1.

Yes

Integer

rowData

Data to be searched in a column. Multiple data can be separated with the caret (^) operator.

Yes

Array

existence

Data type of this parameter can be True or false.
If True – checks if the data exists
If False – checks if the data does not exist

NO

TRUE

Example:
VerifyDataExistenceInRow             "2"        "Test"       "True"
This shall verify if the data Test is present in the row 2 of the table

VerifyDataExistenceInRow            "2"        "Test" "False"
This shall verify if the data Test is not present in the row 2 of the table

RightClick

This action right clicks the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

The context menu option number that needs to be clicked.

Yes

String

Example:
RightClick                         "3"

This will select the third option in the right click menu.

StoreRowNumberHavingMinCellDataincolumn

This action stores the row number of the table which contains the minimum value of integer data in the column specified by user.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number will be stored

Yes

String

Col

The column number to refer to a particular cell of table. Column number starts at 1.

Yes

Integer

Example:
StoreRowNumberHavingMinCellDataincolumn                        "rowNo"        "4"

StoreRowNumberContainsMaximumValue

This action stores the row number of the table which contains the maximum value of integer data in the column specified by user.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number will be stored

Yes

String

Col

The column number to refer to a particular cell of table.Column number starts at 1.

Yes

String


Example:
StoreRowNumberContainsMaximumValue                 "rowNo"      "2"

VerifyTableRowCount

This action verifies the actual row count of the specified table with the expected row count.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

rowCount

The expected row count that will be compared with the actual row count.

Yes

Integer


Example:
VerifyTableRowCount          "6"

VerifyCellText

This action verifies the actual data of the specified cell with the expected cell data.

This comparison is case sensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

data

The data or text which is to be verified in the table cell.

Yes

String

Row

The row number of the cell. Row number starts at 1

Yes

String

Col

The column number of the cell. Column number starts at 1

Yes

String

Example:
VerifyCellText          "Good Morning"         "2"        "3"

ClickLinkAtCellandchooseOkOnConfirmation

This action clicks a link in the specific cell of the table. This is applicable for tables having same number of columns in all the rows. After clicking the link, if an alert or confirmation comes up this action will accept it by clicking on OK. If the link is clicked and no alert or confirmation comes up the action will fail. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Link

The link url to be clicked.

Yes

String

Row

The row number of the cell in which the link is present. Row number starts at 1

Yes

String

Column

The column number of the cell in which the link is present. Column number starts at 1

Yes

String


Example:
ClickLinkAtCellandchooseOkOnConfirmation                                    "http://www.google.com"       "2"     "3"
Note: If Link is an empty data ("" or $NULL$), and there are multiple links in the cell, then the first link in the cell will be click. If there are multiple links in the cell with the same text, then the first link will be clicked. However, if there is no link available in the cell, the action will fail with an error message that no link is available in the cell.

ClickAndWait

This action clicks the specified object and waits.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.


StoreRowNoContainingTextInArray

This action stores the row number which contains the combination of text given.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number will be stored.

Yes

String

cellText

The text combination which needs to be checked in the columns.

Yes

Array

Col

The column number of the cell in which the data combination is to be searched. Column number starts at 1

Yes

String


Example:
StoreRowNoContainingTextInArray                             "rowNo"        "John^Smith"       "3"
This will search for the combination of John and Smith in the column 3 of the table for all the rows.The row which contains this combination will be stored in the key "rowNo"

GenerateAndStoreMaximumValue

This action fetches the column data having the maximum value.It then adds an increment value to it and stores it in a key

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the maximum generated data will be stored

Yes

String

Col

The column number of the cell in which the maximum data is to be found. Column number starts at 1

Yes

String

incr

The value by which the maximum data found in the column is to be incremented/decremented.

If this value is "" empty string, then the default increment is 0

NO

String


Example:
GenerateAndStoreMaximumNumber                     "key"      "3"        "2"

ClickLinkAtCellTH

This action clicks a link in the specific cell of the table header. This is applicable for tables having same number of columns in all the rows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Link

The link url to be clicked

The data type is alphanumeric

No

String

Row

The row number of the cell in which the link is present. Row number starts at 1

Yes

-

Col

The column number of the cell in which the link is present. Column number starts at 1

Yes

-


Example:
ClickLinkAtCellTH                                    "http://www.google.com"     "2"    "3"
Note: If Link is an empty data ("" or $NULL$), then the first link in the cell will be click. If there are multiple links with the same text then the first link will be clicked. However, if there is no link available in the cell, the action will fail with an error message that no link is available in the cell.

ClickLinkTitleAtCell

This action clicks a link based on the title in the specific cell of the table. This is applicable for tables having same number of columns in all the rows.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Link

The link title to be clicked.

Yes

String

Row

The row number of the cell in which the link is present. Row number starts at 1

Yes

String

Col

The column number of the cell in which the link is present. Column number starts at 1

Yes

String


Example:
ClickLinkTitleAtCell         "google"       "2"      "3"
Note: If Link is an empty data ("" or $NULL$), and there are multiple links in the cell, then the first link in the cell will be clicked. However, if there is no link available in the cell, the action will fail with an error message that no link is available in the cell.

ClickCheckboxInCellTH

This action selects the checkbox in the specified header of the table.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

The row number of the cell in which the checkbox to be clicked is present. Row number starts at 1.

Yes

String

Column

The column number of the cell in which the checkbox to be clicked is present. Column number starts at 1.

Yes

String

Example:
SelectCheckboxInCell             "2"         "3"
If the check box is already selected, the action shall pass.

ClickImageInCellTH

This action clicks the image in the specified cell of the table.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

alt_title

This can be any of the attribute of the image alt or title.
Following will be the preference in which the action will assume the incoming data:
First preference then goes to title. If an image with specified title is found then click else search for an image with property
Alt = incoming data

Yes

String

Row

The row number of the cell in which the image is present. Row number starts at 1

Yes

String

Col

The column number of the cell in which the image is present

Yes

String

Example:

ClickImageInCellTH                     "2"        "2"       "3"

StoreExistence

This action stores the existence of an object 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 in which the existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                             "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

Page Class

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView


VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Data type of this parameter is can be true or false.
If True – checks if the page exists
If False – checks if the page does not exist

Yes

TRUE

Example:
VerifyExistence                        "True"

ClickLinkByText

This action clicks the link specified by the user on the page.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

link

The text of the link which is to be clicked

Yes

String

Example:
ClickLinkByText                             "Advanced Search"

Click

This action clicks the specified object

Example:
Click

StorePropertyValue

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                          "value"          "name"

ClickAt

This action clicks at a particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

ClickAt         "5"         "10"


DoubleClickLinkByText

This action double-clicks on the link specified by the user on the page.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

link

The text of the link which is to be double clicked

Yes

String


Example
DoubleClickLinkByText           "Advanced Search"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Data type of this parameter is can be true or false.

If True – checks if the page is visible
If False – checks if the page is not visible

Yes

String

Example
VerifyVisibility            "True"

ClickAndWait

This action clicks the page object and waits.It waits for the maximum sync time set in the Qualitia Configuration (Execution) window for key Sync Time. If the page page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.

StoreExistence

This action stores the existence of an object 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 in which the existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                             "Key"

Frame Class

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Data type of this parameter is can be true or false.
If True – checks if the page exists
If False – checks if the page does not exist

Yes

TRUE

Example:
VerifyExistence                        "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Data type of this parameter is can be true or false.

If True – checks if the page is visible
If False – checks if the page is not visible

Yes

String

Example
VerifyVisibility            "True"


Click

This action clicks the specified object

Example:
Click

StorePropertyValue:

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                          "value"          "name"

ClickAt

This action clicks at a particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

ClickAt         "5"         "10"


SelectFrame

This action selects the frame within the current window.

This action does not have any parameters.

Example:
SelectFrame

ClickAndWait

This action clicks the page object and waits.It waits for the maximum sync time set in the Qualitia Configuration (Execution) window for key Sync Time. If the page page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.

StoreExistence

This action stores the existence of an object 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 in which the existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                             "Key"

WebElement Class

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 have to be handle 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. This parameter is not mandatory

Yes

String


 Important Notes:


1. During execution, IE blocks download window. You will get a similar message below. 
 
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads. 
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669 
2. When a download window is populated, the following window will also exist. 
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.

Important Notes for Firefox: 
Firefox uses the default Firefox instance:- 
 
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
 


Table 1: Parameter Mandate

Browser

locator

folderPath

fileName

Internet Explorer

Mandatory

Mandatory

Not mandatory

Firefox [Default instance invoke my Selenium]


Above is the default download setting in the default Firefox instance invoke my Selenium.

Mandatory

Mandatory

Not mandatory


Example
 
DownloadFile               "C:/ProgramData"           "Qualitia" 
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Data type of this parameter is can be true or false.
If True – checks if the page exists
If False – checks if the page does not exist

Yes

TRUE

Example:
VerifyExistence                        "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Data type of this parameter is can be true or false.

If True – checks if the page is visible
If False – checks if the page is not visible

Yes

String

Example
VerifyVisibility            "True"

Click

This action clicks the specified object

Example:
Click


StorePropertyValue

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                          "value"          "name"


MouseOver

This action simulates the user hovering mouse over the specified object.

Example:
MouseOver

MouseDown

This action simulates user pressing the left mouse button at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

MouseDown              "5"        "10"


MouseUp

This action simulates the event that occurs when the user releases the mouse button.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

MouseUp              "50"           "38"

ClickAt

This action clicks at the particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

ClickAt            "60"         "67"

SetFocus

This action moves the focus to the specified web element.

Example:

SetFocus

DoubleClick

This action double-clicks the particular web element.

Example:
DoubleClick

RightClick

This action right-clicks the specified web element.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

The context menu option number that needs to be clicked.

Yes

String

Example:
RightClick             "3''

This will select the third option from the context-menu. 

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example
WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.

WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

ClickAndWait

This action clicks the page object and waits.It waits for the maximum sync time set in the Qualitia Configuration (Execution) window for key Sync Time. If the page page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

In Webdriver we wait for the document 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 document is in ready state and assume that the page is loaded could however not work as expected at all times.

DragAndDrop

This action drags and drops the specified web element at the specified location. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

offsetX

Offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10,…

Yes

String

offsetY

offset in pixels from the current location to which the element should be moved The offset parameter can be as -100,100 , +100

Yes

String

Example:
DragAndDrop            "-100"           "500"

StoreExistence

This action stores the existence of an object 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 in which the existence (true/false) of the object is stored.

Yes

String

Example:
StoreExistence                             "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. 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 child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView


Not finding what you need?