Generating ANT scripts to run tests or suites
You can generate ANT scripts from IBM® Rational® Integration Tester by using
the Integration Tester Test Execution plug-in. You can use the generated script to run test
resources automatically from within ANT by using the IntegrationTester
ANT
task.
Before you begin
You must have created a project and that project is open in Rational® Integration Tester.
Procedure
-
Select Generate External Tool Configuration from the
Tools menu.
The Generate External Tool Configuration wizard is displayed.
-
Complete the following steps in the Configuration type and environment
window of the Generate External Tool Configuration wizard:
- Select ANT script for executing tests or suites.
- Select the Rational® Integration Tester environment from the list in which the selected resources are to be run.
- Click Next.
The Select resources window is displayed with the project resources tree.
-
Complete the following steps in the Select resources window of the
Generate External Tool Configuration wizard:
-
Complete the following steps in the Ant script options window of the
Generate External Tool Configuration wizard:
-
Complete the following steps in the Summary window of the
Generate External Tool Configuration wizard:
An example of the ANT script generated by Rational® Integration Tester is as follows:
<?xml version="1.0" encoding="UTF-8"?> <project basedir="C:/Users/user/git/UATest_Sample/calculator" default="run-integrationtester"> <property name="install.dir" value="C:/Program Files/HCL/HCLProducts/API"/> <taskdef classname="com.ghc.ghTester.ant.RunTests" name="IntegrationTester"> <classpath> <fileset dir="${install.dir}/tools/Ant"> <include name="*.jar"/> </fileset> </classpath> </taskdef> <target name="run-integrationtester"> <IntegrationTester environment="UATest" project="${basedir}/calculator.ghp" processStartupTimeout="60"> <Tests> <Test ref="calculator/Add/Test 1 plus 1 equals 2"/> </Tests> <AppProperties> <!-- <property name="example.system.property" value="exampleValue"/> --> </AppProperties> <AdditionalOptions> <!-- <option name="-overrideSlowFail" value="ON" /> --> </AdditionalOptions> </IntegrationTester> </target> </project>
Note: Starting from Rational® Integration Tester V9.1.1, the task definition is calledcom.ghc.ghTester.ant.RunTests
. In all the previous versions, it is known ascom.ghc.ghTester.ant.GHTester
.The script would be run in ANT similar to any other build script. If you use JMS or JDBC items in Rational® Integration Tester, use the -lib argument to make the JNDI provider classes available on the main classpath.
If your project is configured to use permissions, configure single sign-on (see External tools). If
krb5.ini
is not available in the Windows™ directory, you can manually add the following properties:<AppProperties> <property name="java.security.krb5.realm" value="<REALM>"/> <property name="java.security.krb5.kdc" value="<KEY DIST CENTER>"/> ... </AppProperties>
Results
The generated script is saved to an output file.
What to do next
You can use the new ANT test script to run the selected Rational® Integration Tester resource as an ANT task.
- On Windows™ systems, echo %errorlevel%
- On systems other than Windows™, echo $?