2023-01-04

HeartCore Roboのツールパネル

目次
1. 概要
2. パスタブ
3. 変数タブ
4. コンパイラタブ

1.概要

ツールパネルは、HeartCore Robo開発画面の左（上）にあるタブ化されたビューです。これは5つのタブで構成されています。

[ツール]タブ

[ プロジェクト ]タブには、現在のプロジェクトの詳細が表示されます。このコンポーネントは、独自のプロジェクトヘルプトピックで説明されています。
[ パス ]タブ（2.xリリースの[設定]タブ）は、現在のスクリプト（タブの下のエディタに表示されているスクリプト）のI/O設定を構成します。スクリプトが開かれていない場合、タブは表示されません。
[ 変数 ]タブには、現在のスクリプトのコンパイルおよび実行変数一覧が表示されます。スクリプトが開かれていない場合、タブは表示されません。
[ コンパイラ ]タブには、現在のスクリプトの最後のコンパイルによって生成されたエラーのリストが表示されます。スクリプトが開かれていない場合、タブは表示されません。
[ 実行ログ ]タブは、スクリプト実行ログの累積ビューです。このコンポーネントは、実行ログのヘルプトピックで説明されています。スクリプトが開いておらず実行ログがない場合（アプリケーションが起動してからスクリプトが実行されていない場合）にはタブが表示されません。

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

イベントの構文サポートタブWaitfor更新呼び出しが削除されました。異なるベンダーのVNCサーバー間で画面更新のテストが信頼できるものではないため「search2」と「search」を使用した画像比較が画面内容を確認する良い方法となっています。
鍵タブはキーボードツールウィザードに変更されました。

2.パスタブ

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

出力パスは、スクリーンショット、レポートやスクリプトの実行の結果、他の出力ファイルをに保存されるディレクトリです。パスを変更すると、現在のスクリプトの_REPORT_DIR変数が更新されます。ドロップダウンでは次のオプションが提供されます。

オプション	説明
プロジェクト（ユニーク）	スクリプト実行ごとに一意のプロジェクトレポート（出力）パスを作成します。スクリプト出力は`<project_home>/reports/<script_file_name>_<time_stamp>`、タイムスタンプが1970年1月1日から経過したミリ秒単位の実行（コンパイル）開始時間である新しいフォルダにリダイレクトされます。詳細については、プロジェクトヘルプのトピックを参照してください。重要： v4.0以降、これはグローバルパスが設定されていない場合のデフォルトオプションです。`_REPORT_DIR`変数を設定していないプロジェクトにあるスクリプトは、デフォルトで一意のプロジェクトレポートパスに出力されます。この場合のバージョン3.x以降は、ユーザーホームフォルダです。
プロジェクト（共有）	スクリプト出力をデフォルトのプロジェクトフォルダにリダイレクトします。これは、各実行時のスクリプト出力を書き換えます。詳細については、プロジェクトのヘルプトピックを参照してください。
グローバル...	プリファレンスウィンドウの言語パネルで指定されたグローバルパスをスクリプト出力にリダイレクトします。このオプションは2.xリリースと互換性があり、スクリプトコードが`_REPORT_DIR`変数を変更しようとしないときに適用されます。重要：グローバルパスの設定は、起動時にすべてのロボットプロセスによってロードされる設定ファイルに保存されます。そのため、`_REPORT_DIR`変数を明示的に設定しないマシン上のすべてのスクリプトに影響します。このオプションは注意して使用してください。
カスタム...	スクリプト出力をカスタムパスに保存します。

テンプレートのパスは、比較的参照テンプレート画像と画像コレクションを検索するディレクトリです。パスを変更すると、現在のスクリプトの_TEMPLATE_DIR変数が更新されます。ドロップダウンでは次のオプションが提供されます。

オプション	説明
プロジェクトテンプレートディレクトリ	`<project_home>/templates`で比較参照されているテンプレート画像を、プロジェクトテンプレートパスで解決します。詳細については、プロジェクトのヘルプトピックを参照してください。重要：v4.0以降、これはグローバルパスが設定されていない場合のデフォルトオプションです。`_TEMPLATE_DIR`変数を設定していないプロジェクトにあるスクリプトは、標準でプロジェクトテンプレートディレクトリになります。この場合、バージョン3.x以前は、ユーザーのホームフォルダにフォールバックします。
グローバル...	[環境設定]ウィンドウの[ 言語 ]パネルで指定したグローバルパスに対して、相対参照テンプレートイメージを解決します。このオプションは2.xリリースと互換性があり、スクリプトコードが変数を変更しようとしないときに適用されます。重要：グローバルパスの設定は、起動時にすべてのロボットプロセスによってロードされる設定ファイルに保存されます。そのため、`_TEMPLATE_DIR`変数を明示的に設定しないマシン上のすべてのスクリプトに影響します。このオプションは注意して使用してください。
カスタム	カスタムパスでテンプレートイメージを検索する。

[結果をレポートに保存]を選択すると、レポートコマンドまたはreport（） Javaメソッドの1つがアクティブエディタに挿入されます。コマンド/メソッド呼び出しが実行されると、スクリプト、ステップ、警告、スクリーンショット、ログなどの実行結果が、指定された出力パスの HTMLレポートファイルまたはXMLレポートファイルに保存されます。
レポートファイルは、レポートファイル名を定義します。".html"または ".xml"のいずれかの拡張子を持つ必要があります。より効率的でカスタマイズ可能なXML形式を使用することを強くお勧めします。また、結果をT-Plan ProfessionalまたはXSL変換を通じて他のサードパーティのツールにエクスポートすることもできます。XMLファイルは、HTMLファイルと同じ方法で任意のWebブラウザで表示することもできます。例については、WebサイトのサンプルXMLレポートを参照してください。
説明レポートヘッダーに表示されるオプションのテストスクリプトの記述です。デフォルト（HTML）およびエンタープライズ（HTML、XML）レポートプロバイダ（外部リンク）によって作成されたサンプルレポートを参照してください。

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

3.変数タブ

一般に、変数には次の3つのタイプがあります。

あらかじめ定義された変数。暗黙的変数とも呼ばれます。それらの名前は通常、アンダースコア '_'で始まります。これらは、各スクリプトのコンパイルまたは実行ごとに基礎となる自動化フレームワークによって作成されます。
VarおよびEvalコマンド（TPRテストスクリプト）またはgetContext().setVariable() メソッド呼び出し（Javaテストスクリプト）を使用してスクリプトで定義されたカスタム変数。
実行されたコマンドまたはメソッド呼び出しによって作成された変数。

[ 変数 ]タブには、3つの独立した変数テーブルがあります。

コンパイル変数タブには、最新のスクリプトのコンパイル時に定義された変数のリストが表示されます。

TPRのテストスクリプト

Javaテストスクリプト

setVariable（）

実行変数タブでは、最新のスクリプトの実行中に定義された変数のリストが表示されます。このテーブルには、コンパイル結果と同様の変数セットと、実行されたコマンドによって生成された変数（例えば、画像比較やファイル/ Excel I / Oなど）が含まれます。実行変数は、Reportコマンドまたはreport() Javaメソッドの1つによって作成されたXMLレポートでも追跡できます。
保護変数タブでは、セーフボックスのロック解除やセーフボックスマネージャを使った保護変数の状態が表示されます。

左側の画像には、MY_VARIABLEという変数を持つ単純なJavaテストスクリプトの実行変数テーブルの例が表示されます。変数を右クリックすると、コンテキストメニューが開き、以下のアクションが表示されます（テーブルの下にあるボタンも使用可能）。

「MY_VARIABLEの値を表示」は、その値を持つシンプルなウィンドウが表示されます。これにより、長い値および/または複数の値を表示することができます。変数値をダブルクリックすることにより、変数値の表示も可能です。
「変数名をクリップボードへコピー」は、メニュー項目（ボタン）、それは他のアプリケーションに貼り付けることができ、そこからシステムのクリップボードに中括弧で囲まれた変数名をコピーします。
「変数名をアクティブエディタへコピー」item（ボタン）は中括弧で囲まれた変数名をアクティブなエディタにコピーします。これは実際には変数呼び出しであり、スクリプトの実行時には実際の変数値に置き換えられます。
「変数値をクリップボードへコピー」の項目（ボタン）は、システムのクリップボードに変数の値をコピーします。
「変数値をアクティブエディタへコピー」の項目（ボタン）は、アクティブなエディタに変数の値をコピーします。

変数は、-v/--variable CLIオプションを使用して固定値を持つことがあります。そのような変数には、その名前に「（固定）」接尾辞が付加されています。たとえば、ツールは

-v
      "MY_FIXED_VARIABLE=fixed"

CLIオプションで開始されたため、左側のイメージにはMY_FIXED_VARIABLEという固定変数が表示されます。固定変数はスクリプト内で変更することはできず、その値は、HeartCore Robo Desktop実行中常に一定です。VarまたはEvalコマンドを使用してそのような変数を変更しようとすると、その変数は無視され、エラーメッセージまたは警告は報告されません。このメカニズムは、パラメータ化されたテストスクリプトを設計できるように設計されています。

4.コンパイラタブ

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

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

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