Run scripts through the Rational Functional Tester command line

Run, create, or record Java or .NET script

IBM® Rational® Functional Tester is an automated testing tool that runs functional, regression, GUI, and data-driven tests. This article provides ready-to-use batch files that software testers can use to run Java or .NET scripts through the Rational Functional Tester command line. It concludes with tips for using the command line to create and record scripts.

Rekha S. Deshmukh (rekha.deshmukh@in.ibm.com), System Software Engineer, IBM

author photoRekha Deshmukh is a System Software Engineer at IBM India Software Labs, in Pune, where she is currently working with IBM Cognos as a Flex Developer. She has used Rational Functional Tester to develop an automation framework to test web-based applications of IBM Cognos software. Rekha holds a bachelor's degree in Computer Engineering from the University of Pune. This is her third IBM developerWorks article about Rational Functional Tester.



15 February 2011

Also available in Chinese

Running scripts from the command line

In this first section, software testers will learn how to use IBM® Rational® Functional Tester to run Java or .NET scripts from the command line. This gives you the ability to integrate Rational Functional Tester with external test drivers, such as STAF (Software Testing Automation Framework) and STAX. You can create a script by using the recorder or just create an empty script.

To play back a Java script, use the script in Listing 1.

Important:
The order of the arguments is significant.

Listing 1. To play back a Java script
java -Drational_ft.install.dir=<Rational FT
install directory> <-classpath...>
com.rational.test.ft.rational_ft -datastore
<directory> -log <logname> [options] -playback
<script-name>

To play back a Microsoft VB.NET script, use the script in Listing 2.

Listing 2. To play back a VB.NET script
rational_ft.exe -datastore <directory> -log
<logname> [options] -playback <script-name>
Listing 3. Batch file to run the Rational Functional Tester Java script
: Disclaimer that this batch file is created for Rational Functional Tester 
:version 8.0  on the Operating System Windows XP
: Usage of the batch file 
:e.g. RFT_PlayScript ProjectPath ScriptName LogName [silent]

@ECHO OFF
:start
:save_args_as_variables
set RFT_PROJECT_LOCATION=%1
set RFT_SCRIPT_NAME=%2
set RFT_LOGFILE_NAME=%3
goto check_args
:check_args
if "%RFT_PROJECT_LOCATION%" == "" goto missing_args
if "%RFT_SCRIPT_NAME%" == "" goto missing_args
if "%RFT_LOGFILE_NAME%" == "" goto missing_args
goto args_ok
:args_ok
if "%4" == "silent" goto playback
echo.
echo RFT_PROJECT_LOCATION = %RFT_PROJECT_LOCATION%
echo RFT_SCRIPT_NAME = %RFT_SCRIPT_NAME%
echo RFT_LOGFILE_NAME = %RFT_LOGFILE_NAME%
echo IBM_RATIONAL_RFT_ECLIPSE_DIR = %IBM_RATIONAL_RFT_ECLIPSE_DIR%
echo IBM_RATIONAL_RFT_INSTALL_DIR = %IBM_RATIONAL_RFT_INSTALL_DIR%
echo.
echo Initializing RFT Playback...
:playback
"%IBM_RATIONAL_RFT_ECLIPSE_DIR%\jdk\jre\bin\java" 
-classpath "%IBM_RATIONAL_RFT_INSTALL_DIR%\rational_ft.jar" 

com.rational.test.ft.rational_ft -datastore %RFT_PROJECT_LOCATION%
 -playback %RFT_SCRIPT_NAME% -log %RFT_LOGFILE_NAME%
if "%4" == "silent" goto end
echo RFT playback complete.
goto end
:missing_args
echo.
echo ERROR: Invalid syntax! Usage: 
echo RFT_PlayScript ProjectPath ScriptName LogName [silent]
goto end
:end

Parameters passed here are the location of the project, the name of the script to run, and the name of the log file.

For example, suppose that you have a project named SampleProject at C:\SampleWorkSpace, and a script called SampleScript. In this situation:

Your RFT_PROJECT_LOCATION is C:\SampleWorkSpace\SampleProject
RFT_SCRIPT_NAME is SampleScript
RFT_LOGFILE_NAME is SampleScript

To run this batch file from command prompt, go to the location where this batch is present. For the example in Figure 1, assuming that this batch file PlayBack.bat file is at the command prompt: c:\

Listing 4. How to run the batch file through command prompt
C:\>PlayBack.bat C:\SampleWorkSpace\SampleProject SampleScript SampleScript
Figure 1. Command prompt
Executing the batch file

Larger view of Figure 1.

Listing 5. Batch file to run the RFT VB.NET script
: Disclaimer that this batch file is created for Rational Functional Tester 
:version 8.0 on the operating system Windows XP

: Usage of the batch file
: e.g. RFT_PlayScript ProjectPath ScriptName LogName [silent]

:start

:save_args_as_variables
set RFT_PROJECT_LOCATION=%1
set RFT_SCRIPT_NAME=%2
set RFT_LOGFILE_NAME=%3
goto check_args

:check_args
if "%RFT_PROJECT_LOCATION%" == "" goto missing_args
if "%RFT_SCRIPT_NAME%" == "" goto missing_args
if "%RFT_LOGFILE_NAME%" == "" goto missing_args
goto args_ok

:args_ok
if "%4" == "silent" goto playback
echo.
echo RFT_PROJECT_LOCATION = %RFT_PROJECT_LOCATION%
echo RFT_SCRIPT_NAME = %RFT_SCRIPT_NAME%
echo RFT_LOGFILE_NAME = %RFT_LOGFILE_NAME%
echo IBM_RATIONAL_RFT_INSTALL_DIR = %IBM_RATIONAL_RFT_INSTALL_DIR%
echo.
echo Initializing RFT Playback...

:playback
"%IBM_RATIONAL_RFT_INSTALL_DIR%\rational_ft.exe" -datastore 
%RFT_PROJECT_LOCATION% -playback %RFT_SCRIPT_NAME% 
-language vb -log %RFT_LOGFILE_NAME%

if "%4" == "silent" goto end
echo RFT playback complete.
goto end

:missing_args
echo.
echo ERROR: Invalid syntax! Usage: 
echo RFT_PlayScript ProjectPath ScriptName LogName [silent]
echo.
pause
goto end

:end

Passing parameters to scripts through the command line

Listing 6. To play back a Java script with parameters
java -Drational_ft.install.dir=<Rational FT
install directory> <-classpath...>
com.rational.test.ft.rational_ft -datastore
<directory> -log <logname> [options] -playback
<script-name> [-args <values>]
Listing 7. Batch file to run the RFT JavaScript with parameters
: Disclaimer that this batch file is created for Rational Functional Tester 
:version 8.0  on the Operating System Windows XP

: Usage of the batch file 
:e.g. RFT_PlayScript ProjectPath ScriptName LogName [silent]

@ECHO OFF
:start
:save_args_as_variables
set RFT_PROJECT_LOCATION=%1
set RFT_SCRIPT_NAME=%2
set RFT_LOGFILE_NAME=%3
set RFT_Argument =%4

goto check_args
:check_args
if "%RFT_PROJECT_LOCATION%" == "" goto missing_args
if "%RFT_SCRIPT_NAME%" == "" goto missing_args
if "%RFT_LOGFILE_NAME%" == "" goto missing_args
goto args_ok
:args_ok
if "%4" == "silent" goto playback
echo.
echo RFT_PROJECT_LOCATION = %RFT_PROJECT_LOCATION%
echo RFT_SCRIPT_NAME = %RFT_SCRIPT_NAME%
echo RFT_LOGFILE_NAME = %RFT_LOGFILE_NAME%
echo IBM_RATIONAL_RFT_ECLIPSE_DIR = %IBM_RATIONAL_RFT_ECLIPSE_DIR%
echo IBM_RATIONAL_RFT_INSTALL_DIR = %IBM_RATIONAL_RFT_INSTALL_DIR%
echo.
echo Initializing RFT Playback...
:playback
"%IBM_RATIONAL_RFT_ECLIPSE_DIR%\jdk\jre\bin\java" 
-classpath "%IBM_RATIONAL_RFT_INSTALL_DIR%\rational_ft.jar"
 com.rational.test.ft.rational_ft -datastore 
%RFT_PROJECT_LOCATION%
 -playback %RFT_SCRIPT_NAME% -log %RFT_LOGFILE_NAME% 
 [-agrs %RFT_Argument%]
if "%5" == "silent" goto end
echo RFT playback complete.
goto end
:missing_args
echo.
echo ERROR: Invalid syntax! Usage: 
echo RFT_PlayScript ProjectPath ScriptName LogName [silent]
goto end
:end
Listing 8. To play back a Microsoft .NET script with parameters
rational_ft.exe -datastore <directory> -log
<logname> [options] -playback <script-name> [-args<values>]

Tips for running Rational Functional Tester Java scripts through command line

This section offers a few tips for creating and recording Rational Functional Tester scripts through the command line. You can integrate these with the batch files described previously to perform different actions using Rational Functional Tester on command line.

Listing 9. Record a new script
rational_ft.exe -datastore <directory> -log
<logname> [options] -record <script-name>
Listing 10. Record into an existing script, inserting before or after a given line
rational_ft.exe -datastore <directory> -[ -insertbefore <line>] 
[ -insertafter <line>] [options] -map <sharedmap>] 
[options] -record <script-name>

Note:
You must enable the Java environment before compiling a script with this command. You must also install the Java SDK and add the bin directory to the path.

Listing 11. Compile a script
rational_ft.exe -datastore <directory> [options] [options] -compile <script-name>
Listing 12. Record, compile, and play back a script
rational_ft.exe -datastore <directory> [options] -record <script-name> 
-compile -playback [ -args <values>]

Resources

Learn

Get products and technologies

  • Try Rational Functional Tester free requires registration).
  • Evaluate IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.

Discuss

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Rational software on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=626217
ArticleTitle=Run scripts through the Rational Functional Tester command line
publish-date=02152011