Script

3.3.4 Script

説明

Script - スクリプト（テストケース）の開始または終了を定義します。このコマンドは、QA業界で一般的に使用されているスクリプト構造を定義するために汎用的に使用できます。スクリプトマッピングは Enterprise report プロバイダーによって認識され、出力XMLデータ（またはHTMLレポート）をQAドキュメント（テストケース仕様など）にマッピングするために使用できます。

T-Planの用語でスクリプトとは、この場合テストケースに相当します。スクリプトは一般にテストステップで構成され、テストケースの実行方法を記述した一連のテスト命令を表します。ステップは、T-Plan Robot のスクリプトでは Step コマンドを通じて指定できます。

このコマンドは、テストケースを実行するコードのブロックを定義するために、[スクリプト <id> 開始、スクリプト <id> 終了] のペアで使用することを意図しています。このようなブロックの内部で生成された出力オブジェクト（スクリーンショットや警告など）は、スクリプト（テストケース）IDと関連付けられ、この関係はテスト結果データに反映されます。スクリプト ブロックの有効性は、ファイル終了または別の "Script start" コマンドの宣言によって自動的に終了するため、スクリプト終了の宣言は任意であり、省略することもできます。

SYNOPSIS

Script <id> [start|end]  [name=<displayable_name>]

• 赤色は必須パラメータです

オプション

id

-一意のスクリプトID。数値でもテキストでもかまいません。

start|end

-スクリプトブロックが開始するか終了するかを示します。action=[start|end]と指定することもできます。パラメータが省略された場合、コマンドのデフォルトは start です。

name

-スクリプトの表示可能な名前（オプション）。

戻り値

スクリプトコマンドは常に 0（ゼロ）を返します。

使用例

Script 1 start name="Display http://www.t-plan.com"
Press Windows+R wait=3s
Typeline "http://www.t-plan.com" 
Waitfor match template="tplanlogo.png" method=search timeout=20s
if ({_EXIT_CODE} == 0) {
  Step "Open http://www.t-plan.com in web browser" pass
} else {
  Step "Open http://www.t-plan.com in web browser" fail
  Exit 1 
}
Script 1 end

• Windows のデフォルトの Web ブラウザで T-Plan Web サイトを開くスクリプトの例 1。スクリプトは画像検索を使用して、ページが正常に表示されたことを確認します。T-Plan のロゴがデスクトップ上で検出された場合、スクリプトは合格したステップ結果を記録します。そうでない場合は、失敗したステップが記録され、スクリプトは失敗を示すコード 1 で終了します。