Integrations

Integration Reference

Contents:

1. Overview
2. Product Integration Guides
3. Generic Integration

1. Overview

このドキュメントは、T-Plan Robot Enterprise をサードパーティ製ソリューションと統合する方法に関する概要情報を提供します。

2. 製品統合ガイド

この章では、特定のソフトウェア製品向けの既存の統合ガイドを一覧表示します。

3. 汎用的な統合

以下のロボット機能、プラグイン、ツールはサードパーティ製ソリューションとの統合に適しています：
ロボットのコマンドラインインターフェース(CLI)は、汎用的な統合を容易にサポートするよう設計されています：

• スクリプトまたはワークアイテムを実行するには、r/-runオプションを使用します。

• システムは起動時にc/-connectおよびp/-passwordオプションで指定できます。スクリプトはそれ以外の場合、Connectコマンドを使用して独自に接続します。

• カスタム値は、v/-variable オプションを通じてスクリプトに渡すことができます。

• ヘッドレス環境（ターミナル/rsh/telnet接続）を起動する際は、GUIを抑制するためにn/-nodisplayオプションを使用してください。

• 自動化の全体的な結果は、プロセスの終了コード（0は合格、それ以外は不合格）を通じて示されます。詳細については、スクリプトが生成したXMLレポートをReportコマンドで解析してください。そのパスはCLIから-vオプション（-v "_REPORT_DIR=<targetDir>"）で設定可能です。Dir>").

TPR言語は、簡単な統合に適したいくつかのコマンドを提供します：

• Exec コマンドは、ローカル OS コマンドを実行できます。例えば、CLI を通じて他のプロセスにデータを渡す場合などに使用します。

• ファイルおよびExcelコマンドは、プレーンテキスト、CSV、またはMS Excelファイルからのデータの読み取りと書き込みを可能にします。これは、別のプロセスとの簡易な通信に使用できます。

• SendMail コマンドは、スクリプトから電子メールを送信します。

• 環境（システム）変数は、スクリプト内で {_}ENV_ が接頭辞として付いた変数として認識されます。 たとえば、MS Windows の Path 変数は、_ENV_Path 変数として利用できます。

ロボットのJava APIは、Javaアプリケーションやフレームワークとの統合、あるいはスクリプトからカスタム機能を呼び出したい場合に最適です：

• Javaスクリプトは、任意のサードパーティ製Javaアプリケーションから起動できます。JavaからTPRコードを呼び出すには、ラッピングJavaスクリプトを作成し、run(java.lang.String)メソッドを使用してTPRファイルを呼び出します。

• Javaスクリプトはあらゆるサードパーティ機能を利用可能であり、スクリプトからフレームワークへの接続性を実現するのに最適です。クラスはユーザーフレンドリーなGUIエディタを作成するためにパラメータを宣言できます。コンパイルされたJavaコードはスクリプトプラグインと呼ばれるJARファイルにパッケージ化され、インクルードおよび実行コマンドを通じてTPR言語に再組み込みされます。このシステムにより、JavaコードとTPRコードを自由に混在させることが可能です。参照用コード例については、弊社のプラグインウェブサイトで公開されている無料のオープンソースExtent ReportsおよびSQL Databaseプラグインを参照してください。

• いくつかのロボット機能は、パラメータとシステムプロパティを通じてJava APIレベルでカスタマイズできます。

ユーティリティプラグインは、FileControlスクリプトを提供します。これにより、実行中のRobotインスタンスにTPRまたはJavaコードを動的に渡すことが可能です。フレームワークがデータとタスクフローを提供し、Robotを駆動して自動化を実行させることができます。

リモートコントロールクライアントは、TCP/IP経由で稼働中のRobotインスタンスと通信することを可能にします。スクリプトの開始や停止、現在の実行状況の取得、サーバーの強制終了といった基本的なスクリプトタスクの実行をサポートします。この機能により、リモートマシン上のRobotインスタンスを制御する分散システムを構築することが可能となります。