JUnit Selenium adapter and Engineering Test Management

Selenium automates browsers, primarily for automating web applications for testing purposes. You can use the JUnit Selenium adapter to run Selenium version 2.0 WebDriver JUnit4 tests in Engineering Test Management.

Integration with Selenium is implemented by using a JUnit Selenium adapter. With the adapter, you can run Selenium version 2.0 WebDriver JUnit4 tests in Engineering Test Management. The adapter serves as a bridge between Selenium and Engineering Test Management.

While the adapter runs, it polls the Quality Management server for requests to run Selenium tests. Requests include the Java™ classes to run, such as a JUnit test suite or test case, and any extra class path values that are required. Optionally, requests can also include the Java system properties that are to be set for the Java virtual machine (JVM) that runs the test. After the test runs, the adapter uploads the execution result and associated attachments to the server.

Adapter setup

The required components for running the adapter are included in the RQMJUnitSeleniumAdapter.zip file, which is in the Engineering Test Management installation directory. To use the adapter, you must copy the file to the computer that runs the adapter and extract the file to a local directory. After you copy and extract the file, configure and start the adapter.
Note: The Selenium and JUnit packages that are required to run Selenium do not come with the JUnit Selenium adapter. You must download all of the required Selenium and JUnit4 packages and dependencies.

Prerequisites and known limitations

  • You must have a Java runtime environment (JRE) 1.6 on the computer that runs the JUnit Selenium adapter.
  • You must use a process that includes the Java executable file in the PATH environment variable to start the JUnit Selenium adapter.
  • Before you use the adapter, you must compile your JUnit tests to create .class files. The adapter does not come with a Java SDK, which is required for compiling Java sources.
  • The JUnit tests to run must be on the same computer that runs the adapter.
For more information about test tool adapters, including adapter version and user account requirements, see Rational® test tools integration overview.