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 のインストール・ディレクトリーにあります。2 番目のコマンド行形式を使用する場合、-jar オプションの後に、rational_ft.jar ファイルへの絶対パスを指定します。 クラスパスや、実行するクラス (com.rational.test.ft.rational_ft) を指定する必要はありません。 Functional Tester を PurifyPlus™ と一緒に使用している場合は、最初のコマンド行形式を使用します。

コマンド行オプションの完全なリストについては、「Functional Tester API Reference」 (com/rational/test/ft/rational_ft) を参照してください。

-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
このオプションは、「テスト・オブジェクト・インスペクター・ツール」ダイアログ・ボックスを開くために使用します。

コマンド行の使用例

以下の例では、-classpath は rational_ft.jar ファイルを指さなければなりません。

注: <script-name> 値は、標準的な Java パッケージまたは .NET 名前空間の命名規則を使用します (例えば、package.MyScript または Namespace.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 -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>]

他の Functional Test プロジェクトからのクラスを使用するスクリプトの再生:

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

Functional Test プロジェクト用の他のクラスを使用するスクリプトの再生:

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>

テスト・オブジェクト・インスペクターの実行:

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 ログ・フォルダーを必ず作成してください。 これらの 2 つのフォルダーがない場合は、バッチ・モードで 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

フィードバック