ハートコア株式会社
HeartCore Roboドキュメント一覧
GUIリファレンス
2023-01-04

HeartCore Robo スクリプトエディタ

目次
1. スクリプトエディタの概要
2. エディタのコンテキストメニュー
3. テストスクリプトの記述
4. テストスクリプトのコンパイル
5. テストスクリプトの実行


1.スクリプトエディタの概要

スクリプトエディタでは、テストスクリプトを作成および編集できます。テストスクリプトの作成と実行を容易にするための追加機能を備えた標準的なテキストエディタです。エディタは、GUIの左下部分にあるタブ付きのペインで構成されています。各エディタは3つの主要コンポーネントで構成されています。
スクリプトエディタ

  1. エディタ本体を囲むタブ付きペインはエディタコンテナとして機能します。タブ名がスクリプトファイル名です。エディタの内容が変更された場合は *(アスタリスク)が追加表示されます。マウスポインタをタブテキストの上に置くと、完全なスクリプトファイルパスのファイル名が表示されます。このタブでは、マウスの右ボタンをクリックすると(メインGUIの[ファイル]メニューの[スクリプトを閉じる]または[スクリプトを保存]等)のコンテキストメニューが表示され選択できます。
  2. エディタ部の左外枠は行番号を提供し、この部分をクリックすることでスクリプトの実行を一時停止(ポーズ)するブレークポイントを設定・解除できます。






  3. コードエディタは次の機能を搭載したHeartCore Robo標準のテキストエディタです。
TPRテストスクリプトエディタは、3つのスクリプトビューをサポートしています。

TPR Script Editor TPR Script Editor TPR Script Editor
  1. グラフビューは、フローチャート型に表示される開発エディタモードです。エディタ本体右側のコマンドリストから必要なコマンドをドラッグしてくることでロボットを作成します。詳細設定は各コマンドのプロパティウインドウで行います。
  2. ツリービューは、名前の通りスクリプトをツリー上に表示するモードです。コマンドの設定はグラフビュー同様右側コマンドリストから必要なコマンドをドラッグしてきます。詳細設定は各コマンドのプロパティウインドウで行います。
  3. スクリプトコードは、テキストエディタタイプの開発エディタモードです。エディタ本体右側のコマンドリストから必要なコマンドをドラッグ、またはエディタ上で直接テキストを記述することができます。詳細設定に関しても各コマンドのプロパティウインドウ、直接記入両方で行右ことができます。コメントアウトはこのモードでしか行うことができません。


Javaテストスクリプトエディタは、2つのスクリプトビューをサポートしています。

Java Script Editor
  1. フルビューは、ファイルのJavaクラス全体を表示します。
  2. ショートビューは、test() メソッド (または、メソッド内のメインの try/catch ブロック) の内容だけが表示され、テストスクリプトの本文を表します。残りの java クラスは、java クラスヘッダjava クラスフッタのノードに折りたたまれています。これらは、最終的に + ボックスをクリックして展開することができます。


コードエディタは、すべての通常の編集機能と以下のようないくつかの特定のアクションをサポートしています。緑のアスタリスクでマークされたショートカットキーは、エディタの環境設定で設定できます(エディタのコンテキストメニューの章を参照)。

アクション名
ショートカットキー
説明
元に戻す
Ctrl + Z 最後の編集を元に戻します。
やり直し Ctrl + Y 最後に元に戻した編集をやり直します。
コピー
Ctrl + C 選択したテキストをシステムのクリップボードにコピーします。
カット
Ctrl + X 選択したテキストをシステムクリップボードに切り取ります。
ペースト
Ctrl + V システムのクリップボードの内容を現在の位置に貼り付けます。
検索/置換
Ctrl + F エディタで文字列を検索または置換します。
行に行く
Ctrl + G 指定された行番号に移動します。
コメントアウト
Ctrl + /(スラッシュ)*
選択したコードブロックをコメントアウトするかコメントを外します。
ブレークポイントの切り替え
Ctrl + B * ブレークポイントを作成/削除します。
コンテキストメニュー
Ctrl + Shift + Enter * エディタのコンテキストメニューを開きます(マウスの右クリックと同じです)。
コマンドウィザード
Ctrl + Enter * コマンドウィザードのメニューを開きます。
コードテンプレートウィザード
Ctrl + I
コードテンプレートウィザードの一覧を開きます。
新しいスクリプト
Ctrl + N
新しいエディタで新しいテストスクリプトを作成します。
スクリプトを開く
Ctrl + O
新しいエディタでテストスクリプトを開きます。
スクリプトを保存する
Ctrl + S
現在のテストスクリプトを保存します。
スクリプトを閉じる
Ctrl + W
現在のテストスクリプトを閉じます。
コンパイルスクリプト
F9
現在のスクリプトをコンパイルします。
スクリプトを実行する
F6 現在のスクリプトを実行します。
Javaへのエクスポート
Ctrl + J Java Converterを使用してスクリプトをJavaに変換します(TPRスクリプトのみ)。

これらの機能の大部分は 、メインGUIのファイルおよび編集メニューでも利用できます。

2.エディタのコンテキストメニュー

コンテキストメニューは、テキストエディタコンポーネントのテキスト行で直接マウス右クリックやダブルタップすることでアクセスできます。Ctrl + Shift + Enter のショートカットでも表示できます。

エディタのコンテキストメニューの例 

このメニューには、次の3種類のアクションがあります。
  1. 安定したエディタのアクションのようなスクリプトをコンパイルエディタを設定これらは常に利用可能で、通常はメニューの一番下にあります。
  2. コンテキストアクションは、現在の行のテキストエレメントに関連付けられます。
  1. いくつかのコマンド/メソッド呼び出しは、追加のコンテキストまたは実行固有のアクションを定義します。 たとえば、WaitコマンドのContinueアクションは、コマンド実行中にのみ使用できる動的アクションであり、スクリプトを直ちに再開することができます。

3.テストスクリプトの作成

エディタは、スクリプト言語に精通していないユーザでも簡単にスクリプトを書くことができるようになっています。テストスクリプトの作成には、次のワークフローが推奨されます。

コマンドウィザード

  1. プロジェクトテンプレートとレポートパスを使用し、テスト結果とともにXMLファイル(いわゆる「レポート」)を作成するようにスクリプトを構成することを強くお勧めします。詳細については、プロジェクトビューのトピックを参照してください。
  2. コンポーネントキャプチャ機能を使用して、画面認識を操作するブロック全体を作成します。より細かい開発には、コマンドウィザードCtrl + Enterまたは右クリック - > コマンド/メソッド呼び出しの作成)を利用して、アトミックスクリプト操作を作成してください。

    または、スクリプト記録機能を 使用して スクリプト内のマウスイベントとキーボードイベントの基本フローを生成します。スクリプトレコーダーを参照してください。 詳細については、ヘルプトピックを参照してください。次に、生成されたコードを手動で調整します。必要に応じて、タイムアウトの変更、コマンドのマージ、再利用可能なプロシージャの作成、またはコマンド引数のパラメータのパラメータ化を行います。
  3. 記録する際に、リモートデスクトップの内容や画像比較を使用したコンポーネントの存在を確認することが適切な場合に、検証のポイントを定義します。このような各時点で録画を停止し、コンポーネントキャプチャウィザードのいずれかを利用してコンポーネントイメージを作成し、コンポーネントでスクリプトアクションを作成します。または、CompareToScreenshotまたはWaitForウィザードを使用してテンプレートイメージを作成し、スクリプトでアトミック比較操作を設定することもできます。

コードテンプレートウィザード
  1. スクリプトコードのフラグメントは、コードテンプレートウィザードCtrl + Iまたは右クリック - > コードテンプレートの挿入)で簡単に作成できます。カスタムテンプレートも作成できるテンプレートエディタがあります。詳細については、「コードテンプレート」を参照してください。
  2. 基本的な自動化コードが設定されたら、結果報告する方法を決めます。ツールパネル には、あなたがどこのテスト結果(レポート)と形式での保存先を定義することができます。スクリーンショットを作成するには、Screenshotコマンド インスタンスをテストスクリプトの適切な場所に挿入します。スクリーンショットウィザードは、コマンドの構文を知らなくても、コマンドを作成するのに役立つように設計されています。
  3. スクリプトを変更するには、変更するコマンドまたはメソッド呼び出しを右クリックし、プロパティ 項目を選択してパラメータエディタを開きます。

4.テストスクリプトのコンパイル

各スクリプトは実行前にコンパイルされ、最終的には変更後にコンパイルされます。このタスクは、test script interpretと呼ばれるオブジェクトによって自動的に実行されます。
エディタは、以下をサポートすることによって、コンパイル時の元になるテストスクリプト解釈を助けます。
  1. オンデマンドコンパイルは、エディタのコンテキストメニューまたはメインGUIスクリプトメニューコンパイルメニュー項目から呼び出すことができます
  2. オンザフライコンパイルは、各スクリプトの変更と設定されたアイドル時間の後に自動的に実行されます。これにより、作成中および/または変更中のスクリプトの有効性を継続的にチェックすることができます。コンパイルには大変時間がかかるため、大規模スクリプトを扱う場合パフォーマンスが大きく低下することがあります。この機能をオフにする、またはタイムアウト値を変更するには、プリファレンス設定ウィンドウを開き、スクリプト - > 実行に設定します。エディタをオフにすると、スクリプトを手動でコンパイルするか実行するまで、エディタは構文エラーを報告しません。
コンパイルプロセスがスクリプトのエラーを検出すると、次のようになります。

エラー報告
  1. コンパイラ タブのアイコンは、赤いボールになり、そのペインには、スクリプトエラーのリストが表示されます。エラーをクリックすると、エディタの対応する行にジャンプします。エラーを右クリックすると、それをクリップボードにコピーすることができます。「コンパイラタブ」のトピックも参照してください。
  2. エディタタブに赤い感嘆符アイコンが表示され、スクリプトにエラーが含まれていることが示されます。
  3. エラーを含むエディタ行に赤で下線が引かれます。下線の色は、プリファレンスウィンドウの外見&アクセシビリティ - > スクリプトエディタパネルで設定できます。
  4. エラーメッセージは、マウスポインタが行の上に置かれたときはいつでもツールヒントの形式で表示されます。
  5. キャレット(ドット)が対応するエディタ行にあるとき、ステータスバーにもエラーメッセージが表示されます。




5.テストスクリプトの実行

アクティブエディタで開いたスクリプトは、メインGUIウィンドウのスクリプトメニューまたは対応するツールバーボタンのコントロールを使用して実行できます。

実行ツールバー

GUIにワークアイテム(スケジュール)とテストスクリプトの両方が開いている場合、Execute Selection 実行 ボタンは常にワークアイテム(スケジュール)を優先します。テストスクリプトを単独で実行するには、スクリプトエディタを右クリックし、コンテキストメニューからExecute スクリプトを実行を選択します。

スクリプトを実行する

スクリプトまたはその一部(選択実行を参照)が実行されている間、Execute Selection 実行またはExecute Selection 選択ボタンは一時停止 一時停止ボタンに変わります。スクリプトやワークアイテム(スケジュール)を一時停止することができます。一時停止をオンに設定しても、現在実行されているコマンドには適用されず、コマンド実行が終了して次のコマンドの開始時点でスクリプトが中断されます。一時停止機能は他の機能でも使用されます。ブレークポイントと、ステップバイステップモードが有効になったときにポーズフラグに設定されます。

スクリプト実行の動作は、[ スクリプト ]メニューにあるフラグ(オプション)の影響を受けます。

実行オプション


選択実行(ブロック実行

エディタでは、スクリプト全体ではなくコマンドブロックのみを実行することができます。これを実行するには、Execute Selection 実行する行を選択(強調表示)して、選択実行メニュー項目またはツールバーボタンを選択します。コマンドを完全に強調表示する必要はありません。コマンドの1文字だけを選択しても、HeartCore Robo Desktopは行全体を実行します。次の図は、CompareToコマンドとif / elseブロックをまたいだ実行を示しています。

選択したコマンドを実行する
TPRテストスクリプトのブロック実行には、次の規則が適用されます。
Javaテストスクリプトのブロック実行は、v3.1以降でサポートされています。次の規則が適用されます。


実行トレース

エディタは上図画像のように、現在実行されているコマンドラインを黄色(またはその他のカスタムカラー)でハイライトします。プリファレンス設定に応じて、ツールはエディタ間で切り替えたりビューをスクロールして実行された行を表示します。この機能を使用すると、現在実行されているコマンドをトレースできます。その動作は2つのフラグによって制御されます。
実行トレースはJavaテストスクリプトでもサポートされていますが、Java Test Script APIメソッド呼び出しにのみ限定されています。


デバッグ

テストスクリプトのデバッグは、ブレークポイントステップバイステップ実行機能によってサポートされています。ブレークポイントは、特定の行のスクリプトの実行を一時停止します。ブレークポイントに達すると、スクリプトは一時停止 一時停止され、一時停止メニュー項目またはツールバーボタンの選択を解除するまで再開しません。
ブレークポイント定義するには、番号表示のあるエディタのフチをクリックします。クリックポイントから右側の行には、有効なコマンド(TPRスクリプト)またはJava Test Script API メソッド呼び出しが含まれている必要があります。(Javaテストスクリプト)。エディターの行が赤くなり、ガターに赤い地球のアイコンが表示されます。ブレークポイントを作成する別の方法は、エディタ画面の左フチを右クリックし、コンテキストメニューの[ ブレークポイントの追加 ]を選択することです。ブレークポイントは、同様の方法で削除できます。このメニューは、エディタ内のすべてのブレークポイントを削除する方法も提供します。既存のブレークポイントのポップアップメニューが表示されている次の図を参照してください。

ブレークポイントポップアップメニュー

メニュー項目とツールバーボタンを使用してステップ実行 ステップ実行することにより、一度に1行のコードだけを実行できます。次の規則が適用されます。
実行コントロールに使用する色を設定するには、プリファレンス設定ウィンドウを開き、外見&アクセシビリティ -> スクリプトエディタツリーノードに移動します。

もう1つ興味深いエディタ機能は、実行中のTPRスクリプトを実際に編集できることです。まだ実行されていないコードを変更すると、変更が実行されたコードに変更が反映されます。これは、独自のテストスクリプトの解釈が内部でDocument Object Model(DOM)を使用して、次に実行される行(要素)を決定するために可能です。この機能により、ブレークポイントとステップスクリプトの実行を組み合わせたテストスクリプトの簡単で快適なデバッグを可能にしています。