Selenium Open Source Test Automation Framework Scripting Standards

Version 1.0
September 2009

DISCLAIMER Verbatim copying and distribution of this entire article is permitted worldwide, without royalty, in any medium, provided this notice is preserved.

Table of Contents

TABLE OF CONTENTS
1. 2. INTRODUCTION ................................................. 3
1.1. Purpose .......................................................... 3
FOR

STANDARDS
2.1. 2.2.

KEYWORD SCRIPTING .................................. 4

Getting Started .................................................. 4 Column Description of Test Suite ................................. 4 2.2.1. Column A ................................................ 4 2.2.2. Column B ................................................ 4

2.3.

Column Description of Test Case .................................. 4 2.3.1. Step (Column A) ......................................... 5 2.3.2. Operation (Column B) .................................... 5 2.3.3. Object (Column C) ....................................... 7 2.3.4. Action (Column D) ....................................... 8 2.3.5. Screenshot (Column E) .................................. 11 2.3.6. Comments (Column F) .................................... 12 2.3.7. Delimiters............................................... 13 2.3.8. Variables................................................ 13

3.

SEQUENCE
3.1.

OF

KEYWORDS.......................................... 15

Use of Conditional Statements .................................. 15

Open2Test.org

Page ii

Selenium Open Source Test Automation Framework Scripting Standards for Web

1.
1.1.

Introduction
Purpose
This document provides details about the various columns used during scripting, the keywords and their descriptions, along with methodologies to be followed while scripting using keywords.

Open2Test.org

Page 3

Selenium Open Source Test Automation Framework Scripting Standards for Web

2.
2.1.

Standards for Keyword Scripting

Getting Started
Before learning about the columns used for keyword scripting, the user should know the keyword script and how the framework is called. The execution is started by running the file Main.rb. In the main class when the method test_new() is called, it will call a method named importdata(). This method importdata() imports the location of all the project directories specified in the particular Excel sheet and will call the method keyword_driver(), which will perform the actual test execution.

2.2.

Column Description of Test Suite

This section describes the columns used in the test suite for keyword scripting.

2.2.1.

Column A The data in the Run column identifies whether the test case is to be run (automated) or not. This column has the letter r, which denotes that the test case should be run. If any step in the test suite is not being run, then the corresponding row in the first column is to be left blank.

Figure 1: Column Run

2.2.2.

Column B The second column of the test suite indicates the name of the Test Case that has to be executed. So, if the column A is specified r, it means that the particular test case is going to be executed.

2.3.

Column Description of Test Case

This section describes the columns used in Test Case for keyword scripting.

Open2Test.org

Page 4

Selenium Open Source Test Automation Framework Scripting Standards for Web 2.3.1. Step (Column A) The data in column A identifies whether the current step in the test case is to be run or not. This column has the letter r, which denotes that the current step should be run. If any step in the test case is not being run, then the corresponding row in the first column is to be left blank. All the steps will run based on the data in this column.

Figure 1: Column Step

2.3.2.

Operation (Column B) The second column of the test case sheet indicates the generic type of action being performed on the application under test (AUT). This column is dedicated to different types of actions that will be performed on a particular object.

Open2Test.org

Page 5

Selenium Open Source Test Automation Framework Scripting Standards for Web
Figure 2: Column Operation

The keywords that can be used in this column are: 1. LaunchApp LaunchApp is used to launch the AUT. This keyword triggers the driver script to launch the application. This will launch the application either in Internet Explorer or in Firefox, depending upon the browser specified in the main.rb file. 2. Context Context is used only to highlight a particular object in a web page. 3. Perform Perform is used to perform an operation on a particular object (ex: clicking on a button on a Web page, or typing some text in a textbox). This keyword should be entered in the corresponding row in the second column if any such operations are to be performed. 4. Check Check is used to check if the required property of a particular object is attained at runtime. This is a type of validation step (expected result). 5. Condition Condition is used to compare two variables, check properties for the existence of windows, etc. 6. CallFunction Call Function is used to call any declared function used in a particular script. These functions should be declared in a different .rb file. 7. Storevalue Storevalue is used to store the property values of different objects in different environment variables. These environment variables can later be used as input parameters in various functions and also in scripts. 8. PressKey Press Key is used to pass hot keys such as Enter, F3, F10, etc. 9. Report Report is used for customized reporter events. It is displayed in the result sheet. The report results can include: i) Pass, ii) Fail, iii) Done, iv) Warning. 10. Strsearch Strsearch is used to search for a sub string inside a main string. 11. Strreplace Strreplace is used for replacing a sub string inside a main string with a new sub string. 12. Strconcat

Open2Test.org

Page 6

Selenium Open Source Test Automation Framework Scripting Standards for Web Strconcat is used to concatenate any number of strings with one other. 13. 14. Wait Wait is used to place static waits in the keyword script. Assignvalue Assignvalue is used to assign dynamically generated values from the application to environment variables. 15. Callaction Callaction is used to call reusable actions that are declared in the script. 16. Loop Loop is used to loop a set of actions given in the data table. 17. Popup Popup keyword is used to perform any action on a Windowsbased popup that pops up while performing any action in the application under test.

A detailed description of the keywords is provided in the Selenium Open Source Test Automation Framework Keywords for Web document.

2.3.3.

Object (Column C) The third column of the test case sheet is used to indicate the object on which a particular type of action is to be performed. When the object is present in the object repository, the object class and object name are specified in column C (as shown in Example 1). However, if the object is not added to the object repository, descriptive programming can be used by specifying any property and its value (as shown in Example 2). The object column, or column C, contains all the required details for an object (viz. Class to which the objects belong to and the object name) on which various operations and validations are to be performed.

Example 1:

Action Perform Perform

Object Element;OK Textbox; Lastname

In the above example, the object column indicates that some operation has to be performed on an object of class WebElement having the name OK. Similarly, in the next line, some operation has to be performed on an object of class Textbox having the name Lastname.
Action Perform Object Element;text:=OK

Open2Test.org

Page 7

Selenium Open Source Test Automation Framework Scripting Standards for Web
Perform Textbox;name:=Lastname

Example 2:

In the above example, the object is not added to the object repository. Some operation has to be performed on an object of class WebElement having a property text, the value of which is OK. Similarly, some operation has to be performed on an object of class Textbox having a property name, the value of which is Lastname.
The object and its name are usually separated by a delimiter ; as shown in the above example. (Delimiters will be covered later in this document).

Figure 3: Column Object

2.3.4.

Action (Column D) The forth column of the test case sheet is used to indicate the specific action being performed on the objects present in the AUT. It contains the details of all the operations or verifications to be performed on the objects listed in the objects column. Consider the example of the object Button with name Login. One of the actions that can be performed on a button would be Click. Therefore, in column 4, the above operation is put in the keyword form as CLICK. Example 2: The keyword CLICK on a Login button is as follows:

Action Perform

Object Button;Login

Operation Click

ACTION

Open2Test.org

Page 8

Selenium Open Source Test Automation Framework Scripting Standards for Web

If user wants to check if the button is enabled before clicking, the syntax would be:

Action Check

Object Element;Login

Operation Enabled:True

CHECKING

Similarly, if the user wants to check whether the object is disabled, the syntax would be:

Action Check

Object Button;OK

Operation Enabled:False

CHECKING

Figure 4: Column Action

The most commonly used keywords for specific actions that can be used with the generic keyword Perform written in Column Action are: 1. Click Click is used to perform the click operation on objects (e.g., clicking a Webbutton, linking a Webelement, etc). 2. Close Close is used to perform the close operation on any open objects. (e.g., closing a browser, window, or dialog box).

Open2Test.org

Page 9

Selenium Open Source Test Automation Framework Scripting Standards for Web 3. Select:<name> Select button. 4. is used to select an item from Combobox or Radio

Selectindex:<index> Selectindex Combobox. is used to select an item from a Listbox or

5. 6.

Set:<Text> Set is used to assign a value to an edit field. Set:d_currenttime Set:d_currenttime sets the current system time in the edit field.

7.

Set:d_currentdate Set:d_currentdate sets the current system date in the edit field.

8.

Set:d_d; <value to be added/subtracted> This function adds or subtracts the value specified to the current system date and sets the edit field to a given value.

9.

Set:d_m; <value to be added/subtracted> This function adds or subtracts the value specified to the current system month and sets the edit field to a given value.

10.

Set:d_y; <value to be added/subtracted> This function adds or subtracts the value specified to the current system year and sets the edit field to a given value.

11.

Submit This function is used to submit the value entered in a Textbox, Combobox, or Radio button, etc.

12. 13.

Deselect:<name> This function is used to deselect a selected item in a list. set:env_<Environment Name> This function is used to assign the value, which is stored in the environment variable, to the edit field.

14.

set:dt_Parameter This function is used to assign the value, which is given in the external test data sheet, to the edit field.

15.

set:#<variable> This function is used to assign the value, which is stored in the variable, to the edit field.

16.

Create;<Folder Path/Name>/<File Path/Name> This function is used to create a folder/file in the specified path.

17.

Delete;<Folder Path/Name>/<File Path/Name> This function is used to delete a folder/file in the specified path.

Open2Test.org

Page 10

Selenium Open Source Test Automation Framework Scripting Standards for Web The most commonly used keywords for specific actions used with the generic keyword Check written in Column Action are: 1. Selection:<item name> This is a Check operation that is used to verify whether the desired item is selected in the Combobox. 2. Checked:<Name> This is a Check operation which is used to verify whether a Radio button in a Webradiogroup whose name is specified is checked or not. 3. Checked:<True/False> This is a Check operation that is used to verify whether a Checkbox is checked or not. 4. Enabled:<True/False> This is a Check operation that is used to verify whether the given Web object is enabled or not. 5. Exist:<True/False> This is a Check operation that is used to verify whether the Web object whose name is specified exists or not. 6. Focused:<True/False> This is a Check operation that is used to verify whether the object is focused or not. 7. Visible:<True/False> This is a Check operation that is used to verify whether the specified object is visible or not. 8. Text:<text/#Variable_Name> This is a Check operation that is used to verify whether the required text is present in the object. 9. text:<text to search> This is a Check operation that is used to verify whether a string is present or not in the table. 10. search:<text> This is a Check operation that is used to verify whether the value of the string is in the current row of the object or not. 11. search:#<variable name> This is a Check operation that is used to verify whether a value stored in the environment variable is in the current row of the Combobox. 12. text:blank This is a Check operation that is used to verify whether a text field is blank. 2.3.5. Screenshot (Column E) The fifth column of the test case sheet is used to specify if a screen shot is required in a particular test step. In the below figure, Y is specified for checks of title and a textbox, so in these steps a screen shot will be taken and a .doc report will be

Open2Test.org

Page 11

Selenium Open Source Test Automation Framework Scripting Standards for Web created. If the column is left blank, then no screenshot will be taken. Screenshots will also be taken automatically when there is a failure in any step.

Figure 5: Column Screenshot

2.3.6.

Comments (Column F) The Comments Column is used to enter generic information about the current step being run. It provides a better understanding of the steps being performed in the particular test script and also helps to map the test script to the manual test case.

Figure 6: Column Comments

Open2Test.org

Page 12

Selenium Open Source Test Automation Framework Scripting Standards for Web 2.3.7. Delimiters Delimiters are any string characters used to identify the sub-string limits. Delimiters are generally used with the Split function, which is used to split the input into different substrings Purpose of Delimiters: Delimiters break down the input values to different strings and take them as keywords to perform any operation concerned with that object. Delimiters Used in this Framework: When scripting using the keyword-driven approach, use separators or delimiters appropriately between two keywords. Delimiters that are used in the framework are: : (colon) ; (semi colon) :: (double colon)

Using Delimiters: There are four columns involved in the keyword-driven approach. The role of delimiters comes in the Objects column (column 3) and the Action column (column 4). Objects column (column 3): This column is used to define the class and the name of the object. The delimiter used in this column to separate the class of the object and the name of the object is a semi-colon ;. Example:
Textbox; <textboxname>

Action column (column 4): This column usually provides details of the operations that need to be performed on the object. The delimiter used to separate the property and the property values in this column is a colon :. Example:
pagetitle:true

To specify multiple parameter use the :: delimiter. This is used in case of keyword like report Example:

<event>;<exp1>:<exp2>::<act1>:<act2>

2.3.8.

Variables To store a value in a variable, an environment variable is used. Example:

Open2Test.org

Page 13

Selenium Open Source Test Automation Framework Scripting Standards for Web
assignvalue strName;Smith

Here in the variable strName, the value Smith is stored.

To input a value to a field from a variable, the variable should be preceded by #. Example:
Perform Textbox;<textbox name> Set:#varName

Here, the value stored in varName is typed into the textbox. Defining example, appended appended a variable requires the use of certain standards. For for a variable to store a string value it should be with Str ex.StrVarName. Similarly, an integer should be with int and Boolean should be appended with bln.

Open2Test.org

Page 14

Selenium Open Source Test Automation Framework Scripting Standards for Web

3.

Sequence of Keywords
While scripting using keywords, some keywords have to be written in combination with other keywords. This section deals with methodologies that should be followed while scripting using keywords.

3.1.

Use of Conditional Statements

If the user is implementing an IfElse conditional statement, then the keyword is followed by a semi-colon ; and the values that indicate the start row and the end row should be separated by a semicolon ;. Example:
Condition <var1>;comparator;<var2> startrow;endrow

If the condition mentioned is True, execution starts from the startrow and would end at the endrow specified. If the condition specified is False, there would be no effect in the script and the execution would continue as normal.

Two conditional statements must be used together to satisfy the 'and' condition.
Condition Condition <var1>;comparator;<var2> <var2>;comparator;<var3> startrow;endrow startrow;endrow

This implies that an and operation is being performed.

COPYRIGHT This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

Open2Test.org

Page 15