Functional Tester 命令行界面

从 Functional Tester 图形用户界面可执行的大多数操作也可从命令行来执行。

这些操作包括:

核心命令行格式

核心命令行格式如下:

java <standard java options> -classpath rational_ft.jar com.rational.test.ft.rational_ft <Functional Tester options>
java <standard java options> -jar rational_ft.jar <Functional Tester options>

standard java options 是指诸如 -classpath <classpath> 之类的 Java™ 命令行选项,用于相应地设置类路径。

-classpath
如果使用第一种命令行格式,那么必须在类路径中显式包含 rational_ft.jar。可以在 Functional Tester 安装目录中找到此文件。如果使用第二种命令行格式,请在 -jar 选项后指定 rational_ft.jar 文件的完整路径。您无需指定类路径或类即可运行 (com.rational.test.ft.rational_ft)。如果是将 Functional Tester 用于 PurifyPlus™,请使用第一种命令行格式。

请参阅“Functional Tester API 引用”(com/rational/test/ft/rational_ft) 以获取命令行选项的完整列表。

-projectpath
如果对项目具有依赖关系,那么必须使用 -projectpath 选项来添加项目路径。如果已向功能测试项目添加了其他项目依赖关系,那么可以使用 -projectpath 选项来指定项目名称。 例如,考虑这样一个场景,您有一个功能测试脚本,它使用其他项目中的类。要在命令行调用期间解析此依赖关系,必须使用 -projectpath 选项来指定从属项目名称。

常用选项

以下是较常用选项的列表:

-datastore <datastore directory>
只要指定了脚本便请使用此选项,例如将其与 -record-playback 配合使用。
-record <script name>
使用此选项可记录新脚本(或者与 -insertafter <line number> 配合使用以将记录插入到现有脚本中)。脚本名称不是文件名。它是标准类名,通过使用点 (.) 字符来分隔包/名称空间和脚本类名。可以使用 -record <script name> 记录 Java 或 VB.NET 脚本,具体取决于项目类型。
-playback <script name>
使用此选项可回放 Java 脚本。 必须在命令结尾指定 playback 选项。Rational Functional Tester 会忽略在 playback 选项后指定的任何参数。
-edit <file>-display <file>
使用此选项可编辑或查看 Functional Tester 验证点或对象图。<file> 可以是完整文件名(包含目录路径)。如果名称或路径包含空格字符,请使用双引号。
-enable
使用此选项可打开“启用环境”对话框以启用特定环境。
-appconfig
使用此选项可打开“应用程序配置工具”对话框。
-inspector
使用此选项可打开“Test Object Inspector 工具”对话框。

命令行用法示例

在这些示例中,-classpath 必须指向 rational_ft.jar 文件。

注: <script-name> 值使用标准 Java 包或 .NET 名称空间命名约定,如 package.MyScriptNamespace.MyScript

记录新脚本:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [ -map <sharedmap>] [options] -record <script-name>

记录简化脚本:

java -classpath <classpath> com.rational.test.ft.rational_ft -simplescript true -datastore <directory> [-map<sharedmapname>] [options] -record <script-name>

记录到现有脚本中,在给定行之前或之后插入

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [ -insertbefore <line>] [ -insertafter <line>] [options] -map <sharedmap>] [options] -record <script-name>

编译脚本:

注: 使用此命令编译脚本之前,必须启用 Java 环境。此外,还必须安装 Java SDK 并向路径中添加 bin 目录。
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [options] -compile <script-name>

回放脚本,向脚本传递命令行参数 <values>:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -log <logname> [options] -playback <script-name> [ -args <values>]

回放使用其他功能测试项目中的类的脚本:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -projectpath <reference-project-path> -playback <script-name>

回放使用功能测试项目的其他类的脚本:

java -projectpath <projectpath> com.rational.test.ft.rational_ft -datastore <directory> -projectpath <reference-project-path> -playback <script-name>

回放具有关联数据池的脚本:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -iterationCount <iteration value> -playback <script-name>

记录、编译和回放脚本:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [options] -record <script-name> -compile -playback [ -args <values>]
注: 要使用动态 VP 回放脚本,请在命令行中 -playback 之前添加 -rt.interative true

构造空脚本:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -map <sharedmapname> [options] -create <script-name>

重新生成脚本的帮助程序文件:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -helper <script-name>

重新生成数据存储器的所有帮助程序文件:

java -classpath <classpath> com.rational.test.ft.rational_ft -regenHelpers <script-name>

显示对象图文件:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -display <object-map filename>

显示验证点文件:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -display <verification point filename>

编辑对象图文件:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -edit <object-map filename>

编辑验证点文件:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -edit <verification point filename>

创建并编辑共享对象图:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -fromMap <object-map filename1> -createMap <object-map filename2>

将较新版本的对象图合并到同一图的当前(已修改)版本中:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -from <object-map filename1> -to <object-map filename2> -original <object-map filename1> -mergeMap

比较实际验证点结果和预期验证点结果:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -baseline <baseline verification point filename> -compare <expected verification point filename> <actual verification point filename>

启用已配置的浏览器、Java 环境或 Eclipse 平台:

java -classpath <classpath> com.rational.test.ft.rational_ft -enableName <browser/Java environment/Eclipse>

禁用所有已配置的浏览器、Java 环境和 Eclipse 平台:

java -classpath <classpath> com.rational.test.ft.rational_ft -disableall

运行应用程序配置工具:

java -classpath <classpath> com.rational.test.ft.rational_ft -appConfig <application name>

运行 Test Object Inspector:

java -classpath <classpath> com.rational.test.ft.rational_ft -inspector

运行对象属性配置工具:

java -classpath <classpath> com.rational.test.ft.rational_ft -objectlibraryou

通过无人照管批处理方式运行 Functional Tester

如果已安装 TestManager 并且要使用 TestManager 日志来通过无人照管批处理方式运行 Functional Tester,那么必须在 rational_ft 命令行上包含下列选项:

-user username
用于登录的 TestManager 用户名。
-password password
可选。用于登录的 TestManager 密码。如果尚未设置任何密码,请勿使用此命令。
-project fullpath and full projectname
TestManager 项目的名称,前面带有其完整路径。此名称区分大小写。
-build build
现有 TestManager 构建的名称。请参阅下方的“注释”。
-logfolder foldername
现有 TestManager 日志文件夹的名称(请参阅下方的“注释”)或者 HTML 日志或文本日志的文件规范的名称。如果使用 HTML 日志或文本日志文件夹名称,那么无需指定构件。
注: 如果要创建 TestManager 日志,请确保首先创建 TestManager 构件和 TestManager 日志文件夹。如果这两个文件夹不存在,那么在通过无人照管批处理方式运行 Functional Tester 时执行将失败。
-log logname
TestManager 日志、HTML 日志或文本日志的名称。如果使用 HTML 日志或文本日志名称,那么无需指定构建。

示例:

在 Windows® 上执行脚本

	java -classpath "C:\IBM\RFT\FunctionalTester\bin\rational_ft.jar" 
	com.rational.test.ft.rational_ft -datastore \\My_project\AUser\RobotJProjects -user admin -project
	\\My_project\AUser\TestManagerProjects\Test.rsp -build "Build 1" -logfolder "Default" -log 	
	"Al_SimpleClassicsA#1" -rt.log_format "TestManager" -rt.bring_up_logviewer true -playback 
	basetests.SimpleClassicsA_01

如果不希望 TestManager 在播放脚本后显示日志,那么还必须在 rational_ft 命令行上包含以下选项:

-rt.bring_up_logviewer false

Linux 中的命令行用法

命令行格式为:/opt/IBM/RFT/jre/bin/java /opt/IBM/RFT/FunctionalTester/bin/rational_ft.jar<Functional Tester options>

如果使用以上命令行格式,那么必须显式设置 Functional Tester 环境变量。或者,也可以使用 Functional Tester 脚本 ft_cmdline

示例:

启用 Linux® 中的所有环境

	/opt/IBM/SDP7.0/ft_cmdline -enable ALL

在 Linux 上执行带命令行参数的脚本

/opt/IBM/SDp7.0/ft_cmdline -datastore 
/opt/IBM/RFT/workspace/Project1 -log testscript -playback Script2 -args arg1 arg2

反馈