toolpanel

ツールパネル

1. 概要

ツールパネルは、T-Plan Robot ウィンドウの左上隅にあるタブ付きビューです。以下の5つのタブで構成されています：

1. プロジェクト タブには、現在のプロジェクトの詳細が表示されます。このコンポーネントについては、専用のプロジェクトヘルプトピックで説明されています。

2. パスタブ（2.xリリースでは「設定」タブとして知られる）は、現在のスクリプト（タブの下のエディタに表示されているもの）のI/O設定を構成します。スクリプトが開かれていない場合、このタブは表示されません。

3. Variables タブには、現在のスクリプトのコンパイルおよび実行変数のテーブルが表示されます。スクリプトが開かれていない場合、このタブは表示されません。

4. コンパイラ タブには、現在のスクリプトの最終コンパイル時に発生したエラーの一覧が表示されます。スクリプトが開かれていない場合、このタブは表示されません。

5. 実行 ログ タブは、スクリプト実行ログの累積ビューです。このコンポーネントについては、専用の実行ログヘルプトピックで説明されています。スクリプトが開かれておらず、実行ログが存在しない場合（アプリケーション起動後、スクリプトが実行されていない場合）、このタブは表示されません。

2.x リリースと比較して：

• イベントタブ（更新待ち呼び出しの構築をサポート）は削除されました。異なるベンダーのVNCサーバー間では画面更新のテストが信頼できないため、画面内容の確認には「search2」および「search」を使用した画像比較が推奨される方法となりました。

• キータブは、キーボードツールウィザードに置き換えられました。

2. パスタブ

このタブはアクティブなエディタ内のスクリプトと密接に連携します。そのコントロールはスクリプト内のコマンドに対応しており、変更はスクリプトの内容にも反映されます：

• 出力パスは、スクリプト実行の結果として生成されるスクリーンショット、レポート、その他の出力ファイルが保存されるディレクトリです。パスの変更は、現在のスクリプト内の_REPORT_DIR変数を更新します。ドロップダウンメニューでは以下のオプションが選択可能です：n offers the following options:

• テンプレートパスは、相対参照されるテンプレート画像および画像コレクションを検索するディレクトリです。パスの変更は、現在のスクリプト内の_TEMPLATE_DIR変数を更新します。ドロップダウンには以下のオプションが表示されます：

• 結果をレポートに保存 を選択すると、アクティブなエディタに Report コマンドまたは report() Java メソッドのいずれかが挿入されます。コマンド/メソッド呼び出しが実行されると、スクリプト、ステップ、警告、スクリーンショット、ログなどの自動化結果が、指定された出力パス内のHTMLまたはXMLレポートファイルに保存されます。

• レポートファイルはレポートファイル名を定義します。拡張子は「.html」または「.xml」でなければなりません。より効率的でカスタマイズ性が高く、XSL変換を通じて結果を他のサードパーティ製ツールにエクスポートできるXML形式の使用を強く推奨します。XMLファイルはHTMLファイルと同様に、あらゆるウェブブラウザで表示可能です。

• 説明は、レポートヘッダーに表示されるオプションのスクリプト説明です。

_REPORT_DIR および/または _TEMPLATE_DIR 変数、および/または Report コマンド/メソッド呼び出しがエディタで手動更新された場合、スクリプトがコンパイルされるとすぐに設定タブのフィールドが変更されます。オンザフライコンパイルがオフになっている場合、フィールドはスクリプトがコンパイルまたは実行されるまでスクリプトと同期しません。

3. 変数タブ

There are generally three types of variables:

1. 事前定義変数、暗黙的変数とも呼ばれます。その名前は通常アンダースコア '_' で始まります。これらは基盤となる自動化フレームワークによって、各スクリプトのコンパイルまたは実行時に作成されます。

2. スクリプト内でVarおよびEvalコマンド（TPRスクリプト）またはgetContext().setVariable()メソッド呼び出し（Javaスクリプト）を通じて定義されたカスタム変数。

3. 実行されたコマンドまたはメソッド呼び出しによって作成された変数。

変数タブには、2つの独立した変数テーブルが含まれています：

1. コンパイル変数（「コンパイル変数」）タブには、直近のスクリプトコンパイル時に定義された変数のリストが表示されます。

• TPRスクリプトの場合、テーブルには事前定義された変数に加え、VarおよびEvalコマンドで作成されたカスタム変数が表示されます。カスタム変数の値は、File/Excel I/Oや画像比較などのコマンド実行結果に依存する場合、期待される値と一致しない可能性があります。例えば、ExcelファイルからCELLVALUEという変数に値を読み込むスクリプトをコンパイルすると、テーブルには変数が作成されますが、コンパイラが入力ファイルを読み込もうとしないため、その値は正しくありません。

• Javaスクリプトの場合、テーブルには事前定義された変数のみが表示されます。これはJavaスクリプトのコンパイル時にsetVariable()呼び出しが評価されないためです。

2. 実行変数（「実行変数」）タブには、直近のスクリプト実行時に定義された変数のリストが表示されます。このテーブルには、コンパイル時に定義された変数セットに加え、実行されたコマンド（例：画像比較やファイル/Excel I/Oなど）によって生成された変数が含まれます。実行変数は、レポートコマンドまたはreport() Javaメソッドのいずれかによって作成されるXMLレポートでも追跡可能です。() Java methods.

上側の図は、MY_VARIABLE という変数を持つ単純な Java スクリプトの実行変数テーブルの例を示しています。変数を右クリックすると、以下の操作を含むコンテキストメニューが開きます（テーブル下部のボタンからも利用可能）：

• 「MY_VARIABLE の値を表示」は、その値を表示するシンプルなウィンドウを開きます。これにより、長い値や複数行にわたる値を確認できます。変数値の表示は、変数上でダブルクリックを行うことでも可能です。

•   「変数名をクリップボードにコピー」メニュー項目（ボタン）は、中括弧で囲まれた変数名をシステムクリップボードにコピーします。そこから他のアプリケーションに貼り付けることができます。

•  「変数名をアクティブなエディタにコピー」項目（ボタン）は、中括弧で囲まれた変数名をアクティブなエディタにコピーします。これは実際には変数呼び出しであり、スクリプトが実行されるときに実際の変数値に置き換えられます。

•   変数値をクリップボードにコピー」項目（ボタン）は、変数値をシステムクリップボードにコピーします。

•  「変数の値をアクティブなエディタにコピー」項目（ボタン）は、変数の値をアクティブなエディタにコピーします。

変数は、v/-variable CLIオプションを通じて固定値を持つことができます。このような変数には、名前に「(fixed)」という接尾辞が付加されます。例えば、左の画像はMY_FIXED_VARIABLEという固定変数を表示しています。これはツールが-v "MY_FIXED_VARIABLE=fixed" CLIオプションで起動されたためです。固定変数はスクリプト内で変更できず、T-Plan Robotの実行中ずっとその値は不変です。VarコマンドやEvalコマンドでこのような変数を変更しようとすると、その操作は無視され、エラーメッセージや警告は表示されません。この仕組みは、パラメータ化されたスクリプトを設計できるようにするために設計されました。

4. コンパイラタブ

コンパイラタブには、現在のスクリプトの最新のコンパイルから得られたエラーおよび警告メッセージが表示されます。

• エラーがない場合、コンパイラタブには アイコンが表示され、コンポーネントは「構文エラーなし」と報告します。

• エラーが発生すると、コンパイラタブには アイコンが表示され、スクリプトエディタタブには アイコンが表示され、コンポーネントはエラーをシンプルなツリー形式で表示します。エラーメッセージをクリックすると、スクリプトエディタが対応するコード行にジャンプします。