Creating Structure: Steps and Scripts

ソフトウェアエンジニアリング業界におけるテストは、通常テストケースで構成されます。テストケースは、アプリケーションのフィーチャ、機能、または正しい振る舞いをテストすることを目的とした、単一の論理的なステップ、または一連のステップです。通常、期待される結果が定義されます。テストケースはしばしばテストスクリプトと呼ばれ、通常テストスイートに集められます。

T-Plan Robot Enterprise はテストケース（T-Plan の用語では「スクリプト」）とステップをサポートします。テストスイートは、T-Plan Professional のようなテスト管理ツールなど、T-Plan Robot 以外の高いレベルで管理されることが想定されます。スクリプト言語には 2 つのコマンドがあります、スクリプトとステップ:

Script はスクリプトの開始または終了をラベル付けし、名前または ID と関連付ける。これは、特定のテストケースを実行するコードのブロックを定義するために、[ "Script %26lt;id>start", "Script %26lt;id%26gt;end"] のペアで使用することを意図しています。このようなブロックの内部で生成された出力オブジェクト（スクリーンショット、ステップ、警告）はすべてスクリプト ID に関連付けられ、この関係はテスト結果の XML データに反映されます。スクリプトに含まれるすべてのステップに合格した場合、スクリプトの結果は合格です。スクリプトブロックの有効性は、ファイルの終了または別のスクリプトの開始宣言によって自動的に終了するため、スクリプトの終了宣言は任意であり、省略することもできます。start "キーワードは省略可能であり、コマンドは "Script %26lt;id%26gt;"のように単純に定義できる。
Stepはテストステップの結果を定義する。スクリプト（テストケース）の 1 つのアトミック命令を表します。ステップは、Script コマンドでラベル付けされたブロック内に配置する必要があります。ステップは、一般に、命令を自動化する一連のコマンドの後に、部分的な結果を返すように定義します。ステップは必須の名前で識別され、ステップの結果、指示、期待結果と実際の結果の説明、メモなど、さまざまなオプションのパラメータをサポートします。

スクリプトとステップの構造は、Report コマンドで作成される HTML レポートと XML レポートの両方に反映されます。XMLは、ウェブブラウザで表示可能なテストレポートとしてだけでなく、サードパーティ製アプリケーションへのエクスポートに適したテスト結果データのソースとしても機能します。レポート機能の詳細については、このチュートリアルで後述します。

例として、前のトピックの電卓の例にスクリプトとステップ構造を追加してみましょう。5+5"(スクリプト1)と "10*5"(スクリプト2)の計算を検証するという2つのテストケースを自動化するとします。簡単にするために、ステップでは常に「pass」を返します。アプリケーションの動作の検証については、このチュートリアルの次の章で詳しく説明します。

スクリプトの仕様

calculator.tpr (Windowsバージョン)

calculator-lib.tpr

スクリプト 1：

電卓の起動
5+5 "を計算する
電卓を閉じる

期待される結果

アプリは期待通りに起動/停止する。
10の結果を生成します。

スクリプト2：

電卓の起動
"10*5 "を計算する
電卓を閉じる

期待される結果

アプリは期待通りに起動/停止する。
50の結果を生成します。

JS

# Define the OS variable because the library expects it. 
Var OS="Windows" 

# Include the library. 
Include calculator-lib. tpr

# Define XML report. 
Report calculator-{OS}.xml desc="Calculator testing on {OS}."

# Calculate "5+5" and"10*5". 
Script 1 name="Calculate 5+5"
calculate "5+5" 

Script 2 name="Calculate 10*5"
calculate "10*5"

JS

# Variable initialization based on target OS. 
# If the "OS" variable is not initialized, default to Windows. 
Var RUN_BOX_KEY="Windows+r"
Var CALCULATOR_CMD="calc" 

# Both systems close applications through Alt+F4 
Var CLOSE_KEY="Alt+F4" 

if ("{OS}" == "Linux") { 
  Var RUN_BOX_KEY="Alt+F2"
  Var CALCULATOR_CMD="gnome-calculator"
} 

# Start an application through the Run box. 
# Params: {1} ... application start command 
procedure startApp { 
  Press "{RUN_BOX_KEY}" wait=5s
  Typeline "{1}" wait=4s
} 

# Start the calculator, type the expression, save 
# a screenshot to a uniquely named file and close it. 
# Params: {1} ... numeric expression to type, for ex. "5+5" 
procedure calculate {
  startApp "{CALCULATOR_CMD}" 
  Step "Start" instruct="Start calculator" result="pass"
  Typeline "{1}" wait=2s
  Screenshot calculator_{_CURTIME}.jpg desc="Result of {1}" 
  Step "Calculate" instruct="Calculate {1}" result="pass"
  Press "{CLOSE_KEY}" wait=2s
  Step "End" instruct="Close calculator" result="pass"
}