Testing with Ant

Starting with v9.1.0.1, you can use the ant plugin for Rational® Functional Tester to run functional tests from the command line.

Before you begin

  • Install IBM® Installation Manager, which is required to install Rational Functional Tester.
  • Install Rational Functional Tester.
  • Verify that you have a functional test residing within an Eclipse workspace on the computer where Rational Functional Tester is installed.
  • Be sure ant is installed and added to the PATH environment variable.

Procedure

  1. Download the ant plugin for Rational Functional Tester from https://public.dhe.ibm.com/ibmdl/export/pub/software/rational/Ant_Plugins/
  2. Extract the following files from the downloaded plugin:
    • AntForFunctionalTester.jar
    • ExecuteFunctionalTesterTest.xml
    • inputParams.properties
    • README.txt
  3. Open inputParams.properties and provide parameter values, as shown in the following example: 
    #inputParams.properties file with sample entries
name=test1
projectDir=C:/WS_RFT11/Project2
scriptName=script1
logFormat=text
iterationCount=3

    The following table explains each option.

    Option Description
    -name Required. Name of the test.
    - projectDir Required. The fully qualified path to the Rational Functional Tester project directory. Use '\\' or '/' as the file separator.
    - scriptName Required. The name of the script to be run.
    - logFormat Optional. The format of the logs that are created when the script is run. The options are: xml, html, text, and TPTP.
    - iterationCount Optional.. The number of datapool iterations to be run.
    - userArgs Optional. Additional playback arguments, if any.
  4. Open a command prompt as an administrator or a root user. This applies even when you have logged into a test machine with administrator privileges.
  5. Navigate to the download directory and verify that it includes the ExecuteFunctionalTesterTest.xml file.
  6. Open the inputParams.properties file and enter values for the parameters as applicable.
  7. Type ant -f ExecuteFunctionalTesterTest.xml to start test execution.

    When ant execution completes, a test result is displayed. Ant execution output is logged into the logfile.txt file, and a test log is created in a temp directory under AntForFunctionalTester from where the ant command is executed.

Feedback