Run

3.2.15 Run

Run - 別のスクリプトを実行します：

本仕様書に記述された形式のTPR スクリプト(通常は .tpr ファイル)を実行します。T-Plan Robot は、呼び出されたスクリプトに書かれているのと同じようにコマンドを処理します。procedures,Variables,screenshotとreport generator実行されたスクリプトで定義されたコマンドは実行リポジトリに残り、Run コマンドが終了するとアクセスできるようになります。Exitスコープをfileに設定したコマンドを使用すると、Runで実行されたスクリプトからメインスクリプトに戻ることができます。
Java ソース・ファイル（.java ファイルでなければなりません。）DefaultJavaTestScript クラスを継承するか、少なくともJavaTestScript インターフェイスを実装した、有効な T-Plan Robot Java スクリプトでなければなりません。Run コマンドはソースコードをコンパイルし、クラスをインスタンス化し、その test() メソッドを実行します。この呼び出しにはJava コンパイラへのアクセスが必要なため、T-Plan Robot はJava Development Kit (JDK) 上で動作するか、2.3.3 以降でサポートされているJDK インストールへのパスが設定されている必要があります。）ツールが Java Runtime Environment (JRE)だけで動作し、JDK が利用できない場合、ツールはエラーを報告する。手順についてはリリースノートを参照してください。
Javaクラス名（バージョン2.2からサポート）。DefaultJavaTestScript クラスを継承するか、少なくともJavaTestScript インターフェイスを実装した、有効な T-Plan Robot Java スクリプトに対応する完全修飾 Java クラス名 (パッケージ名+クラス名) でなければなりません。このクラスは、デフォルト（パラメータなし）のコンストラクタを持たなければなりません。Run コマンドは、クラス名を指定してインスタンス化し、その test() メソッドを実行します。このメソッドは Java コードのコンパイルを伴わないため、パフォーマンス・オーバーヘッドが最小で非常に高速であり、実運用シナリオに推奨されます。
コンパイルされたクラスコードは、3つの方法のいずれかで T-Plan Robot のクラスパスに配置する必要があります：
- Include commandを通じてコード(JAR、ZIP、またはclasspath)を読み込みます。この方法により、スクリプトが動的にコードを読み込み、現在のJava/Robotインスタンスに利用可能にできます。
- リリースノートに記載されているロボットのスタートコマンドの「-classpath」パラメータにJAR、ZIP、またはclasspathを追加します。これにより、そのコードは特定のJava/Robotインスタンスに利用可能になります。
- Robotを実行するために使うJavaインストールの<java-home>\lib\ext)またはLinux/Unixの<java-home>/lib/extにコード付きのJARファイルを置いてください。これにより、このインストールから開始されたすべてのJavaインスタンス(およびすべてのRobotインスタンス)にコードが利用可能になります。

バージョン2.2では、<name>=<value>のペアで指定されたオプションのパラメータもサポートされています。これらのパラメータは、実行されるスクリプトまたはJavaクラス内でのみ有効なローカル変数として、実行されるスクリプトに公開されます。TPRスクリプトでは、パラメータは標準変数として名前で呼び出すことができます。Javaコードの側では、getContext().getVariable()メソッドや、ScriptingContextインターフェイスで定義された便利なメソッドgetVariableAsXXX()のセットを通して、パラメータを取得することができます。

実行コマンドは、コードの一般的なスニペット（ライブラリ）を実装したり、個々のテストケースのテストコードを分離したりするために効果的に使用できます。バージョン2.2で提供されたJavaサポートの強化により、パラメータ化されたJavaルーチンのライブラリを実装し、TPRスクリプトから呼び出すことができるようにななりました。これは、Plugin メカニズムを通さずにスクリプト言語にカスタム機能を追加する効率的な方法です。

概要

実行

run <file_or_class> [<param1>=<value1> ... <paramN>=<valueN>]

* 赤い色は必須パラメータを示す。

オプション

file

-ファイルは以下のいずれかです：

TPRスクリプトファイル(.tpr)またはJavaスクリプトファイル(.java)。このファイルは、現在のスクリプトファイルからの相対パス(例えば sayHello.tpr)、または絶対パス(/root/scripts/sayHello.tpr)のいずれかを指定します。 T-Plan Robotは、スクリプトの検証のたびに、このファイルが存在し、読み込めるかどうかをチェックし、読み込めない場合はエラーを報告します。
完全修飾された Java スクリプトクラス名 (org.mytests.DoSomething など)。指定されたクラスは、Java クラスパス上になければなりません。詳細についてはcommand description.

<パラメータ>=<値>

– オプションのパラメータとその値のリスト。これらのパラメータは、ローカル変数の形で実行されるファイルで利用できるようになります。

戻り値

Run は常に最後に実行されたコマンドによって返されたコードを返します。指定されたファイルが見つからない場合、T-Plan Robot はゼロ以外の戻り値を返すのではなく、構文エラーを報告します。

例

JS

Run sayHello.tpr

– このコマンドを呼び出しているスクリプトと同じディレクトリにある sayHello.tpr というスクリプトを実行します。

JS

Run /root/scripts/sayHello.tpr

– root/scripts/ディレクトリにあるsayHello.tprというスクリプトを実行します。

JS

Run /root/scripts/MyTest.java

– 指定された Java ソース・コード・ファイルを実行します。これは、com.tplan.robot.scripting.DefaultJavaTestScriptを拡張したクラスか、少なくともcom.tplan.robot.scripting.JavaTestScriptインタフェースを実装したクラスでなければなりません。このファイルは、まず Java Compiler API を用いてバイトコード形式にコンパイルされ、次いでインスタンシエートされて実行されます。これは、T-Plan Robot が JDK ディストリビューションの Java 上で実行されるか、JDK インストール (v2.3.3 以降) への有効なパスが設定されている場合にのみ機能します。

JS

Run com.testsuite.MyDummyTestScript server="rfb://localhost:5901" pass="welcome"

– Javaスクリプト・クラスをインスタンス化して実行します。クラスはJavaクラスパス上になければならず、com.tplan.robot.scripting.DefaultJavaTestScriptを拡張するか、少なくともcom.tplan.robot.scripting.JavaTestScriptインタフェースを実装しなければなりません。コマンドラインの2つのパラメータは、変数としてコンテキストに挿入されます。

JS

Var SCRIPT_TO_EXECUTE=sayHello.tpr
Run "{SCRIPT_TO_EXECUTE}"

– 変数で指定されたスクリプトを実行する。