Plug-in Documentation

IBM Rational Test Workbench Web UI Tester

Overview

Overview
With the IBM Rational Test Workbench Web UI Testerplugin for UrbanCode Deploy, you can automate the execution of tests and compound tests.
Rational Test Workbench Web UI Testermust be installed on the target computer on which the test is run. If a test is part of Rational Performance Tester schedule and the schedule must be run, install Rational Performance Tester and Rational Test Workbench Web UI Tester in the same package group (shell-sharing).
From version 9.0, Rational Test Workbench Web UI Tester is the new name for Rational Test Workbench Eclipse Client.

Compatibility
This plug-in requires version 6.1 of IBM UrbanCode Deploy.
This plug-in requires version 8.7 or later of Rational Test Workbench Web UI Tester.

Installation
No special steps are required for installing the plugin. See Installing plug-ins in UrbanCode Deploy documentation.

Steps

Process steps in the IBM Rational Test Workbench RTWec plug-in

Run RTWec Test

Execute Eclipse Client Tests from IBM Rational Test Workbench

Input properties for the Run RTWec Test step
Name Type Description Required
Config File String The complete path to a file that contains the parameters for a test or schedule run. No
Custom Report Format Files String A comma-separated list of absolute paths to custom report format files (.view files)
to use when exporting statistical report data with the -exportstatsoption.
No
Exported HTTP Test log File String The complete path to a file in which to store the exported HTTP test log. No
Exported Statistical Report Data File String The complete path to the directory in which to store exported statistical report data. No
Installation Manager Location String Complete path to Installation Manager. Yes
Number of Virtual Users String Overrides the default number of virtual users in the run. For a schedule, the default
is the number of users specified in the schedule editor. For a test, the default is
one user. This option creates a new copy of the schedule that contains the specified
number of users.
No
Overwrite Results file Boolean Determines whether a results file with the same name is overwritten. The default value,
true, means that the results file is overwritten.
No
Project String The path, including the file name, of the project relative to workspace. Yes
Quiet Boolean Turns off any message output from the launcher and returns to the command shell when
the run or the attempt is complete
No
Results File String The name of the results file. The default result file is the test or schedule name
with a time stamp appended.
No
Test Suite Name String The path, including the file name, of the test to run relative to the project Yes
User Comments String Add text within double quotation mark to display it in the User Comments row of the
report.
No
VM Args String Java virtual machine arguments to include in the test. No
Var File String The complete path to the XML file that contains the variable name and value pairs No
Workspace String Complete path to Eclipse workspace. Yes

Usage

Use the Rational Test Workbench Web UI Tester plugin to continuously initiate the test and compound test run from IBM UrbanCode Deploy.From version 9.0, Rational Test Workbench Web UI Tester is the new name for Rational Test Workbench Eclipse Client.
Before you begin

  • Install IBM Rational Test Workbench Web UI Tester version 8.7 or later and UrbanCode Deploy agent on the computer where the tests will be run.
  • Install UrbanCode Deploy server and deploy the plugin on the server.
    For information about installing UrbanCode Deploy, see its documentation.
  • Install UrbanCode Deploy Agent and connect it to UrbanCode Deploy server. See the documentation.
  • Ensure that Rational Test Workbench Web UI Tester is not running.
  • To initiate the mobile test runs, ensure that all the devices are set to the passive mode and the playback-ready apk files are installed.

About the task
As a tester, you might have a large number of regression tests to run on the latest build of the product. Instead of manually running the tests on every new build, you can install the latest build on the UrbanCode Deploy Agent computer and let UrbanCode Deploy launch the tests for you.

After deploying the Rational Test WorkbenchWeb UI Tester plugin on the server, create the component and its processes, applications and its processes, the environments, and the resources. For information about how to create these different pieces, see UrbanCode Deploy documentation.

Procedure to create a workflow

  1. To create a workflow for the newly created component process, click the component process. The Tools view displays the available plugin steps.
  2. From Rational Test Workbench > Eclipse Client, drag the Run RTWec Test step to the design space.
  3. Specify the properties for the step. For information about the properties, see the Steps page.
  4. After you configure the step properties, save the step by clicking Save.

A typical process for the Rational Test Workbench Web UI Testerplugin will look like the following snapshot:

rtw-ucd

A process with multiple tests will look like the following snapshot:

rtw-ucd-multitests

If you have installed multiple products on one target machine, either in the same or different package groups, you can use a single process that includes steps from different products. You must install the plugins of all of the products that you want to use. The process will look like the following snapshot:

rtw-ucd-multiprodtest