Selenium Framework Implementation Guide

Selenium Open Source Test Automation
Framework Implementation Guide
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. PURPOSE OF THE DOCUMENT ........................................ 3
2. FRAMEWORK IMPLEMENTATION IN SELENIUM .............................. 4

2.1. Test Settings for Keyword-Driven Scripting ....................... 4
3. SELENIUM RC – SERVER UP ....................................... 6
4. MANAGING OBJECT REPOSITORY...................................... 8
5. CALL TO FRAMEWORK ............................................ 10
6. USAGE OF KEYWORDS ............................................ 11
7. TEST RESULTS FOR A KEYWORD-DRIVEN SCRIPT ......................... 12
8. RESOURCE FILES .............................................. 14
Open2Test.org Page ii
1. Purpose of the Document

This document provides an overview of the prerequisites and settings
required to implement the keyword-driven framework in Selenium RC
Open2Test.org Page 3
2. Framework Implementation in Selenium

The keyword-driven framework is an application-independent framework
that performs all possible actions and verifications on an object.
Hence, the code for the same object can be used across different
applications.
2.1. Test Settings for Keyword-Driven Scripting

In the keyword-driven approach, the entire script is developed with
keywords. The script is developed in a spreadsheet that is
interpreted by the main driver script, which then uses the function
library to execute the complete script.
a. The test suite, test script, object repository and report folder
location should be mentioned in Selenium_Utility excel.
File\Folder
Name Location
Test Suite C:/Innovez/Selenium_Automation/Test_Suite.xls
Test Script C:/Innovez/Selenium_Automation/Test_Scripts/
Object
Repository C:/Innovez/Selenium_Automation/Test_Data/Object_Repository.xls
Summary
Report C:/Innovez/Selenium_Automation/Test_Reports/
Screen Shot C:/Innovez/Selenium_Automation/Test_Reports/ScreenShot_Repor
Report t/
Detailed Report C:/Innovez/Selenium_Automation/Test_Reports/Detailed_Report/
Note: The selenium utility excel file should be placed in

C:\Documents and Settings\Mantis\Demo-Selenium\Selenium_Utility.xls
b. Collect the properties of objects and define it in

Object_Repository.xls like below
ObjectName ObjectIdentification ObjectType
Username username TextBox
Password password TextBox
Login //input[@value='Login'] Button
Manage link=Manage link
Manage Projects link=Manage Projects link
c. Define the test scripts in the test suite Excel like below
Run Test Driver

r Mantis_Create Project
r Mantis_Report Issue
r Mantis_View Issue and Delete Project
r Mantis_Fail
r Call Tariff Addition and Amendment
d. Write the keywords for the test script like below
Step Operation Object Action

r callaction C:\Documents and Settings\Mantis\Demo-
Selenium\Innovez\Selenium_Automation\Test_Scripts\Login
Action.xls
r perform link;Manage Projects click
r wait 3
r perform Button;Create New Project click
r perform Textbox;Project Name set:Selenium
3. Selenium RC – Server up
• Starting the server:

java -jar selenium-server.jar –interactive
Figure 1: Selenium RC server up and running
Figure 2: Selenium RC running – Embedded Browser
4. Managing Object Repository

Selenium must learn the interface of an application to be able to work
with it. It does this by learning the application's objects and their
corresponding property values and storing these object descriptions in
an object repository file. There are two types of object repositories:
the shared object repository, and the per-action object repository.
The same object repository file can be used for multiple tests if the
tests include the same objects. Object information that applies to many
tests is kept in one central location and the read-only copy of the
repository is associated with the tests.
Here the object repository is maintained in the form of Excel sheets.
XPath is also installed as a plug-in to Firefox. To identify the object
properties, open Firefox browser, right click on the object and select
Show in XPather. The XPather Browser window opens and XPath value is
used as the object with logical names.
For Internet Explorer, make use of its add-in ‘Developer Too’ to get the
unique id or text for the object.
Figure 3: XPather – Object Identification
5. Call to Framework
The Main.rb should be opened in the SciTE. Press F5 and this will call
the framework file associated with the test and perform the actions by
interpreting the keywords specified in the data table.
Instead of pressing F5, we are able to run the main.rb by command ruby
<main.rb>
Figure 4: Call to Framework
6. Usage of Keywords
The keywords should be entered in Sheet1 of Microsoft Excel placed in
the Test Scripts folder. The syntax for the keywords can be found in the
Selenium Keyword Reference Dictionary Document. Below is an example of a
simple keyword-driven scripting.
Figure 5: Using the Keyword
7. Test Results for a Keyword-Driven Script

Test execution results can be viewed and analyzed as soon as the run
session ends. To access the test results, go to the Test_Reports folder
customized using the Test automation framework. Two folders will be
available: one showing the summary report for Test suite execution, and
another folder Detailed_Report displaying the detailed step-wise test
results for the each test script. A screenshot will be available for the
failure scripts under ScreenShot_Report.
Figure 6: Test Results summary for a Test suite
Figure 7: Detailed Test Results for a Test script
8. Resource Files
The resource files such as Framework Files, Shared Object Repositories,
and Environment Variables that are associated with the test can be
stored in the user’s machine and can be obtained during test execution.
Function libraries of the file type .rb, environment variables of file
type .excel, and object repositories of file type .excel can be placed
in the folder specified in the Utility Excel.
File\Folder
Name Location
Test Suite C:/Innovez/Selenium_Automation/Test_Suite.xls
Test Script C:/Innovez/Selenium_Automation/Test_Scripts/
Object Repository C:/Innovez/Selenium_Automation/Test_Data/Object_Repository.xls
Summary Report C:/Innovez/Selenium_Automation/Test_Reports/
Screen Shot
Report C:/Innovez/Selenium_Automation/Test_Reports/ScreenShot_Report/
Detailed Report C:/Innovez/Selenium_Automation/Test_Reports/Detailed_Report/
Note: The selenium utility Excel file should be placed in

C:\Documents and Settings\Mantis\Demo-Selenium\Selenium_Utility.xls
Library files
1. Main.rb
2. Functionlibrary.rb
Figure 8: Resource Files
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.
You should have received a copy of the GNU Library General Public License along with this
library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
MA 02110-1301, USA.

Selenium Framework Implementation Guide

Uploaded by

Copyright:

Available Formats

Selenium Framework Implementation Guide

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Selenium Framework Implementation Guide

Uploaded by

Copyright:

Available Formats

What are the prerequisites and settings required to implement the keyword-driven framework in Selenium?

What are the prerequisites and settings required to implement the keyword-driven framework in Selenium?

What are the steps involved in defining test scripts in the test suite Excel?

What are the steps involved in defining test scripts in the test suite Excel?

Selenium Open Source Test Automation

Framework Implementation Guide

2. FRAMEWORK IMPLEMENTATION IN SELENIUM .............................. 4

3. SELENIUM RC – SERVER UP ....................................... 6

4. MANAGING OBJECT REPOSITORY...................................... 8

5. CALL TO FRAMEWORK ............................................ 10

6. USAGE OF KEYWORDS ............................................ 11

7. TEST RESULTS FOR A KEYWORD-DRIVEN SCRIPT ......................... 12

8. RESOURCE FILES .............................................. 14

1. Purpose of the Document

2. Framework Implementation in Selenium

2.1. Test Settings for Keyword-Driven Scripting

Note: The selenium utility excel file should be placed in

b. Collect the properties of objects and define it in

Run Test Driver

d. Write the keywords for the test script like below

Step Operation Object Action

• Starting the server:

Figure 1: Selenium RC server up and running

Figure 2: Selenium RC running – Embedded Browser

4. Managing Object Repository

Figure 3: XPather – Object Identification

Figure 4: Call to Framework

Figure 5: Using the Keyword

7. Test Results for a Keyword-Driven Script

Figure 6: Test Results summary for a Test suite

Figure 7: Detailed Test Results for a Test script

Note: The selenium utility Excel file should be placed in

Figure 8: Resource Files

You might also like