Generic Keyword- Action

Keywords offer a set of predefined commands for creating test cases for any application or software. With keywords, you can easily write test steps with input and output data without the need for complex coding.

How to use Keywords?

Keywords are used by calling them in a test step and adding the input and expected output data values. If you want to capture the dynamic objects, you can also add properties of the object in the test object column.

Let's understand this with an example of using the AddItemInCollection keyword.

This keyword adds an item to the collection. It takes Collection Data & items to be added as input data arguments.

1. Add a new step in your test case by clicking the + icon at the top. Search AddItemInCollection and click on the search result to add it to the new test step.

2. Click the Three dots icon in the input data column of the step to open the input data window for the keyword.

3. Add the input data in relevant sections as shown below and click the OK button at the bottom.

Note: We have illustrated the requirement of the Test Object, Input Data, and corresponding Output data values in the tables following this image. These values are filled in their respective columns as per the requirement in the test case as shown in the image below. We have given similar tables for each keyword for illustration.

In the AddItemInCollection keyword, there was no requirement to add a Test Object's properties, hence, we have mentioned it is not required.

Test Object

Test Object Required	Description
None	Not Required

Input Data

Input Data Required	Description
Collection Data	Add the Collection Data from Global Variables or use the local static data.
name of item	This takes the name of items to be added to collection data as data input.

Output Data

Condition	Output value
If the keyword passes successfully	Item added to Collection Data
if there is an error	Value not added

Example

If you want to add Item: dff in Collection (Data)

Data : [
"asd",
"asdf",
"add"
]

then you can use the AddItemInCollection keyword. The output will be

[
"asd",
"asdf",
"add",
"dff"
]

Common Error conditions

This keyword fails in the following common error scenarios as given below -

Condition

Debug Information

Message

If No data is provided

One or more of the arguments have not been provided with a value

Argument Data Missing (-13200)

DESCRIPTION:

A step might fail if it lacks values for required arguments. While certain arguments are optional, mandatory ones must be supplied with data. This data can be entered statically, derived from a prior step's output, sourced from a global variable, etc. It should not be left blank to ensure proper execution.

If the Item to be added is not given

One or more of the arguments have not been provided with a value

Argument Data Missing (-13200)

DESCRIPTION:

Now let's go through the list of various collection keywords to understand their utility.

List of Keywords

1. AcceptPopup

This keyword accepts the current popup. It doesn't take any object/data input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.
Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

URL

Comments

https://www.indianrail.gov.in/pnr_Enq.html

On this web page, this keyword accepts a popup generated after clicking over Get Status without entering a valid PNR number.

In the above example, we click on Get Status to know the PNR status without entering the PNR number. While using this keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application having a popup to be accepted.

Common Error conditions

Scenarios

Error Message

Debug Information

If the popup is absent

Browser: Mozilla Firefox

URL: https://www.indianrail.gov.in/pnr_Enq.html

Note: keyword generating popup message, is not applied.

Unsatisfied Dependencies (-14200)

Popup not found

If the URL of the web application having the popup is not given

Browser: Mozilla Firefox

URL:

Argument Data Missing (-13200)

Argument(s) : (Browser;URL) are blank.

2. CaptureObjectSnapshot

This keyword is used to capture the snapshot of a specific object and returns the path of the saved snapshot. It takes OR Object as the Object Input Argument. It doesn’t take any data input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes the OR object whose snapshot has to be captured.
Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

Path of captured snapshot	If the keyword passes successfully
False	If the keyword fails
Blank	If a null object Input Argument is provided

Example

If you want to capture the snapshot of any specified Object then use this keyword as shown below –

CaptureObjectSnapshot

Object

< Choose an Object from OR >

Note: This keyword captures the snapshot of that particular object and not the entire page.

Common Error Conditions

Scenarios

Error Message

Debug Information

If the keyword is used without launching the webpage on the browser.

Insufficient Privileges (-14100)

DESCRIPTION:

The system does not have sufficient privileges to carry out a particular task. This mostly happens when the currently logged-in user at the execution site does not have permission to access a particular resource. The protected resource may be a network, folder, or drive. The user may contact the system administrator to sort out the issue.

Either the browser was never Opened or all WebDriver instances were closed

If a Null Object is provided

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty.

3. CaptureSnapshot

This keyword captures the Snapshot of the web application and saves the snapshot on a specified path. It takes ImagePath as the data input argument. You can save the captured snapshot in the desired image file format (like .png, .jpg, .bmp, .jpeg, .gif, .tif, etc.).

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.
Data Input Arguments	Required?	Description
Image Path	Yes	This Keyword takes ImagePath as data input arguments Note: You should provide the path of your local system (Ex. C:UsersUsernameDocuments). By default the keyword saves the image file with the name as OpKey.png and if filename needs to be provided you can provide the path of your local system storage along with the name of the snapshot file to be captured (Ex. C:UsersUsernameDocumentsOpKey_ Snapshot.png)

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Give Image Path	Comments
C:UsersUsernameDocumentsOpKey.png	The captured screenshot will be saved in the document folder with OpKey.png file name
C:UsersUsernameDocumentsOpKey.jpg	The captured screenshot will be saved in the document folder with OpKey.jpg file name
C:UsersUsernameDocumentsOpKey.bmp	The captured screenshot will be saved in the document folder with OpKey.bmp file name
C:UsersUsernameDocumentsOpKey.jpeg	The captured screenshot will be saved in the document folder with OpKey.jpeg file name
C:UsersUsernameDocumentsOpKey.gif	The captured screenshot will be saved in the document folder with OpKey.gif file name
C:UsersUsernameDocumentsOpKey.tif	The captured screenshot will be saved in the document folder with OpKey.tif file name

In the example table above, you can save your captured snapshot in a desired image file format by providing the corresponding image path along with the file name with the relevant extension. Before using this keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application for capturing the snapshot.

Common Error conditions

Scenarios

Error Message

Debug Information

If data argument is not given (No Image Path)

Browser: Mozilla Firefox

URL: www.opkey.com

ImagePath:

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected Static Value was empty.

If the browser name & web application URL were not given

Browser:

URL:

ImagePath: C:UsersuserDesktopOpKey.jpg

Argument Data Missing (-13200)

Insufficient Privileges (-14100)

Argument(s) : (Browser;URL) are blank.

Description: -plugin-unable-to-take-screenshot

Either Browser was never opened or a… -plugin –unable-

4. ClearEditField

This keyword clears the value of a specified Edit box. This keyword takes the Edit box object as the Object Input argument. It does not take any Data Input Arguments.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes an Edit Box object as the object input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Image	Comments
	This keyword clears the text in the specified edit field.

In the above screenshot, if you want to clear the Text in the “E-mail Address ” EditBox then you can use the “ClearEditBox” keyword as follows:

Object

< Choose an Edit Box Object from the OR > Here, E-mail Address

Common Error conditions

Scenarios

Error Message

Debug Information

When the object is not given

Browser: Mozilla Firefox

URL:

https://cresconnect.crestechglo

bal.com/index.php?

Object Input Argument: No Object

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty.

When the Browser name & URL are not given

Browser:

URL:

Object Input Argument: Given

Argument Data Missing (-13200)

Insufficient Privileges (-14100)

Either the Browser was never Opened or all WebDriver instances were closed

-plugin-unable-to-take-screenshot-

5. ClearTextArea

This keyword clears the text from specified TextArea. This keyword takes TextArea object as Object Input argument. It does not take any Data Input Arguments.

Input Arguments

Object Input Arguments

Required?

Description

Object

Yes

This keyword takes a Text Area object

as Object Input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data Input argument.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Image

Comments

This keyword clears the text area from the mapped object.

In the above screenshot, if you want to clear the Text from the “Add Comment ” TextArea then you can use the “ClearTextArea” keyword as follows:

ClearTextArea

Object

< Choose a TextArea Object from the OR > Here, Add Comment

Common Error conditions

Scenarios

Error Message

Debug Information

When the object is not given

Browser: Mozilla Firefox

URL:

https://cresconnect.crestechglo

bal.com/index.php?

Object Input Argument: No Object

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty.

When the browser name & URL are not given

Browser:

URL:

Object Input Argument: Given

Argument Data Missing (-13200)

Insufficient Privileges (-14100)

Argument(s): (Browser or URL) is left blank

-plugin-unable-to-take-screenshot-

Either the browser was never Opened or all WebDriver instances were closed

6. Click

This keyword clicks on the specified object. It takes OR object as input argument.

Input Arguments

Object Input Arguments

Required?

Description

Object

Yes

This keyword takes one object as the object

input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data Input argument.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

URL

Comments

https://www.crestechsoftware.com/CrestShop/

In this web page, user clicks on My Account to view account details.

In the above screenshot, if you want to click on "My Account" of CrestShop web application then this is how you will use the "Click" keyword .

Click

Object

< Choose an Object from the OR > Here, My Account

While using "Click" keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application for clicking over desired object.

Common Error conditions

Scenarios

Error Message

Debug Information

If object is not given

Browser: Mozilla Firefox

URL:

https://www.crestechsoftware.com

/CrestShop/

Object: No object

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty.

If URL of web application is not given

Browser: Mozilla Firefox

URL:

Object: Mapped

Argument Data Missing (-13200)

Argument(s) : URL are blank

7. ClickButton

This keyword clicks on the specified object of type button. This keyword takes Button object as object input argument.

Input Arguments

Object Input Arguments

Required?

Description

Object

Yes

This keyword takes Button Object as

object input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

True	If the keyword passes successfully
False	If the Keyword fails

Example

URL

Comments

https://www.indianrail.gov.in/pnr_Enq.html

User clicks on

Get Status

button

in this web

page.

In the above screenshot, the user clicks on "Get Status" button of the web application. While using "ClickButton" keyword, you should ensure that you are using the keyword with a relevant keyword (like OpenBrowser) which can open your web application having button to be clicked upon. This is how you will use "ClickButton" keyword .

ClickButton

Object

< Choose a button Object from the OR > Here, Get Status

Common Error conditions

Scenarios	Error Message	Debug Information
If object is not given Browser: Mozilla Firefox URL: https://www.indianrail.gov.in/pnr_Enq.html Object: No object	Argument Data Missing (-13200)	Data not provided for argument: 'Object'. Expected StaticValue was empty.
If URL of web application is Not given Browser: Mozilla Firefox URL: Object: Given	Argument Data Missing (-13200)	Argument(s) : URL are blank
If browser name & URL of web application is Not given Browser: URL:	Argument Data Missing (-13200)	Argument(s) : (Browser,URL) are blank

ClickButtonAndWait

This keyword clicks on given button and waits for the specified Time. It takes Button object and time in seconds as input argument. This keyword can be used as per requirement of your test scenario where after clicking to the given button you are required to wait for some time.

Input Arguments

Object Input Arguments

Required?

Description

Object

Yes

This keyword takes Button object as

object input argument.

Data Input Arguments	Required?	Description
TimeOut	Yes	Specify the time in seconds

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Image	Comments
	This keyword waits for 2 seconds after clicking the button Login

In the above screenshot, this keyword waits for 10 seconds after clicking the button "Login" button. While using "ClickButtonAndWait" keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which comes first in Test execution and opens desired web application page having button to be clicked upon.

ClickButtonAndWait

Object	< Choose an Button Object from the OR > Here, Get Status
TimeOut	10

Common Error conditions

Scenarios

Error Message

Debug Information

If object argument & data argument are not given

Browser: Mozilla Firefox

URL: https://www.indianrail.gov.in/

pnr_Enq.html

OR Object:

Timeout:

Argument

Data Missing

(-13200)

Data

not provided

for

argument: 'Object'. Expected StaticValue

was empty.

If data argument is Not given

Browser: Mozilla Firefox

URL: https://www.indianrail.gov.in

/pnr_Enq.html

OR Object: Mapped

Timeout:

Argument Data Missing (-13200)

Argument(s) : (Timeout) are blank.

ClickButtonInTableCell

This keyword clicks on a button available in table cell. It takes one Table type object as object input argument and Row Index, Column Index, Object Index as data input argument.

For ClickButtonInTableCell Keyword:

Input Arguments

Object Input Arguments

Required?

Description

Object

Yes

This Keyword takes one table object as Object Input Argument.

Data Input Arguments	Required?	Description
Row Index	Yes	Specify the row index of the table cell.
ColumnIndex	Yes	Specify the column index of the table cell
Object Index	Yes	Specify the position of the object inside the Table cell. Index starts from ‘0’

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Image

Comments

This keyword Clicks on the Apple button in the specified table cell.

In the above Screenshot, if you want to click “Apple” button then you can do so by using ClickButtonInTableCell keyword as follows:

ClickButtonInTableCell

Object	< Choose an Table Object from the OR >
Row Index	0
Column Index	1
Object Index	0

Common Error conditions

Scenarios

Error Message

Debug Information

If the keyword is launched without using Browser on the web page.

Insufficient Privileges (-14100)

DESCRIPTION:

The system does not have sufficient privileges to carry out a particular task. This mostly happens when the currently logged-in user at the execution site does not have permission to access a particular resource. The protected resource may be a network share, folder or a drive. User may contact the system administrator to sort out the issue.

Either Browser was never Opened or all WebDriver instances were closed

When Invalid Object Input Arguments are provided.

Argument Data Invalid (-13300)

DESCRIPTION:

The data value for one or more input arguments was not what was expected. This might happen when the input is expected in a specific format or should be chosen from a predefined set of values. Check for spell errors and capsing.

Specified Object is not Table.

ClickImage

This keyword clicks on a specified image. This keyword is mostly used when user want to click on any given image. It takes one Image object as object input arguments. It does not take any Data Input Arguments.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This Keyword takes image object from OR .

Data Input Arguments	Required?	Description
Data	No	This Keyword does not take any object from OR .

Output

It clicks on the given image object.	If the keyword passes successfully
False	If the keyword fails

Example

If you click on the above image then you need to use “ClickImage” keyword.

ClickImage

Image

< Choose your Image Object From OR >

Common Error conditions

Scenarios

Error Message

Debug Information

When object is not given

Browser: Mozilla Firefox

URL:

https://cresconnect.crestechglo

bal.com/index.php?

Object Input Argument: No Object

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty.

When Browser name & URL are not given

Browser:

URL:

Object Input Argument: Given

Insufficient Privileges (-14100)

Either Browser was never Opened or all WebDriver instances were closed.

ClickImageByTitle/Alt

This keyword clicks on image on basis of image title or alt attribute given. It takes Title/Alt, Index, Partial Text as Data Input Arguments.

For ClickImageByTitle/Alt Keyword:

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.

Data Input Arguments	Required?	Description
Title/Alt	Yes	Specify the title or Alt Property of the image to be clicked.
Index	No	Specify the position of the image object. Index starts from ‘0’
Partial Text	Yes	Provide True if text to search is partial Text

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

URL

Comments

https://cresconnect.crestechglobal.com/home.php

This keyword

clicks on image

on basis of image title

or alt attribute given.

In the above Screenshot, if you want to click on the “CresConnect” image then, here is how you will use "ClickImageByTitle/Alt " keyword.

ClickImageByTitle/Alt

Title/Alt	Porto
Index
Partial Text	False

Common Error conditions

Scenarios

Error Message

Debug Information

If the keyword is used without launching the browser on the web page.

Insufficient Privileges (-14100)

DESCRIPTION:

The system does not have sufficient privileges to carry out a particular task. This mostly happens when the currently logged-in user at the execution site does not have permission to access a particular resource. The protected resource may be a network share, folder or a drive. User may contact the system administrator to sort out the issue.

Either Browser was never Opened or all WebDriver instances were closed

If Invalid Data Input Arguments is provided

Object Not Found (-11100)

DESCRIPTION:

The object on which an action was supposed to be performed, was not found on the currently active page or view. This happens when the page is not properly loaded or the properties of the object are not exactly matched.

Not able to find image by Alt/Title

ClickInTableCellByQuery

This keyword clicks in the specified cell of the table using query. It takes one table type object as object input arguments.

For ClickInTableCellByQuery Keyword:

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This Keyword takes one table object as Object Input Argument. You can select a Table Object from the Object Repository whose cell has to be clicked by Query.

Data Input Arguments	Required?	Description
Column Name/Index	Yes	Specify the column name or index whose cell has to be clicked
Object Index	Yes	Specify the position of the object inside the Table cell. Index starts from ‘0’
Header	Yes	Specify the header of the column by which you can uniquely identify the table cell to be clicked.
Value	Yes	Specify the Value of the column cell by which you can uniquely identify the table cell to be clicked.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

URL

Comments

This keyword

clicks in

the highlighted

table cell using

Query.

In the above Screenshot, if you want to click in the highlighted Table cell , you can do so by using "ClickInTableCellByQuery " keyword as follows:

ClickInTableCellByQuery

Object	< Choose your table Object From OR >
Column Name/Index	0
Object Index	0
Header 1	Hello2
Value 1	hi1

Common Error conditions

Scenarios	Error Message	Debug Information
If the keyword is used without launching browser on the web page.	Insufficient Privileges (-14100) DESCRIPTION: The system does not have sufficient privileges to carry out a particular task. This mostly happens when the currently logged-in user at the execution site does not have permission to access a particular resource. The protected resource may be a network share, folder or a drive. User may contact the system administrator to sort out the issue.	Either Browser was never Opened or all WebDriver instances were closed
When Invalid Data Input Arguments are provided.	Argument Data Invalid (-13300) DESCRIPTION: The data value for one or more input arguments was not what was expected. This might happen when the input is expected in a specific format or should be chosen from a predefined set of values. Check for spell errors and capsing.	Index is invalid.
When Invalid Object Input Arguments are	Argument Data Invalid (-13300) DESCRIPTION: The data value for one or more input arguments was not what was expected. This might happen when the input is expected in a specific format or should be chosen from a predefined set of values. Check for spell errors and capsing.	Specified Object is not Table.

ClickLink

This keyword clicks on specified link. It takes link object as Input argument. It does not take any Data Input Argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes link object from OR as object input argument.

Data Input Arguments

Required?

Description

Data

This keyword doesn’t take any data input argument.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

URL	Comments
https://www.crestechsoftware.com/CrestShop/	In this web page, user clicks on My Account to view account details.

In this example, we click on My Account of CrestShop web application. While using "ClickLink" keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application having respective link to be clicked upon.

ClickLink

Object

< Choose your Link Object From OR >

Common Error conditions

Scenarios	Error Message	Debug Information
If object is not given Browser: Mozilla Firefox URL: https://www.crestechsoftware. com/CrestShop/ Object: No object	Argument Data Missing (-13200)	Data not provided for argument: 'Object'. Expected StaticValue was empty.
If URL of web application is Not given Browser: Mozilla Firefox URL: Object: Given	Argument Data Missing (-13200)	Argument(s) : URL are blank
If browser name & URL of web application are Not given Browser: URL:	Argument Data Missing (-13200)	Argument(s) : (Browser,URL) are blank

ClickLinkInTableCell

This keyword clicks on a link inside any table cell. This keyword is mostly used in situations where you have dynamic links within your table cells. The text of link might change in different scenarios.

For example, you want to click on link available inside any table cell.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This Keyword takes one table object input argument. You can choose the table object from your Object Repository within which you want to click on this link

Data Input Arguments	Required?	Description
Row Index	Yes	Specify the Row number of the cell in which link appears. Note: Row Index starts from zero.By default it takes ‘0’ for row index
Column Index	Yes	Specify the Column number of the cell in which link appears. Note: Column Index starts from zero.By default it takes ‘0’ for column index
Object Index	Yes	Specify the index of link element inside column cell. Note: Object Index of Link starts from zero.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

For example if you want to click on an object named “News” on a webpage “https://sstsinc.com”, then you can use this keyword for clicking on the object by providing the object’s text to it.

In the example table above, if you want to click on “Number” link in 2nd Row 2nd column, here is how you will use this keyword.

ClickLinkInTableCell

Object	< Choose your Table Object From OR >
Row Index	1
Column Index	1
Object Index	0

Common Error conditions

Scenarios	Error Message	Debug Information
If table object is not found	Object Not Found	Data not provided for argument: 'Object'. Expected StaticValue was empty.
If specified cell is not found	Argument Data Invalid	Given column not exist in table OR Given row not exist in table
If no link is found at specified object index	Argument Data Invalid	No Link found in the Table Cell

ClickOnObjectInTableCell

This keyword clicks on specified object available inside any table cell. It takes object, Row index, column index, tag and Tag Index as input argument.This keyword is mostly used in situations where you have to click on an object within your table cells. The type of object might change in different scenarios.

For example, you want to click on object available inside any table cell and perform action on it.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This Keyword takes one object input argument. You can choose the table object from your Object Repository within which you want to click on this link.

Data Input Arguments	Required?	Description
Row Index	Yes	Specify the Row number of the cell in which link appears. Note: Row Index start from zero .
Column Index	Yes	Specify the Column number of the cell in which link appears. Note: Column Index start from zero .
Tag	Yes	Specify tag of item
Tag Index	Yes	specify the Index of object in table cell Note: Indexing of object start from zero.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

In the example table above, if you want to click on “Your Name” editbox in 2nd Row last column, here is how you will use this keyword “ClickOnObjectInTableCell”.

ClickOnObjectInTableCell

Object	< Choose your Table Object From OR >
Row Index	1
Column Index	1
Tag	INPUT
Tag Index	0

Common Error conditions

Scenarios	Error Message	Debug Information
If table object is not found	Object Not Found	Data not provided for argument: 'Object'. Expected Static Value was empty.
If specified cell is not found	Argument Data Invalid	Given row not exist in table
If no object is found in the specified cell	Unsupported Operation	Given row does not exist in table cell

ClickTableCell

This keyword clicks on the specified object in a table cell.

This keyword is mostly used in situations where you want to click on a specified object within your table cell. The element of the table cell might change in different scenarios. It takes an OR Object of table type as Object Input Argument and Row Index, column index, tag & Tag index as data input arguments.

For example, you want to click inside any table cell.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes one table object Input argument. You can choose table object from your Object Repository

Data Input Arguments	Required?	Description
Row Index	Yes	This argument takes row number of the table where starting index is “0”.
Column Index	Yes	This argument takes Column number of the table where starting index is “0”.
Tag	Yes	Specify Object Tag. Give the Tag value of parent object.
Tag Index	Yes	Specify the index of element in the table cell Tag Index of Link starts from zero.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

URL

Comments

https://www.december.com/html/3.2/element/textarea.html

This keyword clicks

on the specified

cell of the table.

In the example above, if you want to click in the Table cell Object Text Area “Your Comments” then, use this keyword as shown below:

ClickTableCell

Object	< Choose your Table Object From OR >
Row Index	1
Column Index	1
Tag	Text Area
Tag Index	0

Common Error conditions

Scenarios

Error Message

Debug Information

When no object is provided

Argument Data Missing (-13200)

DESCRIPTION:

A step could not be executed because one or more of the arguments have not been provided a value. Of all the arguments a keyword accepts, some arguments might be compulsory. As opposed to the non-compulsory ones, the compulsory argument must be provided some data. The data may be provided through one of many sources like statically entering, output of a previous step, a global variable etc; but it must not be left blank.

Data not provided for argument: 'Object'. Expected Static Value was empty.

When InValid object and blank Data Input Arguments are provided.

Argument Data Invalid (-13300)

DESCRIPTION:

Specified Object is not a table

ClickTableCellAndWait

This keyword clicks on the specified cell of table type object and wait for the specified time.

This keyword is mostly used in situations where you need to wait for some time after clicking in the table cell. The element of the table cell might change in different scenarios. It takes an OR Object of table type as Object Input Argument and Row Index, column Index, tag, Tag Index, timeout as data input arguments.

For example, you want to click inside any table cell and wait.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes one table object Input argument. You can choose table object from your Object Repository

Data Input Arguments	Required?	Description
Row Index	Yes	This argument takes row number of the table where starting index is “0”.
Column Index	Yes	This argument takes Column number of the table where starting index is “0”.
Tag	Yes	Specify Object Tag. Give the Tag value of parent object.
Tag Index	Yes	Specify the index of element in the table cell Tag Index of Link starts from zero.
TimeOut	Yes	specify the time (in seconds) that the keyword should wait after clicking on the specified Object.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

URL

Comments

https://en.wikipedia.org/wiki/List_of_Bollywood_films_of_2017

This keyword clicks on the specified cell of the table and then waits for the specific time.

In the example above, if you want to click in the Table cell Object Textarea “Your Comments” and wait for specified time then, use this keyword as shown below:

ClickTableCellAndWait

Object	< Choose your Table Object From OR >
Row Index	1
Column Index	1
Tag	Text Area
Tag Index	0
Time Out	5

Common Error conditions

Scenarios

Error Message

Debug Information

When no object is provided

Argument Data Missing (-13200)

DESCRIPTION:

Data not provided for argument: 'Object'. Expected Static Value was empty.

When InValid object and blank Data Input Arguments are provided.

Argument Data Invalid (-13300)

DESCRIPTION:

Specified Object is not table

CloseAllBrowsers

This keyword closes all the open browser sessions started by OpKey. It does not take any input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Browser

Browser Name

Comment

Browser 1

Browser 2

Mozilla Firefox

Google Chrome

In this example, CloseAllBrowsers keyword closes all browsers opened by OpKey.

Common Error conditions

Scenarios

Error Message

Debug Information

If given URLs in browsers are not valid

Browser: Mozilla Firefox

URL: bvmmn,m./,

Browser: Mozilla Firefox

URL: www.m,m.,m.,./?/

Conflicting Configuration (-14400)

2 instance(s) of WebDriver

existsClosing: about:blank&utm_

content=first

runClosing: https://www.m,m.,m.,./?/

Argument(s) : (Browser;URL) are blank.

If given browser names are not valid

Browser: nb,m.,

URL: www.opkey.com

Browser: nb,m.,

URL: www.opkey.com

Argument Data Invalid (-13300)

Please Reverify the BrowserName at OpenBrowser step.

plugin-unable-to-take-snapshot-

CloseBrowser

This keyword closes the currently opened browser session. It takes the browser title of the opened web application as data input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.

Data Input Arguments	Required?	Description
Title	Yes	This keyword takes the Browser Title as data input argument.

Output

It closes the web application running over the browser	If the keyword passes successfully
False	If the keyword fails

Example

Suppose you want to close the www.flipkart.com web application running over the mozilla Firefox web browser then you can use the keyword “Close Browser” as follows:

CloseBrowser

Title

Online Shopping Site for Mobiles, Fashion, Books, Electronics, Home Appliances and More.

Common Error conditions

Scenarios

Error Message

Debug Information

If browser name and URL of web application is not given.

Browser:

URL:

Object Input Argument: Object given

Insufficient Privileges (-14100)

DESCRIPTION:

The system does not have sufficient privileges to carry out a particular task. This mostly happens when the currently logged-in user at the execution site does not have permission to access a particular resource. The protected resource may be a network share, folder or a drive. User may contact the system administrator to sort out the issue.

Either Browser was never Opened or all WebDriver instances were closed

When Blank Data Input Arguments are passed.

Argument Data Missing (-13200)

DESCRIPTION:

Argument(s) :(Title) is/are blank.

CloseSelectedWindow

This keyword closes the selected window. It takes title name of the window to be closed as data input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.

Data Input Arguments	Required?	Description
Title	Yes	Specify the Title of the window that has to be closed.

Output

It closes the given window	If the keyword passes successfully
False	If the keyword fails

Example

URL

Comments

https://cresconnect.crestechglobal.com/index.php?ref=https://cresconnect.crestechglobal.com/moredetail.

php?blogid=OTE5

This keyword Closes the selected window.

In the above screenshot if you want to close the opened window on the browser, you can use “CloseSelectedWindow” keyword as follows:

CloseSelectedWindow

Title

Crestech

Common Error conditions

Scenarios

Error Message

Debug Information

When the Data Input Argument “Title ” is incorrect.

Title : Cres

Argument Data Invalid (-13300)

DESCRIPTION:

Actually Found : < CresConnect > and Expected :

When the Data Input Argument “Title ” has been left blank.

Argument Data Missing (-13200)

DESCRIPTION:

Argument(s) Title is/are blank.

CopyFromClipBoard

This keyword copies the content from clipboard on the provided location like on editbox, textarea or in any file.

This keyword is used in situations where you need to provide data in an editfield or file or textarea from clipboard. The text of clipboard might change in different scenario.

Note: Some data should be available in your clipboard.

For example, if you want to type text on any editbox from data available in clipboard, you will use output of “CopyFromClipBoard” keyword as input of “TypeTextOnEditBox” keyword .

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

This keyword copies the content from clipboard on the provided location like on editbox, textarea or in any file.

This keyword is used in situations where you need to provide data in an editfield or file or textarea from clipboard. The text of clipboard might change in different scenario.

If the keyword passes successfully

Data on clipboard is not fully string

If the keyword fails

Example

In the example above, if you want to type text on “FirstName” editbox using data from clipboard, here is how you will use this keyword.

Create a flow of TC/FL and add “CopyFromClipBoard” keyword and user is having data “opkey” in clipboard.

Create “StepOutput” variable (say “output1”) of this “CopyFromClipBoard” keyword .

Now add “TypeTextOnEditBox” keyword and use “output1” (output of above step) in DataInputArguments of this keyword.

The content of clipboard will be available on “Editbox” after execution.

Note: No error condition available for this keyword.

DeSelectAllDropDownItemsAndWait

This keyword deselects all previously selected items from the dropdown and waits for specified seconds.

This keyword is mostly used in situations where you need to remove all selection from a dropdown and then wait for specified seconds. Number of previously selected item in dropdown might change in different scenarios.

For example, you want to remove all selection from any dropdown and then wait for the time specified.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This Keyword takes one dropdown object input argument. You can choose the dropdown object from your Object Repository from which you want to deselect all items.

Data Input Arguments	Required?	Description
Timeout	Yes	Specify the time upto which you want to wait for object to be visible and operable.

Output

True

If the keyword passes successfully

False

If the keyword fails

Example

In the above screenshot, if you want to deselect all three selections “Agatti Island”, “Agra” and “Ahmedabad”, here is how you will use “DeSelectAllDropDownItemsAndWait” keyword

DeSelectAllDropDownItemsAndWait

Object	< Choose an Dropdown Object from the OR > Here, Within India
TimeOut	10

Common Error conditions

Scenarios	Error Message	Debug Information
If dropdown object is not found	Object Not Found	Cannot locate element with text
If timeout not specified	Argument Data Missing	Argument are missing

DeSelectCheckBox

This keyword deselects the selected checkbox. It takes checkbox object as Object input argument but it doesn’t take any data input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes checkbox object as object input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

True

If the keyword passes successfully

False

If the keyword fails

Example

Image	Comments
	This keyword deselects the selected checkbox

In this example, "DeselectCheckBox" keyword deselects the selected checkbox . While using "DeselectCheckBox" keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application having checkbox to be cleared/unchecked.

DeSelectCheckBox

Object

< Choose an CheckBox Object from the OR > Here, CheckBox

Common Error conditions

Scenarios

Error Message

Debug Information

If OR object is not mapped with the

DeSelectCheckBox keyword.

Browser: Mozilla Firefox

URL: https://www.globalguideline.com

/JavaScript_Guide/preview.php?JScript=Check_box_selection_using_Form

Object Input Argument: No Object

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty.

If URL of web application is not given in OpenBrowser

Browser: Mozilla Firefox

URL:

Object Input Argument: Object Mapped

Argument Data Missing (-13200)

Insufficient Privileges (-14100)

Argument Data Missing (-13200)

Argument(s) : (URL) are blank

Either Browser was never Opened or all WebDriver instances were closed

-plugin-unable-to-take-screenshot-

Data not provided for argument: 'Object'. Expected StaticValue was empty.

If browser name is not given in OpenBrowser

Browser:

URL: https://www.globalguideline.com

/JavaScript_Guide/preview.php?JScript=Check_box_selection_using_Form

Object Input Argument: Object Mapped

Argument Data Missing (-13200)

Insufficient Privileges (-14100)

Argument(s) : (URL) are blank

Either Browser was never Opened or all WebDriver instances were closed

-plugin-unable-to-take-screenshot-

Data not provided for argument: 'Object'. Expected StaticValue was empty.

DeSelectCheckBoxAndWait

This keyword deselects the specified selected CheckBox and wait for the given time. It takes checkbox object and time (in seconds) to wait after clearing that checkbox.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes checkbox object as object input argument.

Data Input Arguments	Required?	Description
TimeOut	Yes	This keyword takes timeout as data input argument.

Output

True

If the keyword passes successfully

False

If the keyword fails

Example

Image	Comments
Timeout : 10	This keyword deselects the specified selected CheckBox and wait for the given time.

In this example, this keyword deselects the selected "checkbox" and waits for the given timeout value. While using "DeSelectCheckBoxAndWait" keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application having checkbox to be cleared/unchecked.

DeSelectCheckBoxAndWait

Object	< Choose an CheckBox Object from the OR > Here, CheckBox
TimeOut	10

Common Error conditions

Scenarios	Error Message	Debug Information
When timeout value is not given. Browser: Mozilla Firefox URL: https://www.globalguideline.com /JavaScript_Guide/preview.php?JScript=Check_box_selection_using_Form Object Input Argument: Object Mapped Object Input Argument: Timeout Null	Argument Data Missing (-13200) Argument(s) : (Timeout) are blank
If Object and Timeout value is not given Browser: Mozilla Firefox URL: https://www.globalguideline.com /JavaScript_Guide/preview.php?JScript=Check_box_selection_using_Form Object Input Argument: Object Input Argument: Timeout Null	Argument Data Missing (-13200)	Data not provided for argument: 'Object'. Expected StaticValue was empty
If browser name and URL of web application is not given. Browser: URL:	Argument Data Missing (-13200) Insufficient Privileges (-14100)	Argument(s) : (URL) are blank Either Browser was never Opened or all WebDriver instances were closed

DeSelectDropDownItem

This keyword deselects the previously selected item from a dropdown and reset the object to it's default value. This keyword takes dropdown object and value to be deselected as Data Input Arguments.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes dropdown object as object input argument.

Data Input Arguments	Required?	Description
Item String	Yes	Specify the Item to be deselected from the dropdown.

Output

True

If the keyword passes successfully

False

If the keyword fails

Example

Image	Comments
	This keyword deselects the selected value "1" from the dropdown

In the example screenshot, if you want to deselect the selected item "1" from the dropdown list and reset the object to it's default value. Then you can use "DeSelectDropDownItem" as follows.

DeSelectDropDownItem

Object	< Choose an DropDown Object from the OR > Here, Within India
ItemString	1

While using this keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application having dropdown list of items.

Common Error conditions

Scenarios

Error Message

Debug Information

If Object in Object input argument and ItemString in Data input argument is not given

Browser: Mozilla Firefox

URL: https://www.crestechsoftware.com/

CrestShop/

Object Input Argument: Object not given

Data Input Argument: Item not given

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty

If browser name and URL of web application is not given.

Browser:

URL:

Object Input Argument: Object given

Data Input Argument: Item given

Argument Data Missing (-13200)

Insufficient Privileges (-14100)

Argument(s) : (URL) are blank

Either Browser was never Opened or all WebDriver instances were closed

-plugin-unable-to-take-screenshot-

Data not provided for argument: 'Object'. Expected StaticValue was empty.

DeSelectDropDownItemAndWait

This keyword deselects the previously selected items from a dropdown and reset the object to it's default value and waits for the given timeout. This keyword takes dropdown object as Object Input argument and timeout as Data Input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes dropdown object as object input argument.

Data Input Arguments	Required?	Description
ItemString	Yes	Specify the Item to be deselected from the dropdown.
Timeout	Yes	Specify time in seconds.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Image	Comments
Timeout = 10	This keyword deselects the specified selected items from a dropdown and waits for specified time.

In the above screenshot, If you want to deselects the selected item "1" and then waits for the given timeout then this is how you will use "DeSelectDropDownItemAndWait" keyword .

DeSelectDropDownItemAndWait

Object	< Choose an DropDown Object from the OR > Here, Within India
ItemString	1
TimeOut	10

While using "DeSelectDropDownItemAndWait" keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application having dropdown list of items.

Common Error conditions

Scenarios

Error Message

Debug Information

If timeout and Item String is not given in

Data input argument

Browser: Mozilla Firefox

URL: https://www.crestechsoftware.

com/CrestShop/

Object Input Argument: Object given

Data Input Argument: Timeout not given

Argument Data Missing

Argument(s) : (Timeout) are blank

If browser name and URL of web application is not given.

Browser: Mozilla Firefox

URL: https://www.crestechsoftware.com

/CrestShop/

Object Input Argument: Object Not given

Data Input Argument: Item given

Data Input Argument: Timeout given

Argument Data Missing (-13200)

Data not provided for argument: 'Object'. Expected StaticValue was empty.

DeSelectMultipleDropDownItem

This keyword deselects specified items from multi dropdown object.

This keyword is mostly used in situations where you need to remove few items from a multi dropdown object.The Number of item you want to deselect from multi dropdown might change in different scenarios.

For example, you want to deselect two item from the multiple selected dropdown items.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This Keyword takes one multi dropdown object input argument. You can choose the multi dropdown object from your Object Repository from which you want to deselect several items.

Data Input Arguments

Required?

Description

ItemString

Yes

Specify the name of item which you want to deselect.

Note: You can provide more than one item by separating them from delimiter(for ex delimiter can be colon ’:’,semicolon ’;’ etc.)

Output

True

If the keyword passes successfully

False

If the keyword fails

Example

In the Multiple selection dropdown above, if you want to deselect two selections “Agartala” and “Agatti Island”, here is how you will use this keyword “DeSelectMultipleDropDownItem”.

DeSelectMultipleDropDownItem

Object

< Choose an DropDown Object from the OR > Here, Within India

ItemString

Agartala; Agatti Island

Note: Delimiter can be ‘;’ , ‘:’ etc.

Common Error conditions

Scenarios	Error Message	Debug Information
If dropdown object is not found	Object Not Found	Cannot locate element with text
If ItemString specified is blank or incorrect	Text Not Found	Expected item does not exist among selected option

DeSelectMultipleDropDownItemInTableCell

This keyword deselects specified items from multi dropdown object placed inside a table cell. If there are multiple items selected and user need to deselect two items then user needs to use this keyword twice, once for each item to be deselected. This keyword is mostly used in situations where you want to deselect multiple selected items in table cell before performing any action on it. For example, you want to deselect the selected items in table cell.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This Keyword takes one table object input argument. You can choose the table object from your Object Repository.

Data Input Arguments	Required?	Description
Row Index	Yes	Specify Row id of table. Starting index must be zero.
Column Index	Yes	Specify Column id of table. Starting index must be zero.
Object Index	Yes	Specify the index. Starting index must be zero.
Value	Yes	This Keyword takes the text value which is selected in dropdown.

Note: Index Value must start from ‘0’ onwards.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

In the above Screenshot, if you wish to deselect "Opel" from the multi dropdown then you can use this keyword "DeSelectMultipleDropDownItemInTableCell" as follows:

DeSelectMultipleDropDownItemInTableCell

Object	< Choose your table object from OR >
Row Index	0
Column Index	0
Object Index	0
Value	Opel

Common Error conditions

Scenarios	Error Message	Debug Information
If no object is selected	<Data not provided for argument: 'Object'. Expected StaticValue was empty.>	Argument Data Missing (-13200) DESCRIPTION: A step could not be executed because one or more of the arguments have not been provided a value. Of all the arguments a keyword accepts, some arguments might be compulsory. As opposed to the non-compulsory ones, the compulsory argument must be provided some data. The data may be provided through one of many sources like statically entering, output of a previous step, a global variable etc; but it must not be left blank.
If Object is Provided but Data input argument is not Provided	Argumemt(s) : (Row Index;Column Index;Index;Value) are blank.	Argument Data Missing (-13200) DESCRIPTION: A step could not be executed because one or more of the arguments have not been provided a value. Of all the arguments a keyword accepts, some arguments might be compulsory. As opposed to the non-compulsory ones, the compulsory argument must be provided some data. The data may be provided through one of many sources like statically entering, output of a previous step, a global variable etc; but it must not be left blank.
If Object is not Provided but Index Value is Provided	Data not provided for argument: 'Object'. Expected StaticValue was empty.	Argument Data Missing (-13200) DESCRIPTION: A step could not be executed because one or more of the arguments have not been provided a value. Of all the arguments a keyword accepts, some arguments might be compulsory. As opposed to the non-compulsory ones, the compulsory argument must be provided some data. The data may be provided through one of many sources like statically entering, output of a previous step, a global variable etc; but it must not be left blank.
If Index data is wrong	Expected item does not exist among selected option(s) Actually Found :<> and Expected :<6646>	Text Not Found (-11300) DESCRIPTION: No object could be located on the currently active page/view with the matching text. This happens mostly when the page is not properly loaded or the view is not properly rendered. It might happen with a misspelled argument to the keyword.

DismissPopUp

This keyword removes currently available popup on browser.

This keyword is mostly used in situations where we don’t have any information about title of the pop up and you can dismiss such pop up using “DismissPopup” keyword. It don’t require any Object input argument as well as any Data input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	No	This keyword doesn’t take any object input argument.

Data Input Arguments	Required?	Description
Data	NO	This keyword doesn’t take any data input argument.

Output

True

If the keyword passes successfully

False

If the keyword fails

Example

In the screenshot above, if you want to remove this pop up “Message from webpage” , you can use "DismissPopup" keyword. It removes any available pop from the active window.

Common Error conditions

Scenarios	Error Message	Debug Information
If popup not found on browser	Unsatisfied Dependencies	Popup not found

DoubleClick

This keyword double clicks on the specified object. It takes one object as input argument.

Input Arguments

Object Input Arguments	Required?	Description
Object	Yes	This keyword takes one object as object input argument.

Data Input Arguments	Required?	Description
Data	No	This keyword doesn’t take any data input argument.

Output

True	If the keyword passes successfully
False	If the keyword fails

Example

Image	Comments
	In this web page, this keyword double clicks on the Double click me button to perform the desired action.

In the above screenshot, we will double click on "Double-click me" button to perform the desired action. While using Doubleclick keyword, you should ensure that you are using this keyword with a relevant keyword (like OpenBrowser) which can open your web application having a button in which double click is accepted.

DoubleClick

Object

< Choose your object from Object Repository > Here, Double-click me

Common Error conditions

Scenarios	Error Message	Debug Information
When Browser Name & URL are not given. Browser: URL: Object Input Argument: Double click me	Argument Data Missing (-13200) Insufficient Privileges (-14100)	Either Browser was never Opened or all WebDriver instances were closed -plugin-unable-to-take-screenshot-
If Valid object Input argument is provided Browser: Mozilla Firefox URL: https://www.w3schools.com/tags/tryit.asp?filename=tryhtml5_ev_ondblclick Object Input Argument: Double click me	Done	Not Available.
When No object is provided.	Argument Data Missing (-13200)