Skip to main content
Skip table of contents

CLI Options

CLIオプション

1.スタートアップCLIオプション

アルファベット順にサポートされている標準オプション:

--autosave
-c, --connect
--cfg
--createscript
-e, --edit
-h, --help
-l, --listen
--license
--licensekey
--licenseserver
--locale
-m, --resultmanager
-n, --nodisplay
--nologin
--nooutput
-o, --option
--outputdir
-p, --password
--params
-r, --run
--rapdirs (removed in v7)
--rapmasks (removed in v7)
--rapserver (removed in v7)
--remotecontrol
--safepass
--templatedir
-u, --user
-v, --variable
--variable-session

1.1 標準CLIオプション

synopsis_startup| options_startup| examples


SYNOPSIS

T-Plan Robot Enterprise を実行するには、インストールフォルダに移動し、以下のコマンドのいずれかを使用します:

MS Windows:

robot.bat [オプション]

Mac OS、Linux、Unix:

./robot.sh [オプション]

オプション

-h, --help

ヘルプの短縮版を表示する。

-c, --connect [protocol://host[:port]] 接続する。

-c, --connect [host[:display]] 接続する。

-c, --connect [host[::port]] 接続する。

デスクトップまたはイメージに接続する。引数には、%26lt;protocol>://%26lt;host_or_IP%26gt;\[:%26lt;port%26gt;\] の形式で有効な URL を指定する必要があり、protocol はインストールされているクライアントプラグイン (protocol) コードのいずれかと等しくなければならない。サポートされている接続タイプとそのURLのリストは Release Notesドキュメントを参照のこと。例

-c fox.red.com:1 -p welcome
-c fox.red.com::5901 -p welcome

fox.red.comというマシンの5901番ポートで動作しているVNCサーバーに、"welcome "というパスワードで接続します。

URL でプロトコルが省略された場合、VNCRobot 1.x との後方互換性を提供するために、接続はデフォルトで RFB (VNC) のものになります。ポートを取得するには、表示番号を取り、それをデフォルトの RFB ポートである 5900 に加えます。例えば、「localhost:1」と「localhost::5901」の両方は、ポート5901で動作する同じローカルVNCサーバーを参照しています。標準的なURL形式で同じアドレスを指定するには、実際のポートを記載する必要があり、同等のURLは"rfb://localhost:5901 "です。

-c rfb://fox.red.com:5900
-c rfb://fox.red.com

マシンfox.red.comで動作しているVNCサーバーに接続する。サーバーはデフォルトのポート5900で動作しているため(典型的なWindowsマシン)、ポートを指定する必要はない。

-c rfb://192.168.100.9:5901 -p welcome

IPが192.168.100.9のマシンのポート5901で動いているVNCサーバーに接続する。サーバーは "welcome "のパスワードを要求する。

-c file://C: \TestDataScreen.png

指定した画像ファイルを読み込んで、ライブデスクトップの代わりにテストする。

-c file://C:◆TestData◆images.jar!/examples/screen.png

JARファイル内にzip圧縮された画像をロードし、ライブデスクトップの代わりにテストします(JARバンドルのサポートは2.3で導入されました)。

-c file://desktop.bmp

インストールディレクトリにある画像を読み込みます。URL の相対ファイルパスは、常にインストールディレクトリに対して解決されます (2.3 以降でサポート)。

-c adb://default

接続を使用して、USBケーブル経由でAndroidデバイスに接続します(3.1以降)。android接続します(3.1以降)。

-c adb://MB104PY10519

Android Over ADB接続を使用して、指定されたシリアル番号のAndroidデバイスに接続します。ロボットマシンに複数のデバイスが接続されている場合に使用します。

-c java://localhost

接続を使ってローカルデスクトップに接続します。local接続します(3.2以降)。

-c apple://192.168.100.13:5901

接続を使用して、ポート 5901 で VNC サーバーを実行している Apple デバイスに接続します(3.3 以降)。ios接続します(3.3以降)。

-c apple://192.168.100.13:5909

接続を使用して、ポート 5909 で T-Plan サーバーを実行している Apple デバイスに接続します (3.5 以降)。ios接続します(3.5 以降)。

システムへの接続はConnectコマンド呼び出し、またはJavaスクリプトのconnect()メソッド呼び出しによっても確立できます。接続は、GUI のloginを使用して手動で接続を開始することもできます。

-l, --listen [:display]
-l, --listen[::port] を指定します。

これは RFB (VNC) 固有のパラメータで、T-Plan Robot Enterprise に RFB サーバからの逆接続をポート 5500+display でリッスンさせます。

このパラメータを指定すると、接続プロトコルは自動的に RFB に設定され、-c/--connect パラメータは指定できません。その後、サーバーから接続を開始する必要がある。この手順はサーバーとプラットフォームに依存する。Linux/Unixシステムではvncconnectと呼ばれるユーティリティを使用しますが、Windows上のVNCサーバーでは通常、GUIまたはコマンドラインオプションから接続を開始できます。詳細については、VNCサーバーのドキュメントを参照してください。

-u, --user [ユーザー名]

デスクトップサーバーの認証に使用するユーザー名(ID)。サーバーが必要としない場合、このパラメータは無視される。RFB(VNC)も、本製品がサポートする静的イメージクライアントも、ユーザー名を必要としないため、このオプションは現在使用されておらず、将来の使用とサードパーティクライアントの拡張のために予約されています。

-p, --password [パスワード]

デスクトップサーバー (通常は RFB/VNC) を認証するためのパスワード。サーバーがパスワードを必要としない場合、このパラメータは無視される。例についてはcパラメータを参照してください。

-v,--variable[変数名]=[値].

スクリプト変数の値を上書きする。スクリプトのVar command.このパラメータで定義された変数値は、スクリプトの実行中ずっと変更されずに残り、スクリプトで宣言された変数の変更を上書きします。この機能を使用して、同じスクリプトを異なる構成で実行できます。CLIパーサーは、変数名と値を区切るために最初の等号 '=' を探すため、変数名に等号が含まれていない場合があります。名前または値にスペースが含まれる変数を渡すには、引数全体を二重引用符で囲みます(例:-v "MYVARIABLE=これはスペースを含む変数値です")。

--variable-session [variablename]=[value]

すべてのスクリプトから見える読み書き可能なセッション変数を作成する。 Vargコマンドを参照してください。v6.3以降でサポートされています。

-o, --option [オプション名]=[値].

ユーザー設定値を再定義する。環境設定ダイアログで設定可能なものはすべて、ここで再定義できます。この方法で上書きされた環境設定値は、スクリプトを実行している間だけ保持され、ユーザー設定ファイルには書き込まれません。プリファレンスの名前と許容される値については、デフォルト設定ファイルを参照してください。CLI パーサはオプション名と値を区切るために最初の等号 '=' を探しますが、 名前に等号が含まれていないこともあります。名前または値にスペースが含まれるオプションを渡すには、引数全体を二重引用符で囲みます。

-r,--run[ファイル名]

スクリプト (.tpr、.java) または schedule(.xml)を実行する。バージョン 7 以降では packages(.zip) も使用できます。ファイル名は相対パスでも絶対パスでもかまいません。相対パスは T-Plan Robot Enterprise のインストールフォルダに対して解決されます。このオプションは GUI と CLI (-n/--nodisplay を使用) の両方のモードで使用できます。

-n, --nodisplay

GUIを表示しない。このオプションは、--r/--run オプションと一緒にのみ使用でき、グラフィカル・インターフェースを使用せずにコマンド・ラインからスクリプトを実行する。CLIモードでの実行は、多くの利点があるため、本番環境での配備に推奨される:

    • パフォーマンスが向上し、必要なメモリが大幅に少なくなります。

    • GUI モードとは異なり、スクリプトを並行して開始できるため、テスト キャンペーンを完了す るのに必要な時間を短縮できます。スクリプトの並列実行は schedule(v4.0以降)、ツール Script Starterツールの上にシンプルなJava プログラムを記述することでも実現できます。 Java Scripts#execute.

    • 自動化されたタスクは、telnet や rsh など、グラフィカル表示のない端末からリモートで開始することができます。

-e, --edit [filename].

GUI を起動し、指定された特定のテストスクリプトをスクリプトエディタで編集するために開きます。ファイル名には相対パスまたは絶対パスを指定できます。相対パスが指定された場合、T-Plan Robot Enterprise のインストールフォルダに対して解決されます。このオプションは GUI モードでのみ意味を持ち、それ以外では無視されます。

このオプションは、T-Plan Robot Enterprise のデフォルトの動作である、前回のセッションから開いているスクリプトをリストアする動作を上書きします。スクリプトがプロジェクトに属している場合、GUI は最近使用したプロジェクトの代わりにプロジェクトを開きます。

-m, --resultmanager

CLIモードでもresultmgrウィンドウを強制的に表示させる。これは通常、CLIモードで実行された1つ以上のスクリプトの結果を確認するために使用される。ウィンドウは、最初のスクリプトが終了してテスト結果が生成されると開く。すべてのスクリプトが終了しても、ウィンドウが開いている限り Java プロセスは終了せず、ユーザーは結果を確認し、最終的に保存するか T-Plan Professional データベースにエクスポートできます。このオプションを GUI モードで使用する場合 (-n/--nodisplay オプションなし)、ウィンドウはデフォルトで GUI で使用できるため、無視される。このオプションは v2.3 以降でサポートされています。

--remotecontrol <port>

リモートコントロールサーバを起動する。リモートコントロールサーバを起動することで、ロボットインスタンスをRemoteControlツールまたはtelnetを使って遠隔操作できるようになります。ポート番号は任意で、1024から65535の間でなければなりません。省略した場合のデフォルトは5899です。このオプションはv3.5からサポートされています。

--rapserver <port>

このオプションはv7ではサポートされなくなりました。 T-Plan RAPとは直接通信しません。この機能は RAP Agent.

--rapdirs <path(s)>

このオプションは v7 ではサポートされなくなりました。 T-Plan RAPとは直接通信しません。この機能は RAP Agent.

--rapmasks <ip_mask(s)>

このオプションは v7 ではサポートされなくなりました。 T-Plan RAPとは直接通信しません。この機能は RAP Agent.

--restricted

いくつかの実行制御ボタンのみを持つ最小限のGUIを表示します。これは、-r/--runオプションと一緒に使用し、Robot ウィンドウ全体を表示せずに GUI モードでオートメーションを実行するためのものです。このモードは暗号化された packagesが実行されているときに強制されます。v7からサポートされています。

--safebox [safebox_file]

ファイルの場所。 safeboxファイルの場所。v7からサポート。

--safepass [password]

のロックを解除するためのパスワード。safeboxスクリプトに保護された変数へのアクセスを許可します。v4.4.2からサポート。

--params [JSON_file]

指定したJSONファイルからCLIオプションを適用する(4.4.2から)。JSONプロパティは、オプション名からマイナス文字を除いたものになります。JSON フ ァ イ ルに、 コ マ ン ド ラ イ ン上でも指定 さ れてい る オプシ ョ ンが含まれてい る場合は、 後者のオプシ ョ ンが優先 さ れます。JSONファイルの形式は以下のとおりです:

    • 値が続かないオプションは、値をnullとして指定する。たとえばn{ "n": null }となります。

    • 値の後に続くオプションは、文字列または数値で指定できます。例えばr{ "r":"<ファイル>"}

    • 次のような<param>=<value>の形式で値を受け付けるオプションは、次のようになります。vまたはoは、単一の値{ "v":"MYVAR=test" } またはオブジェクト{ "v":{ "MYVAR" : "test" }}のどちらかを指定することができる。オブジェクトのバリアントは、同じオプションを複数回呼び出すのに適している。

例えば次のようなコマンド:

robot.bat -n -r C: \Robotscript.tpr --var MYVAR1=abc --var MYVAR2=def

と等価である。

robot.bat -params myparams.json

ここで、JSONファイルには

JSON
{
"n": null、
"r":"C:♪Robotscript.tpr"、
"v":{
"MYVAR1":"abc"、
"MYVAR2":"def"
}
}

--ライセンスキー[ファイル

引数ファイルまたはセミコロンで区切られたファイルリストからライセンスキーを使用して起動します。v4.0 以降でサポートされています。T-Plan Robot Enterpriseに渡すライセンスキーファイルは4種類あり、自由に組み合わせることができます:

  • このオプションを使用する。

  • T-Plan Robot Enterpriseのインストールフォルダに保存する。Robotは*.tlicファイルを検索し、起動時に自動的にロードします。

  • 起動時に自動的に読み込まれます。 ツール-%26gt;ライセンスキーマネージャーウィンドウを開きます。これにより、キーの場所がユーザー設定ファイルに保存されます。

  • robot.licenseKeyシステムプロパティを通して(v4.0.3以降)。この方法はRobotとサードパーティのJavaアプリケーションを統合するプロジェクトに適しています。例として Release Notes#licenseドキュメントを参照してください。

--licenseserver [server_address[:port]]
--licenseserver [license_ID]

ライセンス・サーバーに接続して実行ライセンスを取得します。引数は次のとおりです:

    • 有効なライセンス ID をGUID 形式で指定します(例:"16ba7d1-5a03-481a-8e84-86a77fa47e05")。通常、T-Plan サポートからこれを受け取り、デフォルトの T-Plan ライセンスサーバーに対して解決されます。このオプションは 7.2.9 以降でサポートされています。

    • https://myserver.mydomain/licserver?lid=16ba7d1-5a03-481a-8e84-86a77fa47e05」のような完全なライセンス サーバ URL。このオプションは4.4からサポートされています。

T-Plan Robot Enterprise にライセンスサーバーを渡すには、3つの方法があります:

    • このオプションを使用する。

    • このオプションを使用します。 ツール-%26gt;ライセンスキーマネージャーウィンドウを使用します。これにより、サーバーアドレスまたはライセンスIDがls.addressキーの下にユーザー設定ファイルに保存され、永続的に使用できるようになります。こ のオプシ ョ ン を - CLI ス イ ッ チで指定す る こ と も で き ます。oCLIスイッチでこのオプションを渡すこともできます。

    • robot.licenseServerシステム・プロパティを通して(v4.4以降)。この方法は、RobotとサードパーティのJavaアプリケーションを統合するプロジェクトに適しています。例については Release Notes#licenseドキュメントを参照してください。

--cfg[ファイル]

%26lt;user_home%26gt;/.tplanrobot/tplanrobot.cfg にあるデフォルトのファイルの代わりに、指定されたユーザー設定ファイルを使う。このオプションは、単一の組織内で配布するために、特定の設定で製品を再パッケージ化することができます。v4.0からサポートされています。

--createscript[ファイル名]

このオプションは、新しいスクリプトを作成するか、既存のスクリプトを上書きして、GUI起動時にエディタで開きます。これは、定義済みのコンテンツでGUIを起動する必要があるサードパーティフレームワークとの統合を可能にすることを目的としています。このオプションはGUIモードでのみ意味を持ち、-n/--nodisplayオプションが指定されると無視されます。

引数のファイル名は相対パスでも絶対パスでもよい。相対パスが指定された場合、T-Plan Robot Enterprise のインストールフォルダに対して解決されます。

このオプションは、T-Plan Robot Enterprise のデフォルトの動作である、前回のセッションから開いているスクリプトを復元する動作を上書きします。 スクリプトがプロジェクトに属している場合、GUI は最近使用したスクリプトの代わりにそれを開きます。

--outputdir [パス]

createscriptで作成したスクリプトの出力パスを初期化します。このオプションは、'Var _REPORT_DIR=%26lt;path%26gt;'の変数コマンドを作成し、スクリプトに挿入します。-createscriptが指定されていない場合、このオプションは無視されます。

注意: CLIから既存のスクリプトの出力パスを指定するには、-v/--variable オプションを使用して _REPORT_DIR 変数を設定します。例えば、-v "_REPORT_DIR=C:˶"と指定すると、T-Plan Robot Enterpriseが終了するまでの間、出力パスを指定したパスに固定します。

--templatedir [パス]

createescript で作成したスクリプトのテンプレートパスを初期化する。このオプションは変数'Var _TEMPLATE_DIR=%26lt;path%26gt;' を作成し、スクリプトに挿入します。-createscriptが指定されていない場合、このオプションは無視されます。

注意: CLIから既存のスクリプトのテンプレート・パスを指定するには、-v/--変数オプションを使用して_TEMPLATE_DIR変数を設定します。例えば、-v "_TEMPLATE_DIR=C:˶templates "と指定すると、T-Plan Robot Enterpriseが終了するまで、テンプレートパスは指定したものに固定されます。

--autosave

GUI を閉じたときに、-createscript で作成したスクリプトを自動的に保存します。createscriptが指定されていない場合、このオプションは無視されます。

--nooutput

ドライ・ラン - スクリプトを実行するが、出力を生成しない。このオプションを指定すると、すべてのScreenshotReportコマンドは正常に実行されますが、ファイルは生成されません。これは、スクリプトを再実行し、以前の結果を上書きしないようにしたい場合に、デバッグ目的で使用できます。

--nologin

起動時にログインダイアログを表示せず、メインGUIに進む。cまたは-rで渡されたスクリプトによって指定されたデスクトップ接続がない場合、GUIはオフラインモードで起動し、ようこそパネルが表示されます。

--locale [ロケール]

指定されたロケール(言語)で製品を起動する。locale引数は、インストールされている言語パックのファイル名接尾辞の1つに対応していなければなりません。これは、必須の言語ISO-639 2文字コードと、オプションでアンダースコアと国コード(ISO-3166 2文字)が続き、さらにオプションでアンダースコアとバリアント(ベンダーやブラウザ固有のコード)が続くことがあります。例えば、"-locale de "はドイツ語でプログラムを開始しようとし、"-locale es_MX "はメキシコのスペイン語言語パックを探す。

要求された言語が利用できない場合、プログラムはデフォルトで英語になる。インストールされている言語の一覧はlogin言語コンポーネントを参照してください。

--license

T-Plan Robot Enterprise のライセンスをコンソールに出力します。

./robot.sh --connect fox.robot.com:2

./robot.sh --connect fox.robot.com::5902

./robot.sh --connect rfb://fox.robot.com:5902

3つのコマンドはすべて等しく、fox.robot.comのマシンで5902番ポートで動作しているVNCサーバーに接続する。サーバーが認証を必要としない場合、GUI Reference Overviewが起動し、サーバーのデスクトップをviewer.サーバーがパスワードを要求する場合は、ログインダイアログが表示され、ユーザーは有効なパスワードを入力する必要があります。

./robot.sh --connect java://localhost

Javaネイティブ・クライアントを介して、ローカル・システム・ディスプレイ(画面やその他のディスプレイ・デバイスに表示されているのとまったく同じデスクトップを意味する)に接続する。Java と T-Plan Robot Enterprise 以外のソフトウェアは必要ありません。(エンタープライズ版のみ)

./robot.sh --connect java://192.168.1.1:1099

RMIを使用してJavaネイティブクライアントからIPアドレス192.168.1.1のホストのディスプレイに接続します。ホストマシンに Java がインストールされ、Java サーバモードで T-Plan Robot Enterprise を実行している必要があります。詳細は Java クライアントのドキュメントを参照してください。(エンタープライズ版のみ)

./robot.sh -r self_connect.java

GUI モードで Java スクリプト self_connect.java を実行します。ツールは内部で.class形式にコンパイルして実行します。パスが指定されていないため、T-Plan Robot Enterprise のインストールフォルダに配置する必要があります。また、c/-connect オプションが指定されていないので、スクリプトは独自の接続コードを含んでいなければなりません。

T-Plan Robot Enterprise のインストールフォルダに test.txt というスクリプトがあるとします:

JS
# This script opens an application on GNOME
# We take advantage of the feature that Alt+F2 
# opens the Run Application window
Var APPLICATION=""
Press Alt+F2 wait=5000
Typeline "{APPLICATION}" wait=5000
:screenshot
Screenshot application.png 

次にコマンド:

java -Xmx128m -classpath jh.jar;activation.jar;mail.jar;ポイ-3.6-20091214.jar;robot.jar com.tplan.robot.ApplicationSupport-c fox.robot.com:2 -p mypassword -r test.txt -o scripting.delayBeforeAutomaticExecutionSeconds=5 -v APPLICATION=gnome-terminal

fox.robot.comのポート5902で動作しているVNCサーバーに接続し、test.txtというスクリプトの自動実行をGUIモードで開始する。認証に成功し、サーバーへの接続が確立されると、GUIが表示され、タイムアウトのカウントダウンが開始されます。パラメータ-oがタイムアウト値を再定義するため、標準の15秒ではなく5秒となる。タイムアウトが終わると、スクリプトの実行が始まる。vオプションによってAPPLICATION変数が再定義されると、スクリプトはGNOMEターミナル・ウィンドウを起動し、スクリーン・ショットを撮る。その後、標準15秒のシャットダウン・カウントダウンが開始される。時間が経過すると、GUI は破棄され、T-Plan Robot Enterprise は終了します。

java -Xmx128m -classpath jh.jar;activation.jar;mail.jar;ポイ-3.6-20091214.jar;robot.jar com.tplan.robot.ApplicationSupport-c fox.robot.com:2 -p mypassword -r test.txt -oscripting.delayBeforeAutomaticExecutionSeconds=5 -v APPLICATION=gnome-terminal -n

このコマンドは、GUI が表示されず、T-Plan Robot Enterprise が CLI モードで実行されることを除けば、前のコマンドと同じ結果を提供するはずです。実行ログはコンソールに出力されます。

java -Xmx128m -classpath jh.jar;activation.jar;mail.jar;poi-3.6-20091214.jar;robot.jar com.tplan.robot.ApplicationSupport-c fox.robot.com:2 -p mypassword -r test.txt -v APPLICATION=gnome-terminal --fromlabel screenshot

このコマンドは「Screenshot application.png」 コマンドだけを実行します。これは、screenshotラベルの後にある唯一のコマンドだからです。

robot.sh -c java://localhost -r test.txt -v APPLICATION=gnome-terminal

Javaネイティブクライアントを使って、ローカルのデスクトップ上でtest.txtスクリプトを実行する。ローカル・マシンは、デスクトップ・ソフトウェアを実行している必要はない。自動化は、ローカルOSレベルのディスプレイにアクセスするJavaネイティブ・インターフェイスを通して行われる。これにより、スクリプト、T-Plan Robot Enterprise インスタンス、Java で構成される、再配置可能で、自己完結し、ローカルで実行可能なテストスイートを作成できる。この例のスクリプトは、もともと RFB サーバー上で設計されたものですが、Java で実行するための変更は必要ありません。(エンタープライズ版のみ)

1.2 T-Plan 統合 CLI オプション

T-Plan Integration CLI Options は、他の T-Plan 製品、特に T-Plan Professional 7.0 との統合をサポートするために、既存の標準インターフェースを拡張したものです。詳細は integrationドキュメントをお読みください。このインターフェースはo/-optionでサポートされているユーザー環境設定の上書きメカニズムを利用しているため、標準インターフェースに新しいオプションを定義することはありません。これは、T-Plan Robotのオープンソース版との互換性を保証するものです。T-Plan Robotは、このようなパラメータを消費する機能を含んでいないため、このようなパラメータは一切無視されます。各オプションは、例えば"-o tplan.url=http://localhost:4000 "のように、-oまたは--optionとともに使用する必要があります。

統合オプションは、T-Plan Robot Enterprise に、T-Plan テスト管理データベースの統合タスクのいずれかを実行するよう指示するためのものです:

  1. T-Plan Professional スクリプトエンティティを自動スクリプトにインポートする

  2. 自動化から T-Plan データベースにテスト結果をエクスポートする

一般的なオプションとタスク固有のオプションがあります。

共通統合オプション

共通オプションには、主に各タスクに提供する必要のある認証情報が含まれます。これらのオプションのデフォルト値は、T-Plan Connector ウィンドウの T-Plan Connector パネルからユーザー設定ファイルに永続的に保存できます。 preferencesウィンドウを通してユーザー設定ファイルに永続的に保存することができる。デフォルト値を持つオプションは、コマンドラインで省略することができる。

オプション名

説明

tplan.url

SOA ウェブサービスの URL。例えば "http://tplandb.mycompany.com:4000"。T-Plan Robot Enterprise と T-Plan データベース間のすべての通信は、通常データベースサーバーのポート 4000 で実行されているウェブサービスを通して実現されます。このパラメータは各統合タスクに必須です。

tplan.user

データベースユーザー名。これはT-Plan Professionalにログインするために提供されなければならないのと同じパラメータである。このパラメータは各統合タスクで必須です。

tplan.password

データベースへの認証用パスワード。T-Plan Professional にログインするために提供しなければならないのと同じパラメータです。このパラメータは各統合タスクで必須である。

tplan.database

接続先のデータベース名。T-Plan Professional にログインするために提供しなければならないのと同じパラメータです。このパラメータは各統合タスクで必須です。

tplan.group

データベースのユーザーグループ。T-Plan Professional にログインするために提供しなければならないのと同じパラメータです。このパラメータは各統合タスクで必須である。

tplan.debug

デバッグフラグ(オプション)。値は "true "または "false "のいずれかである。true」を指定すると、ツールは統合デバッグメッセージをコンソールに出力する。デフォルト値は "false"。

インポートオプション

インポートオプションは、GUIの起動時に一度だけ処理されます。スクリプトのインポートに成功してエディタで開くか、タスクが失敗してエラーメッセージが表示されます。どちらの場合もオプションは破棄されます。

オプション名

説明

tplan.importScriptNumber

インポート先の既存の T-Plan Professional スクリプトエンティティの番号。イ ン ポー ト タ ス ク では必須。

tplan.scriptName

インポートするスクリプトエンティティの名前 (オプション)。提供された場合、これは Script Command.

エクスポートオプション

エクスポートオプションは通常r/-run パラメータとともに自動実行で使用されますが、T-Plan Robot Enterprise インスタンスで実行されるすべてのスクリプトに適用されます。つまり、エクスポートオプションを指定して GUI を起動し、いくつかのスクリプトを手動で実行すると、それぞれの結果セットが指定した T-Plan テストスイートにエクスポートされます。このエクスポートモードを終了するには、CLI 引数なしでアプリケーションを再起動します。

オプション名

説明

tplan.autoExport

スクリプト実行後にテスト結果をエクスポートするかどうかを示すフラグ (通常はr/-run オプションを使用)。このタスクを実行するには、値を "true "にする必要があります。この値は、エクスポート・タスクでは必須です。

tplan.mode

テスト結果のエクスポートモード。使用可能な値は以下のとおり:

  • 「create" テスト結果をインポートする新しいテスト スイートを作成します。このモードとともに tplan.newSuiteName を指定する必要があります。tplan.suiteNumber オプションも指定すると、このパラメータで指定したテスト・スイートが、新しいテスト・スイートの親となります。そうでない場合、テスト・スイートは Manage ルート・ノードのすぐ下に作成されます。

  • "rewrite" tplan.suiteNumber オプションで指定した既存のテストスイートのテスト結果を書き換えます。

  • "append" tplan.suiteNumber オプションで指定した既存のテストスイートにテスト結果を追加します。

tplan.suiteNumber

テスト結果をエクスポートするためのテスト・スイート番号。このパラメータは、tplan.mode オプションの値に応じて、対象のテスト・スイートを特定するか、新しいテスト・スイートの親を特定します。

tplan.newSuiteName

新しいテスト・スイートの名前。このオプションは、エクスポート・モードが "create"("tplan.mode=create")のときに指定する必要があります。そうでない場合は無視されます。

EXAMPLES

java -Xmx128m -classpath jh.jar;activation.jar;mail.jar;poi-3.6-20091214.jar;robot.jar com.tplan.robot.ApplicationSupport--createscripttest.tpr -otplan.url=http://localhost:4000-otplan.user=admin -otplan.password=dbadmin -otplan.database=testdb-o "tplan.group=System Administrators" -otplan.importScriptNumber=101

T-Plan Robot Enterprise を GUI モードで起動し、test.tpr というスクリプトを作成し、スクリプトエディタで開きます。ファイルが既に存在する場合は上書きします (ファイルを追記モードで開くには--createscript の代わりに-e/--edit を使用します)。次に、T-Planスクリプトのエンティティ番号101の構造をエディタにインポートします。

java -Xmx128m -classpath jh.jar;activation.jar;mail.jar;ポイ-3.6-20091214.jar;robot.jar com.tplan.robot.ApplicationSupport-c fox.robot.com:2 -p welcome -r test.tpr -otplan.url=http://localhost:4000-otplan.user=admin -otplan.password=dbadmin -otplan.database=testdb-o "tplan.group=System Administrators" -otplan.autoExport=true -otplan.mode=rewrite -otplan.suiteNumber=111

VNCサーバーfox.robot.com上でtest.tprスクリプトを実行する。テスト結果を T-Plan データベースのテストスイート番号 111 にエクスポートする。エクスポートモードが「rewrite」に設定されているため、同じスクリプトの既存の結果は新しい結果で上書きされる。

2.オフライン画像比較CLIオプション

synopsis_comparison| options_comparison| exit_codes_comparison| examples_comparison


同期

T-Plan Robot Enterprise 4.4.3BetaはシンプルなCLIインターフェースでオフライン画像比較にも使用できます。実行するには以下のコマンドのいずれかを使用します。ラッパースクリプトは9つ以上のパラメータを扱えないことに注意してください。より多くのパラメーターを渡したり、T-Plan Robot Enterpriseの起動コマンドをカスタマイズする必要がある場合は、javaを使ったコマンドを使用してください。

Unix/Linux:

./imgcompare.sh%26lt;ソース画像%26gt; %26lt;テンプレート画像[オプション]
java -classpath robot.jar com.tplan.robot.ImageComparison%26lt;source_image%26gt; %26lt;template_image%26gt; [オプション].

MS Windows:

imgcompare.bat%26lt;ソース画像%26gt; %26lt;テンプレート画像[オプション]
java -classpath robot.jarcom.tplan.robot.ImageComparison%26lt;ソース画像%26gt; %26lt;テンプレート画像[オプション]

T-Plan Robot Enterprise で利用可能な全ての画像比較モジュールはPlugin.このCLIはユーザーコンフィギュレーションもロードし、デフォルトの比較方法(モジュール)、デフォルトのパスレート値、'search'の最大検索ヒット数など、GUIを通してカスタマイズされた全ての画像比較設定が使用されることに注意してください。検索比較に使用されます。

オプション

-s

サイレントモード。このオプションは、エラーメッセージ以外のすべての出力を抑制する。このモードは、リターン・コードだけに興味がある場合に使用する。

-c

簡潔モード。search'メソッドと併用すると、[x,y]形式で1行に1つの座標を出力する。この出力は言語に依存せず、将来のバージョンや言語の変更にも対応し、サードパーティのツールによる解析にも適しています。

このスイッチは、'default'メソッドと一緒に呼び出された場合、-sと同じ機能を持つ。1つのコマンドで-sと -cの両方を指定すると、ツールはサイレント・モードで実行される。

-m [モジュール]

使用する画像比較モジュール(メソッド)。T-Plan Robot Enterprise では、ヒストグラムベースの比較のための'default' と画像検索のための'search'の2つが定義されています。画像比較の詳細についてはcomparetoコマンド仕様とImage Comparisonドキュメントを参照してください。

を通してツールにプラグインされたカスタム・モジュールも使用できます。Pluginmパラメータの値は、モジュールのgetMethodName()メソッドによって返される名前に対応しなければならない。

このオプションが省略された場合、ユーザー設定のデフォルト値が使われます。

-p [passrate]

合格率。0 から 100 までの浮動小数点数または整数値で、画像比較結果が 'PASS' (終了コード 0)になるために、ソース画像とテンプレート画像がどの程度一致しなければならないかを表します。

このオプションを省略すると、ユーザー設定のデフォルト値が使われます。default'メソッド(通常95%)と'search' メソッド(100%)には別々のデフォルト合格率があることに注意。

-r [矩形]

画像比較をソース画像の特定の領域に限定します。これはむしろ、アイコンや部分画像を画像の一部分だけで検索することに意味がある場合、'search'メソッドと共に使用されます。

値はT-Plan Robot Enterpriseの矩形形式でなければならない、例えば'x:0,y:25,w:350,h:200'x またはy が省略された場合は 0 が使用されます。w(幅) またはh(高さ) パラメータが省略された場合、その値はソース画像のサイズに対して可能な最大値として計算されます。ソース画像が例えば 640x480 で'-r x:100,h:300' を指定した場合、矩形は'x:100,y:0,w:540,h:300' として計算されます。このオプションを省略すると、画像比較はソース画像全体に対して行われます。

-h [max_number_of_search_hits] 検索ヒット数の最大値。

検索マッチの最大数。最大検索ヒット数に達すると、画像比較は終了し、パスしたかのように振る舞います。

このオプションは'search'比較にのみ適用されます。default' メソッドと一緒に使用した場合は無視され、エラーは報告されません。このオプションが省略された場合、ユーザー設定によるデフォルト値が使用される(通常は100)。

終了コード

終了コード

意味

0

画像比較がパスされた。

1

画像比較に失敗('default':合格率が満たされなかった、'search':指定された合格率で一致するものが見つからなかった)。

2

エラー:ソース画像をロードできませんでした。

3

エラー:テンプレート画像をロードできませんでした。

4

入力引数の構文エラー(エラーを説明するメッセージが出力されます)。

5

内部エラー -サポートに報告してください。

サンプル

java -classpath robot.jar;poi-3.6-20091214.jar com.tplan.robot.ImageComparison image.png pattern.png -m search -r x:0,y:20,w:120,h:300
./imgcompare.sh image.png pattern.png -m search -r x:0,y:20,w:120,h:300

image.pngの[0,20,120,320]の矩形内にあるテンプレート画像pattern.pngを検索します。上記のコマンドはWindowsで有効です。Linux/Unixの場合は、クラスパスのセミコロン「;」をコロン「:」に置き換えてください。

java -classpath robot.jar;poi-3.6-20091214.jar com.tplan.robot.ImageComparison image.png pattern.png -m search -p 99.9 -h 1
./imgcompare.sh image.png pattern.png -m search -p 99.9 -h 1

テンプレート画像pattern.pngがソース画像image.pngの中で99.9%一致する最初のものを検索します。上記のコマンドはWindowsで有効です。Linux/Unixの場合は、クラスパスのセミコロン';'をコロン':'に置き換えてください。

java -classpath robot.jar;poi-3.6-20091214.jar com.tplan.robot.ImageComparison image1.png image2.png -m default -p 99
./imgcompare.sh image1.png image2.png -m default -p 99

画像image1.pngと image2.pngのヒストグラムを比較し、99%以上一致すればPASS(終了コード0)を返す。上記のコマンドはWindowsで有効です。Linux/Unixの場合は、クラスパスのセミコロン「;」をコロン「:」に置き換えてください。

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.