Plug-in Documentation

IBM Rational Functional Tester (RFT)


IBM Rational Functional Tester offers automated capabilities for functional, regression, GUI, and data-driven testing. The IBM UrbanCode Deploy plug-in for Rational Functional Tester includes process steps for running functional test scripts remotely on UrbanCode Deploy agent computers. Rational Functional Tester integration with UrbanCode Deploy is only supported for Java Scripting and Simplified Scripting on Windows computers in the Eclipse IDE. Test scripts recorded in the Visual Studio IDE are not supported.

To use this plug-in, you must have an installation of Rational Functional Tester on an UrbanCode Deploy Agent computer.


This plug-in requires IBM UrbanCode Deploy version 6.1 or later and IBM Rational Functional Tester version or later.

The steps in this plug-in run on any agents that are supported by both the IBM UrbanCode Deploy and the Rational Functional Tester.


No special steps are required for installation. See Installing plug-ins in UrbanCode Deploy.


Process steps in the IBM Rational Test Workbench Functional Tester plug-in

Run Functional Test

Run test using Rational Functional Tester

Input properties for the Run Functional Test step
Name Type Description Required
Iteration Count String Number of datapool iterations to be run. No
Log Format Enumeration:

  • xml
  • html
  • text
  • TPTP
Format of script execution logs. No
Project Directory String Fully qualified path to the Rational Functional Tester project directory. Yes
Script Name String Name of the script to be executed. Yes
User Arguments String Additional user arguments for playback. No


Example: Running functional tests

Use the Rational Functional Tester plug-in to continuously initiate the launch of functional tests from IBM UrbanCode Deploy.

Before you begin

  • Install the UrbanCode Deploy agent and connect it to the UrbanCode Deploy server. For details, see the UrbanCode Deploy documentation.
  • Install Rational Functional Tester on the UrbanCode Deploy agent computer and apply a valid license. For details, see the Rational Functional Tester documentation.
  • Install the UrbanCode Deploy server and deploy the Rational Functional Tester plugin on the server. For information about installing UrbanCode Deploy, see its documentation.
  • Enable the functional testing environment (for example, Java) on the UrbanCode Deploy agent. If you intend to test a web-based application, enable any browser supported by Rational Functional Tester, that is, Microsoft Internet Explorer, Mozilla Firefox, or Google Chrome. See Software Product Compatibility Reports for information about the browser versions supported by Rational Functional Tester. For information about enabling the functional testing environment, see Preparing the functional test environment.
  • Configure the application to be tested (AUT) on the UrbanCode Deploy agent. For details, see Configuring applications for testing.
  • If you have stored the RFT scripts within a folder, the value of the Script Name input property should be folder name.script name. For example, RFTtests.app1test.

About the task

As a tester, you might have a large number of regression tests to be run against the latest builds of a product. Instead of manually running the tests against every new build, you can install the latest build on an IBM UrbanCode Deploy Agent computer and let it automatically start the tests for you.

After deploying the Functional Tester plug-in on the UrbanCode Deploy server, create component and its processes, applications and its processes, environments, and resources. For information about how to create and configure these pieces, see the IBM UrbanCode Deploy documentation.

Example: Running functional tests

After deployment, the UrbanCode Deploy plug-in for Rational Functional Tester is available at Rational Test Workbench > Functional Tester > Run Functional Test on the UrbanCode Deploy server. The plug-in for Rational Functional Tester includes only a single step: Run Functional Tests. The component process runs a functional script that is part of a Rational Functional Tester project previously stored on an UrbanCode Deploy agent.

To create a workflow, do the following tasks:

  1. Click the component process. The Tools view displays the available plugin steps.
  2. From Functional Tester, drag the Run Functional Tests step into the design space.
  3. Specify the properties for the step. For information about the properties, see the Steps page.
  4. After configuring the properties, save the step.

A basic process for a functional test plug-in is shown in the following snapshot:

Run functional tests basic flow


  • You must compile the functional test scripts in the Eclipse IDE before running them on UrbanCode Deploy.
  • The UrbanCode Deploy output variable called TestResult contains the overall playback result of the test scripts. This variable helps you view the test results on UrbanCode Deploy itself rather than on the test computer where the scripts are run.
  • If the execution of a Rational Functional Tester script is dependent on an external .jar file, make sure you place the .jar file in the customization folder. Adding references to the file under project properties (which is what you normally do when playing scripts from the Rational Functional Tester IDE) will not suffice.

Video: Running functional tests

The following video shows how to use the Rational Functional Tester plug-in for UrbanCode Deploy to remotely run functional tests.