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. | 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 | 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:
If key to be sent is {F1} then user should pass data as ~{F1~}
To send {TAB} then user should pass data as ~{TAB~}
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 | Yes | String |
mainString | String 2 to be compared. Even a key name can be passed here enclosed in braces. | Yes | String |
caseSensitive | The kind of comparison to be done | 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. | Yes | String |
Substring | The string to be searched for in the main string. | Yes | String |
caseSensitive | This can be set as True or False. | 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. | 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"
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. 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. StoreSplitString
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. | 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. | 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. | 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" "<"
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. 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. List of supported dateTimeFormats:
Date Time Formats Examples dd-MM-yy 31-01-12 dd-MM-yyyy 31-01-2012 MM-dd-yyyy 01-31-2012 yyyy-MM-dd 2012-01-31 yyyy-MM-dd hh:mm:ss 2012-01-31 23:59:00 yyyy-MM-dd hh:mm:ss.SSSZ 2012-01-31 23:59:59.999+0100 EEEEE MMMMM yyyy HH:mm:ss.SSSZ Saturday November 2012 10:45:42.720+0100
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
- Increment only the day value
dayValue = 45, monthValue = 0 , yearValue = 0
E.g.- ChangeDateAndStore "01-01-2007" "dd-MM-yyyy" "45" "0" "0" "key" - 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 | 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. | 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
- For text file - .txt
- For xml file- .xml
- 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.
- text and text
- text and excel
- text and xml
- xml and xml
- xml and excel
- 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 | 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 | 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.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- 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.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- 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 |
| 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 |
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 | 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. | 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. | 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. | 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. | 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. | 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. | 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. | 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 | 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.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- After the set up is completed, AutoIT installation path should be set against the Qualitia's configfile key "AutoITPath"
Input Parameters:
Parameter Name | Parameter Description | Mandatory | Data Type |
---|---|---|---|
folderName | The path where the file is to be download. Please check Table 1 "Parameter Mandate" to validate in the situation where this parameter will be mandatory. In case the parameter Mandatory; the user should take care that the folder path exists. The action does not validates whether the folder exist | Yes | String |
Filename | The filename of the downloadable file, to be given incase the user requires to give specific name and not depend on the default name of the file. In case, the file already exist, similar window like below will appear. Such windows are not handled by the action. Incase, the user does not provide this data, the action will pick the default file name available while download. | No | String |
Example
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. | 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. | 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. | 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 | 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. | 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. | 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 | 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. | 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. | 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 | 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. | 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. | 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. | 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 | 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. | 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 | 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, | 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.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- 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 |
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. | 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. | 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. | 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 | 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.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- 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 |
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. | 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. | 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 | 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. | 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. | 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. | 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 | Yes | Array |
existence | Value of this parameter can be true or false. | 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:
- "^" in Qualitia is a delimiter for items in an array.
- 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. | 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. | 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 | 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 | 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. | 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. | 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. | 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]. | 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. | 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. | 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. | 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. | 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. | 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 | 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 | 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. | 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. | 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 | 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. | 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. | 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. | 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 | 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. | 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 | 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. | 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.
- Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
- Click on Download AutoIt v3.
- Choose full installation.
- 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 |
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. | 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 | 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. | 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 | 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