Script Command Reference

前のセクションで見たように、この言語は一連のコマンドをサポートしている。4つの基本グループがあります：

1. デスクトップコマンドは、リモートデスクトップ上で実行されるユーザーアクションを表します：

   • ConnectそしてLanguage Reference#disconnectデスクトップに接続したり、デスクトップから切断したりします。スクリプトは、一度に 1 つのデスクトップに接続できます。ただし、1 つのスクリプト内で接続と切断を行うデスクトップの数に制限はないため、1 つのシステムで少し自動化を行った後、別のシステムに切り替えることもできます。

   • Language Reference#clickコマンドは、成功すればマウスクリックが続く検索アクションを組み合わせます。

   • Language Reference#mouseコマンドは、具体的には、マウスの移動、プレス、リリース、クリック、またはドラッグを実行します。

   • Language Reference#press,Language Reference#typeとLanguage Reference#typelineコマンドはキーボード入力を扱う。コマンドはキーボード入力を扱う。Language Referenceは、ほぼすべてのキー、または1つ以上の修飾子（Shift、Ctrl、Alt、Windows）を持つキーの組み合わせを押すことができます。そしてLanguage Reference#typeとLanguage Reference#typelineはPressコマンドを拡張し、連続したテキストを入力できるようにします。Language Reference#typeline).

2. Administration %26 Execution Controlコマンドは、スクリプトの実行制御に必要なインフラストラクチャを提供し、変数、ライブラリ、外部OSコマンドコールをサポートします。

   • Language Reference#varおよびLanguage Reference#eコマンドで変数を定義できます。一方Language Reference#varは単に文字列値を変数に代入します、Language Reference#eは数値式を含む値を期待し、それを評価し、その結果を変数に代入します。変数はスクリプトのパラメトリゼーションで重要な役割を果たすので、別のトピックで説明します。

   • Language Reference#runそしてLanguage Reference#includeは他のスクリプトとリンクします。一方Language Reference#runは、引数で指定されたスクリプト（Javaのものも含む）を実行します、Language Reference#includeは、リンクされたスクリプト内のすべてのグローバル変数とプロシージャを、呼び出したスクリプトで使用できるようにするだけです。これにより、共通の定数（変数）やタスク（プロシージャ）のライブラリを作成し、それらをライブラリとして複数のスクリプトにリンクすることができます。バージョン2.2以降のインクルードでは、JARファイルのロードも可能になり、コンパイルされたJavaスクリプトをRunで実行できるようになりました。

   • Language Reference#pause,Language Reference#ex,Language Reference#waitとLanguage Reference#breakは、スクリプトの実行を制御する無条件の方法を提供します。Language Reference#pauseから人間が手動で再開するまで、スクリプトを無期限に一時停止します。 GUI Reference OverviewまたはCLI Options.コマンド (後述) と併用することが多い。Language Reference#sendmailコマンド (後述) と併用すると、暴走しているスクリプトを一時停止し、 管理者に支援が必要であることを通知することができる。Language Reference#exスクリプト、プロシージャ、またはコードのブロックを終了し、引数で指定された数値を返します (通常、ゼロは成功を意味し、その他の値は失敗を意味します)。Language Reference#wait指定した一定時間、スクリプトの実行を一時停止します。最後にLanguage Reference#breakは、最内部のforループを終了させるためにのみ使用される。

   • Language Reference#waitforとLanguage Reference#compareto特定のイベントを待ち、その結果に応じて動作する。Language Reference#waitforはスクリプトの実行を一時停止し、デスクトップイベント（画面の更新など）を待つ。また、画像比較を使用してデスクトップ画像を監視し、特定の画像が表示されるまで、または画像が画面に表示されている限り、スクリプトを一時停止することもできる。Language Reference#comparetoは、1 回だけの即時画像比較にのみ使用される。

   • Language Reference#execは、ローカルオペレーティングシステム（T-Plan Robot が動作しているシステムを意味し、クライアントとサーバーの両方が同じシステム上で動作している場合を除き、リモートデスクトップではありません）のコマンドを実行します。コマンドの結果やコンソール出力はスクリプトの変数として利用可能であるため、少量のデータのロードやOSレベルでの出力(ファイルへのテキストの追加など)に使用することもできます。

   • Language Reference#stringは、部分文字列の検索、別の文字列や正規表現とのマッチング、文字列のカット、構文解析などのテキスト操作を実行する。

3. レポーティングコマンドは、様々なオートメーション出力を生成します。

   • Language Reference#screenshotデスクトップ（またはその一部）のスクリーンショットを撮り、ファイルに保存する。このコマンドはLanguage Reference#comparetoコマンドと統合されているため、スクリーンショットを撮って一度に画像比較を行うこともできる。

   • Language Reference#warningレポート作成者によって消費される警告ログを作成する。

   • Language Reference#scriptそしてLanguage Reference#stepは、スクリプトをケース（T-Planの用語では「スクリプト」と呼ばれる）と個々のステップに構造化することができる。この構造は、結果のXMLとレポートに反映される。T-Plan Test Management ("T-Plan Professional") データベースで既存のスクリプトを参照すると、結果を T-Plan Professional にエクスポートすることもできます。

   • Language Reference#reportスクリプト結果のHTML またはXMLレポートを作成します。レポートには、スクリーンショット、警告、ステップ/スクリプト要素など、上記のコマンドによって生成されたすべての出力が表示されます。

   • Language Reference#sendmailSMTP サーバーを介してスクリプトからインライン電子メールを送信します。本文はプレーン・テキストまたは HTML で、メッセージには添付ファイルを含めることができます。

4. 入出力（I/O） コマンドにより、さまざまなリソースからデータをロードしたり、さまざまなリソースにデータを保存したりできます。

   • Language Reference#fileプレーン・テキスト・ファイルおよびカンマ区切り値（CSV）形式のファイルからの読み取りと書き込み。

   • Language Reference#excelMS Excelスプレッド・シート（.xls）からの読み込みと書き込み。