rap
RAPサーバー
重要: このドキュメントは、Robot v7で廃止された旧式のRAP2接続について説明しています。過去の参照用としてのみ掲載されています。この機能はRAP3およびRAP Agent製品に置き換えられました。 |
|---|
Contents:
1. 概要
T-Planは2016年にRobot Automation Portal (RAP)製品を導入しました。これはTCP/IPネットワーク（インターネットおよび／またはイントラネット）経由でT-Plan Robot Enterprise駆動の自動化を監視・管理できるWebポータルです。詳細は当社のWebサイトをご覧ください。
RAPポータルとの通信をサポートするため、T-Plan Robot Enterprise v4.2ではRAPサーバーコンポーネントを提供しました。これはRAPポータルと通信するTCP/IPサーバーです。新世代RAPに対応するため、4.3リリースでは機能が大幅に強化されました。
2. RAP ポータルへの接続
ロボットホストが RAP による監視の対象となるかどうかを確認するには、以下を確認してください。
T-Plan Robot 4.3 以降が、RAP サーバーを起動した状態でロボットホスト上で実行されていること。
ロボットホストは、TCP/IP ネットワーク上で認識可能であり、RAP ポートを介した通信を許可している必要があります（ファイアウォールによるブロックがないこと）。静的 IP アドレスの使用を推奨します。
RAP サーバーを起動するには、次のいずれかを実行します。
--rapserver CLI オプションを指定して、ロボットの起動時にサーバーが起動するようにします。
ロボットの GUI で、[ツール] - [ RAP Server Manager メニュー項目を選択し、Start ボタンをクリックします。
ロボットホストをRAPポータルに接続するには、Web UIでロボットホストを以下のように登録します：
RAPと同じマシン上で動作するロボットを追加する場合は、localhostまたは127.0.0.1を使用します。
リモートマシンを追加する場合は、マシン名（例：myrobot、myrobot.mydomain）またはIPアドレス（例：121.234.11.3）を使用します。
--rapserver オプションで RAP サーバーのポートをカスタマイズした場合は、セミコロン（;）の後にポート番号を追加してください（例：myrobot:12345、myrobot.mydomain:12345、121.234.11.3:12345）。
登録が完了すると、ポータルはロボットマシン上で動作している RAP サーバーへの TCP/IP 接続を確立します。
セキュリティに関する考慮事項：
Robot 4.3 の時点では、Robot と RAP ポータル間の通信は暗号化されていません。そのため、この設定は信頼できるネットワークでのみ使用することをお勧めします。セキュリティを強化するには、IP またはサブネットマスクを使用して Robot サーバーへのアクセスを制限してください（--rapmasks CLI オプションを参照）。RAP/Robot の将来バージョンでは SSL 暗号化が提供される予定です。このオプションに関心がある場合は、現在の状況について サポート にお問い合わせくださいhis option please ask our support for the current status.
3. データ同期
RAPポータルはリレーショナルデータベース上で動作し、2種類のデータを保存します：
ロボットプロジェクト、作業項目、スクリプトに関する情報（RAP用語では「作業項目」と呼ばれます）。データベースには、スクリプトコード（Java の TPR）は保存されません。
結果およびレポート（「結果」）
RAP ポータルでレコードを削除すると、データベースからそのレコードが削除されるだけです。プロジェクト、ワークアイテム、スクリプト、結果（レポートファイル）など、ロボットホスト上のデータには一切影響しません。
ワークアイテムを RAP ポータルにエクスポートするには、3 つの方法があります。
ポータルに接続した状態でスクリプトまたはワークアイテムを実行すると、そのアイテムが RAP データベースにエクスポートされます。
--rapdirs CLI オプションを使用すると、起動時に Robot が指定されたファイルパス上のワークアイテムを同期させることができます。このオプションは、ヘッドレス環境や、ターミナル（telnet、rsh）からリモートで Robot を起動する場合など、GUI を使用できない場合に適しています。
GUI で手動同期を行うには、プロジェクト ビュー でプロジェクト、作業項目（スクリプトまたは作業項目ツリー ノード）、または関連するフォルダ ノードを右クリックし、「RAP と同期」 を選択します。
結果は以下の方法でエクスポートされます：
RAPは、ポータルでのロボットマシン登録時点以降に生成された結果のみを記録します。古い結果のエクスポートは現在不可能であり、将来のリリースで対応予定です。必要な場合は、現在の状況についてサポートにお問い合わせください。
ワークアイテムの実行は、RAPとの接続がある限り、結果をリアルタイムでRAPデータベースにエクスポートします。
RAPへの接続が中断された場合、接続が再確立されると結果は再同期されます。この処理には時間がかかる場合があります。ローカルファイルシステムからレポート（XML/HTML）を検索・解析する必要があるためです。ファイル同期は一方向（RobotからRAPへ）のみであり、レポートファイルの削除はデータベース内のデータに影響しません。検索に時間がかかりすぎる場合や、RAP接続直後にハードドライブのパフォーマンスが急上昇する場合は、古いレポートをクリーンアップしてください。
過去の結果の検索は以下のように動作します：