Description
Selenium is a testing tool that automates web applications. It can also be used to automate basic browser functions and administration tasks.
- Overview
- Documentation
- Version history
Quick Info
Product
DevOps Deploy (HCL Launch)
Type
plugin
Compatibility
HCL Launch version 7.0 or later
Created by
HCL Software
Website
Published Date
Last Updated
Summary
Usage
Steps
Summary
This plugin includes one or more steps, click Steps for step details and properties.
Compatibility
This plugin requires HCL Launch version 7.0 or later.
This plugin runs on all operating systems that HCL Launch supports.
This plugin requires access to either the Selenium RC (1.0), Selenium Webdriver (2.X) Standalone Server JAR file, or Selenium Html Runner (3.X) JAR file. The selenium-server-standalone-2.XX.X.jar and selenium-html-runner-3.XX.X.jar files can be found on Seleniums Download page under previous releases. Note: Version 3 of the selenium-server-standalone JAR will require additional environment set up. For simplicity, we recommend the latest selenium-html-runner JAR.
Installation
See Installing plugins in HCL Launch for installing and removing plugins.
History
The following table describes the changes made in each plugin version.
| Version | Description |
|---|---|
| 8 |
|
Usage
The Run Test Suite step automates running of a Selenium test suite in an IBM Urban Code Deploy process. The step starts a temporary Selenium server and passes the specified test suite, which contains one or more tests, to be processed. The test suite can be created using Seleniums IDE and is written in a format called Selenese. The prior link is to documentation about Seleniums IDE and instructions on how to create a test and test suite. If this is your first time using Selenium, we recommend you start here. Once you have a firm understanding of Selenium and its uses, we encourage you to replicate the short tutorial below.
Step palette
To access this plugin in the palette, click Quality > Functional Testing > Selenium.
Steps
The following process steps are available in the Selenium plugin.
Run Test Suite
Run a Selenium test suite
| Name | Type | Description | Required |
|---|---|---|---|
| Selenium Jar Location | String | The fully-qualified path to the selenium-server-standalone (v2) or selenium-html-runner (v3) JAR file. For example: C:\Program Files\Selenium\selenium-server-standalone-2.53.1.jar. | Yes |
| Starting URL | String | The starting URL on which to execute the tests. For example: https://www.google.com. | Yes |
| Test Failure Threshold | String | The maximum percentage of failed tests that, if surpassed, results in the steps failure. Specify a value from 0 to 100. A value of 0 will have the step fail on any failure. A value of 100 ignores test results and always succeed if there are no runtime errors. Default value is 100. | No |
| Test Results | String | The fully-qualified path of the test results file or folder. If using a selenium-server-standalone-2.X.X.jar, specify a file. If using a selenium-html-runner-3.X.X.jar, specify a folder. For example: C:\Documents\testResults[.html]. If left empty, a file/folder named `testResults`is generated in the working directory. | No |
| Test Suite | String | The fully-qualified path to the HTML suite file. For example: C:\Documents\testSuite.html. | Yes |
| Web Browser | String | The web browser to run the tests. For example: *firefox. | Yes |
