Include

3.2.12 Include

説明

Include - 他のスクリプトまたはコンパイルされたJavaコードをインクルードします。

引数がこのドキュメントで説明されている言語のTPRスクリプトである場合、このコマンドはスクリプトからONLY手続きと変数を実行コンテキストにロードし、呼び出し元のスクリプトがそれらを利用できるようにします。この原則により、グローバルに使用される変数と手続きでライブラリを構築し、スクリプトにリンクすることができます。

引数がJARファイルやZIPファイル、クラスパス（.classファイルを含むディレクトリ構造）を意味するJavaリソースである場合、コマンドはそれをJavaクラスパスに追加し、そこに含まれるコンパイル済みJavaコードをインスタンス化できるようにします。このメカニズムはv2.2で導入され、コンパイルされたJavaスクリプトの動的ロードをサポートすることを目的としています。Run command.

クラスパスの動的な更新は、Java仮想マシン（JVM）インスタンス全体に影響することに注意してください。複数の自動テスト・プロセスがある場合、そのようなリソースをロードすると、そのクラスがすべての自動テスト・プロセスで即座に利用できるようになります。ファイルまたはパスがすでにクラスパス上に存在する場合、コマンドは何もせず、同じインクルード・コマンドを繰り返し呼び出しても何も害はありません。いったんリソースがロードされると、ファイル・システム内の最終的な変更はJVMと同期されません。つまり、Robotの実行中にリソースコードに変更を加えて再コンパイルすることはできません。

インクルードファイル名またはパスは、変数を通じて動的に指定することも可能です。これにより最終的に、ライブラリ名を外部から`-v`CLI Option経由で渡すことが可能となります。

SYNOPSIS

include <file_or_Java_resource>

• 赤い色は必須パラメータを示します。

オプション

file

-TPRスクリプトファイルまたはJavaリソース(JAR/ZIPファイルまたはクラスパス)を含めます。ファイル名には相対パス (sayHello.tpr など) または絶対パス (/root/scripts/sayHello.tpr など) を指定します。T-Plan Robot はファイルが存在し、読み込めるかどうかを毎回チェックします。script compilationが存在し、読み取れるかどうかをチェックし、読み取れない場合はエラーを報告します。ファイルは変数で指定することもできます (例を参照)。

戻り値

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

例

Include sayHello.tpr

• このコマンドを呼び出しているスクリプトと同じディレクトリにある sayHello.tpr というスクリプトから、すべての変数とプロシージャを読み込みます。

Include /root/scripts/sayHello.tpr

• このコマンドを呼び出したスクリプトと同じディレクトリにある sayHello.tpr というスクリプトから、すべての変数とプロシージャを読み込みます。

Var PROFILE=profile1.tpr
Include {PROFILE}

• 変数で指定されたスクリプトを含めます。異なる構成のスクリプトがさらにある場合は、CLI から '-v PROFILE=profile2.tpr' を使用して別のスクリプトをインクルードできます。

Include C:\projects\TestLib\testlib.jar
Run mypackage.MyTestScript

-指定された場所から Java ライブラリ（JAR ファイル）をロードし、そこからスクリプト を実行する。この JAR ファイルには、有効な Java スクリプトである MyTestScript というコンパイル済みクラス (DefaultJavaTestScript クラスを継承しているか、少なくともJavaTestScript インターフェイスを実装している) を持つ "mypackage" というパッケージ (ディレクトリ) が含まれているものとします。詳細はRunを参照してください。