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

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

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

Yes

String


Example:
VerifyExistence                                      "True"

VerifyVisibility

This action verifies the visibility of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

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

Yes

String

Example:
VerifyVisibility                             "True"

StoreColumnCount

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

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

Yes

String

row

The row number whose column count has to be stored.

Yes

String

Example:
StoreColumnCount                                   "key"           "2"

StoreRowCount

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

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

Yes

String


Example:
StoreRowCount                          "Key"

On this page:


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 clicked. If there is only one link in the cell, then the 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.

StoreRowNoOfCellText

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

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

Yes

String

cellText

Cell data to be searched for in the table.

Yes

String

Column

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

Yes

String

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

Click

This action clicks the specified object.

This action does not have any parameter. 

Example:
Click

StorePropertyValue

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

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored.

Yes

String

Property

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

Yes

String

Example:
StorePropertyValue                                                "value"          "name"

ClickImageInCell

This action clicks the specified image in the cell. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

altorindex

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

Yes

String

Row

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

Yes

String

Column

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

Yes

String

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

StoreRowNoContainingCellText

This action stores the row number of the cell whose data contains the text specified by the user. This comparison is case-sensitive .When multiple cells in the column specified contain the expected data, then the first row 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

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 check box 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 check box is expected to be present. Column number starts at 1.

Yes

Integer

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

CompareRowData

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

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

Yes

Integer

rowData

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

Yes

Array.

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

CompareTableRowData      "2"        "India^Australia^ England"

CompareColumnData

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Column

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

Yes

Integer

colData

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

Yes

Array

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

VerifyDataExistenceInColumn

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

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Column

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

Yes

Integer

data

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

Yes

Array

existence

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

Yes

String

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

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

VerifyDataExistenceInColumn        "2"            "Test"       "False"

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

StoreInstanceOfDataFromColumn

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

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

Yes

String 

Column

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

Yes

Integer

Data

Data to be searched in a column.

Yes

String

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

StoreRowNumWithRowData

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

rowData

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

Yes

Array

Key

The variable in which the row number is to be stored

Yes

String

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

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

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

SelectCheckboxInCell

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

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

Yes

String

column

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

Yes

String

Example:
SelectCheckboxInCell          "2"         "3"

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

VerifyImageInCell

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

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

Yes

String

column

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

Yes

String

ScrTitle

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

Yes

String

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

ClickAt

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

Parameter Name

Parameter Description

Mandatory

Data Type

X

The X-coordinate of the click.

Yes

String

Y

The Y-coordinate of the click.

Yes

String

Example
ClickAt        "5"     "10"

VerifyLinkTitleAtCell

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

link

Title data of the link

Yes

String

row

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

Yes

String

column

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

Yes

String

Example
VerifyLinkTitleAtCell ClickHere                                "5"      "10"

ClickCell

This action clicks at the specified cell in the table.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

row

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

Yes

String

column

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

Yes

String

Example
ClickCell   "5"      "10"

ClickRadioButtonInCell

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

row

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

Yes

String

column

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

Yes

String

Example:
ClickRadioButtonInCell                "2"            "3"

StoreTableData

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

locatorOfPageNext

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

Yes

String

columsToStore

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

Yes

Array

noOfPageNext

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

Yes

String

fileToStore

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

Yes

String


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

StoreColumnNumber

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the column number is to be stored

Yes

String

columnName

The name of the column whose number is to be stored

No

String

Example:
StoreColumnNumber            "key"         "Column 1"

WaitForObject

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

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

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

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

Yes

String

existence

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

Yes

String

Example:

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

StoreColumnData

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

The data is separated by caret (^). 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the column number is to be stored

Yes

String

column

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

Yes

String

Example:
StoreColumnData        "key"         "2"

StoreRowData

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

The data is separated by caret (^). 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

The variable in which the row data is to be stored

Yes

String

row

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

Yes

String

Example:
StoreRowData                           "key"     "2"

VerifyDataExistenceInRow

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

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

Yes

Integer

rowData

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

Yes

Array

existence

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

NO

TRUE

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

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

RightClick

This action right clicks the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

The context menu option number that needs to be clicked.

Yes

String

Example:
RightClick                         "3"

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

StoreRowNumberHavingMinCellDataincolumn

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number will be stored

Yes

String

Col

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

Yes

Integer

Example:
StoreRowNumberHavingMinCellDataincolumn                        "rowNo"        "4"

StoreRowNumberContainsMaximumValue

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number will be stored

Yes

String

Col

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

Yes

String


Example:
StoreRowNumberContainsMaximumValue                 "rowNo"      "2"

VerifyTableRowCount

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

rowCount

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

Yes

Integer


Example:
VerifyTableRowCount          "6"

VerifyCellText

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

This comparison is case sensitive.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

data

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

Yes

String

Row

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

Yes

String

Col

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

Yes

String

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

ClickLinkAtCellandchooseOkOnConfirmation

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Link

The link url to be clicked.

Yes

String

Row

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

Yes

String

Column

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

Yes

String


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

ClickAndWait

This action clicks the specified object and waits.

Example:
ClickAndWait

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

StoreRowNoContainingTextInArray

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the row number will be stored.

Yes

String

cellText

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

Yes

Array

Col

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

Yes

String


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

GenerateAndStoreMaximumValue

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the maximum generated data will be stored

Yes

String

Col

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

Yes

String

incr

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

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

NO

String


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

ClickLinkAtCellTH

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Link

The link url to be clicked

The data type is alphanumeric

No

String

Row

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

Yes

-

Col

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

Yes

-


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

ClickLinkTitleAtCell

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Link

The link title to be clicked.

Yes

String

Row

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

Yes

String

Col

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

Yes

String


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

ClickCheckboxInCellTH

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Row

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

Yes

String

Column

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

Yes

String

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

ClickImageInCellTH

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

alt_title

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

Yes

String

Row

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

Yes

String

Col

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

Yes

String

Example:

ClickImageInCellTH                     "2"        "2"       "3"

StoreExistence

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

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

Yes

String

Example:
StoreExistence                             "Key"

StoreChildCount

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

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

  • No labels