Robot Quick Start

T-Plan Robot は、スクリプトを作成し実行するためにデスクトップ環境内に配置される自動化エンジンであり、本ガイドではこれに焦点を当てています。しかし、T-Plan が「T-Plan RAP」を提供し、中央のウェブアプリケーションから多くの異なる環境にわたる Robot の実行を管理、オーケストレーション、レポートする機能を提供していることを知るだけでも、全体像を理解するのに役立ちます。

Robot自体はJavaデスクトップアプリケーションであり、いくつかの利用可能なメソッドのいずれかを使用してターゲットSUA（System Under Automation）に接続します。

Java

T-Planロボットをインストールする前にJavaをインストールする必要があります。このガイドではJavaのインストールは扱いませんが、Java 9+からすべての主要なディストロがサポートされています。

1. スタンドアロンZIPアーカイブまたは適切なインストーラパッケージをダウンロードしてください。

2. インストールします：

   1. クロスプラットフォームのZIPアーカイブを使用する場合は、お好きな場所に解凍してください。

   2. .exeまたは.dmgを使用する場合は、ダブルクリックしてネイティブ・インストール・ウィザードを起動し、指示に従って完了します。

3. 実行

   1. ZIPアーカイブを使用する場合は、robot.batまたはrobot.shをダブルクリックしてロボットを起動します。

   2. Windowsインストーラーをお使いの場合は、Windowsのスタートメニューを開き、T-Plan Robotを選択します。

   3. MacOSの場合、アプリケーションリストを開き、T-Plan Robotを選択します（初回起動時には、指示に従ってRobotをセキュリティ例外に追加する必要があります）。

以上です！

T-Plan Robotはファイルベースのアプリケーションですので、データベースやウェブサービスなどのサーバーサイドのコンポーネントをセットアップする必要はありません。

ロボットを初めて起動する前に、ライセンスコードをクリップボードにコピーしてください。これはウェルカムメールに記載されています。

ロボットのホームページから "新規プロジェクト "を選択してください。

サンプルプロジェクトも用意されています。ホームページの左下にあるセクションから希望のサンプルを選んでダウンロードし、開いてください。

プロジェクト名と場所を入力し、プロジェクトの作成を選択します。

次に、新しいプロジェクト内に最初のスクリプトを作成するよう求められます。

最後に、Robotでの作業方法を選択します。試用期間中は以下の設定をお勧めします：

• レイアウトタイプ - コードとビジュアルの両方で開発したい。

• スクリプトのツリー表示

オプションを設定すると、RobotのメインUIが表示されます。主なセクションは以下の4つです：

1. プロジェクトパネル

2. スクリプトエディター

3. コマンドプロパティパネル

4. SUAデスクトップビューア

左側のクイックアクセスバーを使用して、各パネルをすばやく非表示/表示することで、ワークスペースを最大化できます。また、仕切りバーにあるハンドル(

自動スクリプトを作成するには、レコーダーを使用するのが一番手っ取り早い方法です。このセクションでは、最初のスクリプトを作成する手順を説明します。

"接続

Robotの多くの機能はターゲットSUAに接続しないと利用できませんが、Recorderもその一つです。リボンバーから接続を選択します。

接続ダイアログが表示されますので、接続タイプとして"Local Desktop"を選択します：

"録画

録画を成功させるためのヒント

• 録画前にアプリケーションやウィンドウを閉じて、「クリーン」なベースラインから開始できるようにする。

• 安定した一貫性のある方法でマウス操作を行う。

• マウスとキーボードの両方の操作が記録されることを忘れないでください。

• マウスクリックによって生成された画像テンプレートは、クリックが適用される数ミリ秒前にスクリーンからキャプチャされます。

次に、ツールバーから「記録」を選択します。

ここではローカルデスクトップに接続しているので、レコーダーモードは"Rapid"しかありません。これは、Robotが録画中に中断しない代わりに、録画後にレビューオプションを提供することを意味します。

先に進む前に、録音を終了するオプションをメモしておいてください。一般的には、右 Ctrl キーを押します。

最初のスクリプトには、非常にシンプルなシナリオを選ぶことをお勧めします。また、マウス操作とキーボード操作を混ぜて使用することをお勧めします。例えば

1. 電卓アプリを起動する。

   1. Windowsを押す

   2. 電卓と入力

   3. Enterを押す

2. 方程式の実行

   1. 任意の数をクリック

   2. 任意の演算子をクリックします（プラス、または乗算）

   3. 任意の数をクリック

   4. Enterを押す

3. 結果の確認

   1. 結果の値をクリック

4. 電卓アプリを閉じる

   1. 閉じるアイコンをクリック

5. 記録を終了する

   1. 記録を終了するには、前述のホットキーを押します（例：右Ctrl）。

レコーダーの使い方と各種オプションの詳細については、こちらのヘルプページをご覧ください：高速レコーダーモード.

"レビュー/編集

録画が完了すると、レコーダー履歴ウィンドウが表示され、実行した操作に基づいてレコーダーが生成した内容を確認することができます。

ここには、マウス（クリック/ドラッグ/スクロール）アクションのみが表示されます。

ツリーに表示されている各クリックアクションを選択すると、下のスナップショットサムネイルが表示されます。ハイライトされている部分が、ロボットが今後使用する画像テンプレートです。

強調表示されたテンプレート部分を修正するには、サムネイルをダブルクリックして、クリックが実行される直前にキャプチャされたフルスクリーンショットを開きます。ここで必要な領域を再選択し、新しいテンプレートを作成します。

ベストプラクティス - 画像テンプレートは、必ずしも人間の目にとって意味がある必要はありませんが、ユニークでありながら、できるだけ小さくする必要があります。詳しくは「画像テンプレートを理解する」をご覧ください。

記録した操作の結果、以下のようなスクリプトが作成されるはずです、

Windows

Report results.xml

Press Windows+D
Press Windows
Typeline Calculator
Click image template="comp1001-1"
Click image template="comp1001-2"
Click image template="comp1001-3"
Press Enter
Screenshot sum.png
Press Alt+f4

Mac: js

$body

リボンバーのオプションを使用して、アクティブなスクリプト全体を実行することも、ハイライトされた部分のみを実行することもできます。

実行中はマウスやキーボードに触れないでください。

ローカルデスクトップに接続している場合、実行または選択実行を選択すると、実行の邪魔にならないよう、再びRobotが最小化されます。

実行中にマウスを動かしたりキーを押したりすると、一時停止してロボットのUIに戻ります。

失敗した場合はロボットに報告させ、適切に対処することをお勧めします。

以下の場合、実行は停止します：

• 検索コマンドが一致しない場合 - 実行が一時停止され、"Image Doctor"が表示されます。

または

• スクリプトの実行が「完了」し、自然に終了する。

完了すると、"Result Manager"ウィンドウが表示され、ステータスの確認や出力レポートへのアクセスが可能になります。

ここで "View "を選択すると、出力レポートが開きます。

実行中、"Project "パネルが "Execution Log"タブに切り替わり、発生した問題を含む実行の概要が表示されます。

Project"タブに戻ると、ツリーを展開して過去の実行結果をすべて見ることができます。ここで、いつでもエントリーを右クリックし、"View in web browser" を選択すると、レポートを見ることができます。