実行変数

テスト実行中にテスト・スクリプト内で特定の値を使用するには、テスト・スクリプトまたはキーワードで実行変数を定義します。また、実行変数をテスト・スイートまたはテスト・ケースから、関連付けられたテスト・スクリプトまたはキーワードに受け渡すこともできます。管理者またはテスト・リーダーの場合、プロジェクト・レベルで実行変数を設定することができます。

実行変数をすべてのマニュアル・スクリプト、コマンド行スクリプト、および JUnit Selenium スクリプトで使用できます。実行変数をサポートするアダプターを使用する場合は、実行変数を自動化テスト・スクリプトで使用することができます。 アダプターが実行変数をサポートしているかどうかを判断するには、アダプター固有の資料を参照してください。

成果物レベル、およびプロジェクト・レベル実行変数

実行変数はプロジェクト・レベルまたは成果物レベルで定義できます。プロジェクト実行変数を保存する権限を持っているプロジェクト管理者は、プロジェクト実行変数を定義できます。プロジェクト実行変数には、テスト成果物で使用するために定義された値のセットがあります。 テスト作成者は、成果物実行変数をテスト・スイート、テスト・ケースおよびテスト・スクリプトのコンテキストで定義できます。それらのテスト成果物実行変数は、任意の値を取ることができます。
  • テスト・スイートまたはテスト・ケース全体に存在する値を使用するには、そのテスト・ケースまたはテスト・スイートの「実行変数」セクションで成果物実行変数を定義します。
  • 実行変数をマニュアル・テスト・スクリプトまたはキーワードで使用するには、「マニュアル・テスト」エディターの「実行変数」セクションで変数を定義します。変数を定義した後、その変数への参照をマニュアル・テスト・スクリプトまたはキーワードのステップに挿入できます。テスト実行中に、実行変数の現行値によってそのステップでの参照が置き換えられます。
  • 特定の実行変数の値を設定するために、マニュアル・テストまたはキーワードに実行変数ステップを挿入できます。「実行変数」ウィンドウから実行変数ステップを作成および挿入できます。テスト実行中に、実行変数に値を割り当てるようプロンプトが出されます。値を設定した後、その実行変数へのすべての参照にその指定値が入ります。
成果物レベルでは、同じ変数の値が複数の場所に定義された場合は、上位の変数値が下位の変数値をオーバーライドします。例えば、テスト・スイートと、テスト・スイート内のテスト・ケースで変数が定義されたとします。テスト・スイートで定義された変数の値が、テスト・ケースで定義された変数の初期値をオーバーライドします。別の例として、テスト・ケースと、テスト・ケース内のテスト・スクリプトで変数が定義されたとします。テスト・ケースで定義された変数の値が、テスト・スクリプトで定義された変数の初期値をオーバーライドします。
  • テスト・スイート実行変数の値は、テスト・ケース、テスト・スクリプト、およびキーワードの実行変数の値をオーバーライドします。
  • テスト・ケース実行変数の値は、テスト・スクリプトおよびキーワードの実行変数の値をオーバーライドします。
  • テスト・スクリプト実行変数の値は、キーワードの実行変数の値をオーバーライドします。

成果物は、プロジェクト実行変数および成果物実行変数の両方を取り込むことができます。しかし、それらの変数の 2 つ以上が同じ名前である場合、競合が起きて成果物の保存ができなくなります。プロジェクト・レベル実行変数の名前を成果物レベル実行変数の名前と一致するよう変更することができます。その場合には、テスト実行時に成果物レベル変数の値がプロジェクト・レベル変数の値をオーバーライドします。

順次テスト・スイート実行における実行変数

順次テスト・スイート実行中に、あるテスト・スクリプトから別のスクリプトに実行変数を受け渡すことができます。例えば、テスト・スイートの最初のステップで、あるユーザーを作成して「userID」という実行変数を設定するテスト・スクリプトを実行します。テスト・スイートの後続のステップ では、「userID」という実行変数の値を参照し、ユーザー情報を更新し、そのユーザー情報が正しいことを検証するテスト・スクリプトを実行します。 この振る舞いは、テスト・スイートの「テスト・ケース」セクションまたは「テスト・スイートの実行」ウィンドウで使用可能にできます。

コマンド行スクリプトにおける実行変数

実行変数が含まれたコマンド行テストを実行すると、 実行変数の値は、コマンド行テストを実行するプロセスに環境変数として提供されます。それらの環境変数の名前は、他の環境変数と区別するため、"RQM_" で始まります。

例えば、テスト・スイートに myVar という実行変数が含まれている 場合、RQM_myVar という環境変数が作成されます。
要確認: 実行変数の名前には、有効な Java 識別子 (A から Z、a から z、0 から 9、_ および $) のみを使用することが理想的です。Java にない識別子が実行変数に含まれていると、その識別子がアンダースコアー (_) で置き換えられて、新しい環境変数名が作成されます。例えば、user.Name という名前の実行変数がある場合、結果として得られる環境変数は RQM_user_Name となります。
さらに、RQM_ExecutionVariablesFile という環境変数も作成され、 その値はテキスト・ファイルへの絶対パス名です (例えば、RQM_ExecutionVariablesFile=C:¥Users¥tneal.DEV¥AppData¥Local¥Temp¥QMAdapter1220694107401772431.vars)。 そのファイルには名前と値のペアが含まれています。コマンド行スクリプトの実行時に定義された実行変数ごとに 1 つのペアがあります。 以下に例を示します。

#Execution Variables
#Wed Mar 02 15:48:54 EST 2011
testcase2Var=set statically in testcase2
testcase1Var=set statically in testcase1
testsuite1Var=set statically in testsuite1

コマンド行テストが完了すると、テキスト・ファイルが読み取られます。テスト・スイートで実行変数の受け渡しが許可されている場合、その内容を使用して、実行変数の値が次のテスト・スクリプトに受け渡されます。 実行変数を作成するか、他のテスト・スクリプトに受け渡す実行変数の値を変更するために、このテキスト・ファイルを変更することができます。

ビルトイン実行変数

場合によっては、テストを実行しているテスト実行環境についての情報をそのテストでさらに取得する必要がある可能性があります。例えば、実行中のテスト・スイートまたはテスト・ケースの名前などがテストで必要な場合があります。ビルトイン実行変数は、環境情報を提供します。 ビルトイン変数を使用可能にするには、「テスト・スクリプト」エディターの「実行変数」セクションにある「ビルトイン変数の組み込み」チェック・ボックスを選択します。

そのチェック・ボックスを選択すると、次のような追加の実行変数が作成されます。
RQM_TESTSCRIPT_NAME
RQM_TESTSCRIPT_WEBID
RQM_TESTCASE_NAME
RQM_TESTCASE_WEBID
RQM_TESTCASE_RESULT_WEBID
RQM_TESTCASE_RESULT_NAME
RQM_TESTSUITE_NAME
RQM_TESTSUITE_WEBID
RQM_TESTSUITE_RESULT_WEBID
RQM_TESTSUITE_RESULT_NAME
RQM_TESTPLAN_NAME
RQM_TESTPLAN_WEBID
RQM_TESTPHASE_NAME
RQM_TESTPHASE_WEBID
RQM_TESTCASE_EXECUTIONRECORD_NAME
RQM_TESTCASE_EXECUTIONRECORD_WEBID
RQM_SUITEEXECUTIONRECORD_NAME
RQM_SUITEEXECUTIONRECORD_WEBID
RQM_PROJECT_NAME
RQM_PROJECT_ALIAS
RQM_BUILDRECORD_NAME
RQM_BUILDRECORD_WEBID
RQM_BUILDDEFINITION_NAME
RQM_BUILDDEFINITION_WEBID
RQM_CONFIGURATION_NAME
RQM_CONFIGURATION_CPU
RQM_CONFIGURATION_BROWSER
RQM_CONFIGURATION_ADAPTER
RQM_CONFIGURATION_DATABASE
RQM_CONFIGURATION_APPLICATIONSERVER
RQM_CONFIGURATION_MANAGEMENTAGENT
RQM_CONFIGURATION_OS
RQM_CREATEDBY_USERID
RQM_CREATEDBY_NAME
RQM_LABRESOURCE_NAME
RQM_LABRESOURCE_WEBID


問題や質問は、Jazz.net forum までお問い合わせください。