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 代表 Java™ 指令行選項,例如,以 -classpath <classpath> 來適當地設定類別路徑。

-classpath
如果使用第一個指令行格式,您必須在類別路徑中明確併入 rational_ft.jar。您可以在 Functional Tester 安裝目錄中找到它。如果使用第二個指令行格式,請在 -jar 之後指定 rational_ft.jar 檔的完整路徑,但不需要指定類別路徑,也不需要指定要執行的類別 (com.rational.test.ft.rational_ft)。如果您搭配 PurifyPlus™ 來使用 Functional Tester,您應該使用第一個指令行格式。

如需指令行選項的完整清單,請參閱 Functional Tester API 參考手冊 (com/rational/test/ft/rational_ft)。

常用選項

常用的選項包括:

-datastore <datastore directory>
在指定 Script 時使用,例如 -record-playback
-record <script name>
用來記錄新 Script(或與 -insertafter <line number> 一起使用,在現有的 Script 中插入記錄)。Script 名稱 不是檔名。而是完整的類別名稱,以句點 (.) 字元來隔開套件/名稱空稱和 Script 類別名稱。您可以利用 -record <script name> 來記錄 Java 或 VB.NET Script,視專案類型而定。
-playback <script name>
用來重播特定的 Java Script。
-edit <file> or -display <file>
用來編輯或檢視 Functional Tester 驗證點或物件對映。<file> 可以是完整的檔名(含目錄路徑)。如果名稱或路徑中有空格字元,請用雙引號括住。
-enable
用來顯示啟用程式 GUI 或啟用特定的環境。
-appconfig
用來顯示應用程式配置工具
-inspector
用來顯示測試物件視察程式工具

指令行使用範例

在這些範例中, -classpath 必須指向 rational_ft.jar 檔案。

註: <script-name> 值採用標準的 Java 套件或 .NET 名稱空間命名慣例,例如 package.MyScriptNamespace.MyScript

記錄新的 Script:

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

在現有的 Script 中記錄,並插入在指定的程式行前面或後面

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

編譯 Script:

註: 在此之前必須先啟用 Java 環境。您也必須安裝 Java SDK,並在路徑中加入 bin 目錄。
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [options] -compile <script-name>

重播 Script,將指令行引數 <values> 傳遞給 Script:

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

記錄、編譯及重播 Script:

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

建構空的 Script:

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

重新產生 Script 的 Helper 檔:

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

重新產生資料儲存庫的所有 Helper 檔:

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>

執行「測試物件視察程式」:

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

以自動式批次模式執行 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® 上執行 Script

	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 在重播 Script 之後顯示日誌,您也必須在 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 Scriptft_cmdline

範例:

在 Linux® 上啟用所有環境

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

在 Linux 上,利用指令行引數來執行 Script

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

意見
(C) Copyright IBM Corporation 2000, 2007. All Rights Reserved.