ハートコア株式会社
HeartCore Robo Desktop4.4 Docコレクション
21/06/18

HeartCore Robo Desktop4.4 CLIオプション

内容:
1. HeartCore Robo Desktop 4.4スタートアップCLIオプション
1.1 標準CLIオプション
1.2 T-Plan統合CLIオプション
2. HeartCore Robo Desktop4.4オフラインイメージ比較CLIオプション

1. HeartCore Robo Desktop 4.4スタートアップ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
--rapmasks
--rapserver
--remotecontrol
- -safepass
--templatedir
-u、
--user -v、--variable

1.1標準CLIオプション

梗概 | オプション |

梗概
HeartCore Robo Desktopを実行するには、次のコマンドのいずれかを使用します。ラッパースクリプト robot.sh および robot.bat では、9個以上のパラメータを処理できないことに注意してください。より多くのパラメータを渡したり、start コマンドをカスタマイズしたりする必要がある場合は、java で構文を使用します。バージョン4.4.2 以降では、すべての CLI パラメータを JSON ファイルに指定し、--paramsオプションを通して渡すこともできます。

Unix / Linux:
代替1
./robot.sh [options]
代替2(カスタマイズ、デバッグ、サードパーティコンポーネントとの統合に適しています):
java -Xmx512m -classpath robot.jar:jh.jar:activation.jar:mail.jar:poi-3.6-20091214.jar:javaparser.jar:JTattoo.jar com.tplan.robot.ApplicationSupport [options]

MS Windows:
代替1(最大9つのCLI引数を受け入れる):
robot.bat [options]
代替2(9以上のCLI引数、カスタマイズ、サードパーティコンポーネントとのデバッグおよび統合を伴う呼び出しに適しています):
java -Xmx512m -classpath robot.jar;jh.jar;activation.jar;mail.jar;poi-3.6-20091214.jar;javaparser.jar:JTattoo.jar com.tplan.robot.ApplicationSupport [options]
クラスパス上のいくつかのJARファイルは省略することができます。このような場合のロボットは、省略されたライブラリに依存する機能を無効にします。バンドルされたJARファイルの詳細については、リリースノートを参照してください。


オプション
-h, --help
このヘルプのより短いバージョンを表示してください。

-c, --connect
[protocol://host[:port]]
-c, --connect [host[:display]]
-c, --connect [host[::port]]

デスクトップまたはイメージに接続します。引数は<protocol>://<host_or_IP>[:<port>] 、プロトコルがインストールされているクライアントプラグイン(プロトコル)コードの1つと等しくなければならない形式の有効なURLでなければなりません。サポートされている接続タイプとそのURLのリストについては、リリースノート のドキュメントを参照してください。例:

-c fox.red.com:1 -p welcome
-c fox.red.com::5901 -p welcome
fox.red.com パスワード「welcome」で呼び出されたマシンのポート5901上で実行されているVNCサーバーに接続します。

URLでプロトコルが省略されている場合、接続はデフォルトでRFB(VNC)になり、VNCRobot 1.xとの下位互換性が提供されます。この場合、ポート番号は実際のポートではなくディスプレイ番号と見なされます。ポート番号を取得し、デフォルトのRFBポートである5900に追加します。ダイレクトポートは、このモードではダブルコロンで指定できます。たとえば、 " localhost:1"と " localhost::5901"はポート5901上で実行されている同じローカルVNCサーバーを指します。"rfb://localhost:5901"

-c rfb://fox.red.com:5900
-c rfb://
fox.red.com
マシン上で動作しているVNCサーバーに接続しますfox.red.com。サーバーは5900のデフォルトポート(通常はWindowsマシン)上で動作するため、ポートを指定する必要はなく、上記の両方の例が等しい理由です。

-c rfb://192.168.100.9:5901 -p welcome
IP 192.168.100.9のマシンのポート5901で動作するVNCサーバーに接続します。サーバーには「welcome」というパスワードが必要です。

-c file://C:\TestData\Screen.png
指定したイメージファイルをロードし、ライブデスクトップではなくテストします。

-c file://C:\TestData\images.jar!/examples/screen.png
JARファイル内で圧縮されたイメージをロードし、ライブデスクトップではなくテストします(JARバンドルのサポートは2.3で導入されました)。

-c file://desktop.bmp
インストールディレクトリにあるイメージをロードします。URL内の相対ファイルパスは、常にインストールディレクトリ(2.3以降でサポート)に対して解決されます。
-c adb://default
Android Over ADB 接続(3.1以降)を使用してUSBケーブルでAndroidデバイスに接続します。

-c adb://MB104PY10519
Android Over ADB接続を使用して、指定されたシリアル番号のAndroidデバイスに接続します。このフォームは、ロボットマシンに複数のデバイスが接続されている場合に使用します。

-c java://localhost
ローカルデスクトップ 接続(3.2以降)を使用してローカルデスクトップに接続します。
-c apple://192.168.100.13:5901
iOSミラー接続(3.3以降)を使用して、ポート5901上のVNCサーバーを実行しているAppleデバイスに接続します。
 
-c apple://192.168.100.13:5909
iOSミラー接続(3.5以降)を使用して、ポート5909でHeartCore Robo Desktopサーバーを実行しているAppleデバイスに接続します。

テスト中のシステムへの接続 は、TPRテスト・スクリプトのConnectコマンド・コール、または Javaテスト・スクリプトのconnect()メソッドの呼び出しを使用して確立することもできます。接続 はGUIのログインダイアログから手動で開始することもできます。

-l, --listen [:display]
-l, --listen [::port]
これはRFB(VNC)固有のパラメータで、HeartCore Robo Desktopはポート5500でリッスンし、RFBサーバーからの逆接続を表示します。このモードでは、パブリックIPアドレスを持たないサーバー(たとえば、携帯電話やポータブルデバイス)との接続を確立できます。

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

-u, --user [username]
デスクトップサーバーへの認証に使用するユーザー名(ID)。サーバーがそれを必要としない場合、このパラメーターは無視されます。この製品でサポートされているRFB(VNC)および静止画像クライアントのいずれもユーザー名を必要としないため、このオプションは現在使用されておらず、将来の使用や第三者のクライアント拡張のために予約されています。

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

-v, --variable [variablename]=[value]
スクリプト変数の値をオーバーライドします。Varコマンドのドキュメントを参照してください。このパラメータで定義された変数値は、スクリプトの実行中は変更されずにそのまま残され、スクリプトで宣言された変数の変更はすべて上書きされます。この機能を使用して、異なる構成に対して同じスクリプトを実行できます。CLIパーサーは最初に変数nameとvalueを区切るために '='文字を検索するので、変数名には変数名が含まれていないことがあります。名前または値にスペースを含む変数を渡すには、引数全体を二重引用符で囲みます(例:)  -v "MYVARIABLE=This is variable value with spaces"

-o, --option [optionname]=[value]
ユーザー設定値を再定義します。[設定]ダイアログで設定可能なものはここで再定義できます。このようにオーバーライドされたプリファレンス値は、スクリプト実行時にのみ維持され、ユーザー構成ファイルには書き込まれません。を参照してください T-Plan Robotプリファレンス名と許容値に関する情報のエンタープライズデフォルト設定ファイル。CLIパーサーは、オプション名と値を分離するために、最初の '='文字を検索するので、その名前には値が含まれないことがあります。名前または値にスペースを含むオプションを渡すには、引数全体を二重引用符で囲みます(例:)  -o "some.file=C:\Program Files\T-Plan\file.dat"

-r, --run [filename]
テストスクリプト(.tpr、.java)または スケジュール(.xml)を実行します。ファイル名は相対または絶対のどちらでもかまいません。相対パスは、HeartCore Robo Desktopインストールフォルダに対して解決されます。このオプションは、GUIモードとCLIモードの両方で使用できます。

-n, --nodisplay
GUIを表示しないでください。このオプションは-r/--run、グラフィカルインタフェースを使用せずにコマンドラインからテストスクリプトを実行するオプションでのみ使用できます。運用モードの展開には、多くの利点があるため、CLIモードでの実行が推奨されます。
-e, --edit [filename]
GUIを起動し、指定された特定のテストスクリプトを開いてスクリプトエディタで編集します。ファイル名は相対または絶対のどちらでもかまいません。相対パスが指定されると、HeartCore Robo Desktopのインストールフォルダに対して解決されます。このオプションはGUIモードでのみ意味があり、それ以外の場合は無視されます。

このオプションは、最後のセッションからオープンスクリプトを復元するデフォルトのHeartCore Robo Desktopの動作を上書きします。テストスクリプトがプロジェクトに属している場合、GUIは最近使用されたものの代わりにプロジェクトを開きます。

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

--remotecontrol <port>

リモートコントロールサーバーを起動します。これにより、リモートコントロールツールまたはtelnet を使用してロボットインスタンスをリモート制御することができます。ポート番号はオプションで、1024〜65535の間でなければなりません。ポートを省略すると、デフォルトで5899になります。オプションはv3.5以降でサポートされています。

--rapserver <port>
RAPサーバーを起動して、Robotic Automation Portal(RAP)との通信を有効にします。ポータルは、ネットワーク上のロボットプロセスを監視、分析、制御することができるWebアプリケーションです。ポート番号は省略可能で、1024から65535の間でなければなりません。ポートを省略すると、デフォルトで11298になります。サーバーはTools- > RAP Server Manager   メニュー項目を使用してGUIで制御することもできます。v4.2.1以降でサポートされています。

--rapdirs <path(s)>
ロボットプロジェクトのパスまたはパスのリスト。指定された各プロジェクトのスクリプトとスケジュール(「作業項目」)は、接続が確立されるとRAPポータルと同期されます。ポータルで項目が表示され、管理対象(リモート実行)になります。指定されたパスがプロジェクトホームフォルダでない場合、プロジェクトのために再帰的に検索されます。このオプションは、異なる方法で同期されたテスト結果をエクスポートしません。詳細については、RAPのドキュメントを参照してください。

このオプションは、このオプションと一緒に使用することを意図しています--rapserver 。GUIを使用できない、たとえばヘッドレス環境の展開では、作業項目をRAPにエクスポートできます。v4.3以降でサポートされています。

--rapmasks <ip_mask(s)>
RAPサーバーへの着信接続を制限するIPアドレスまたはサブネットマスク。複数のマスクはセミコロンで区切る必要があります。このオプションでは、次のマスク形式を使用できます。
v4.3以降でサポートされています。

--safepass
[password]
セーフボックスのロックを解除してスクリプトに保護された変数へのアクセスを許可するパスワード。v4.4.2以降でサポートされています。


--params
[JSON_file]
指定されたJSONファイル(4.4.2以降)からCLIオプションを適用します。JSONプロパティは、先行するマイナス文字のないオプション名になります。JSONファイルにコマンドラインで指定されたオプションが含まれている場合は、後者の方が優先されます。JSONファイル形式は次のとおりです。
たとえば、次のようなコマンドです。
robot.bat -n -r C:\Robot\script.tpr --var MYVAR1=abc --var MYVAR2=def

robot.bat -params myparams.json
JSONファイルに含まれる場所
{
    "n": null,
    "r": "C:\Robot\script.tpr",
    "v": {
        "MYVAR1": "abc",
        "MYVAR2": "def"
    }
}

--licensekey [file(s)]
引数ファイルのライセンスキーまたはセミコロンで区切られたファイルのリストを使用して起動します。v4.0以降でサポートされています。ライセンスキーファイルを自由に組み合わせることができるHeartCore Robo Desktopに渡すには、次の4つの方法があります。

--licenseserver [server_address[:port]]
指定したアドレスのライセンスサーバーに接続して、実行するライセンスを取得します(v4.3以降)。サーバーアドレスは、ホスト名(たとえば"mymachine""mymachine.com")とオプションのport("mymachine:8881")で構成されます。ポートが指定されていない場合は、デフォルトで8880になります。ライセンスサーバーのアドレスをHeartCore Robo Desktopに渡す方法には、次の3つがあります。
このオプションが指定されていない場合、ファイルベースのライセンスキーはなく、サーバーは環境設定によって設定されません。ロボットは、ローカルマシンのデフォルトポートで実行されているサーバーを探します(localhost:8880)。

--cfg [file]
指定されたユーザー構成ファイルを、でデフォルトのものの代わりに使用します<user_home>/.tplanrobot/tplanrobot.cfg。このオプションを使用すると、単一の組織内で配布するための特定の構成で製品を再パッケージ化できます。v4.0以降でサポートされています。

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

引数のファイル名は、相対または絶対のいずれでもかまいません。相対パスが指定されると、HeartCore Robo Desktopのインストールフォルダに対して解決されます。

このオプションは、最後のセッションからオープンスクリプトを復元するデフォルトのHeartCore Robo Desktopの動作を上書きします。テストスクリプトがプロジェクトに属している場合、GUIは最近使用されたスクリプトの代わりにそのスクリプトを開きます。

--outputdir [path]
で作成されたスクリプトの出力パスを初期化します--createscript。このオプションは、の可変コマンドを作成し、'Var _REPORT_DIR=<path>'それをスクリプトに挿入します。場合は--createscript指定されていない場合、このオプションは無視されます。

注記: CLIから既存のテストスクリプトの出力パスを指定するには、-v/--variable オプションを使用して_REPORT_DIR変数を設定します。たとえば、-v "_REPORT_DIR=C:\reports" (HeartCore Robo Desktopが終了するまで)セッション全体の出力パスパスを指定されたパスパスに固定します。

--templatedir [path]
で作成されたスクリプトのテンプレートパスを初期化し--createscriptます。このオプションは変数を作成し、'Var _TEMPLATE_DIR=<path>' それをスクリプトに挿入します。場合は--createscript指定されていない場合、このオプションは無視されます。

注記: CLIから既存のテストスクリプトのテンプレートパスを指定するには、-v/--variableオプションを使用して_TEMPLATE_DIR変数を設定し ます。たとえば、-v "_TEMPLATE_DIR=C:\templates"(HeartCore Robo Desktopが終了するまで)セッション全体のテンプレートパスを指定されたパスに修正します。

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

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

--nologin
起動時にログインダイアログを表示せず、メインGUIに進みます。経由-cするスクリプトまたは経由するスクリプトによってデスクトップ接続が指定されていない場合-r、GUIはオフラインモードで起動し、ウェルカムパネルがオンになります。

--locale [locale]
指定されたロケール(言語)で製品を開始します。locale引数には、名前サフィックスインストールされている言語パックの一つのファイルに対応しなければなりません。これは必須の言語で構成されてISO-639 、任意に下線および国コード(続く2文字のコード、ISO-3166、さらに上のベンダーまたはブラウザで任意下線およびバリアント(続いてもよいし、2文字)特有のコード)。たとえば"--locale de"、ドイツ語でプログラムを開始しよう"--locale es_MX" としますが、メキシコスペイン語パックを探します。

要求された言語が利用できない場合、プログラムはデフォルトで英語になります。ログインダイアログを参照してください。 インストールされている言語パックのリストの言語コンポーネント。製品のローカリゼーションサポートについて詳しく知りたい場合は、HeartCore Robo Desktop 4.4のドキュメントのローカリゼーションインストラクションマニュアルをお読みください。

--license
HeartCore Robo Desktop 4.4のライセンスをコンソールに出力します。

使用例
./robot.sh --connect fox.robot.com:2
./robot.sh --connect fox.robot.com::5902
./robot.sh --connect rfb://fox.robot.com:5902
3つのコマンドはすべて同じで、ポート5902上のマシンfox.robot.com上で実行されているVNCサーバーに接続します。サーバが認証を必要としない場合、HeartCore Robo Desktop GUIが起動し、デスクトップデスクトップがデスクトップビューアに表示されます。サーバーにパスワードが必要な場合は、ログインダイアログが表示され、ユーザーは有効なパスワードを入力する必要があります。

./robot.sh --connect java://localhost
Javaネイティブクライアントを介して、ローカルシステムディスプレイ(画面や他の表示デバイスに表示されるデスクトップと同じデスクトップを意味します)に接続します。JavaやHeartCore Robo Desktop以外のソフトウェアは必要ありません。(エンタープライズ版のみ)

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

RMIを使用してJavaネイティブ・クライアントを介してIPアドレス192.168.1.1のホストのディスプレイに接続します。ホストマシンにはJavaがインストールされており、JavaサーバーモードでHeartCore Robo Desktopを実行している必要があります。詳細については、Javaクライアントのマニュアルを参照してください。(エンタープライズ版のみ)

./robot.sh -r self_connect.java
self_connect.java GUIモードでJavaテストスクリプトを実行します。このツールは内部的に.class形式にコンパイルして実行します。パスが指定されていないため、ファイルはHeartCore Robo Desktopのインストールフォルダに配置する必要があります。また、-c/--connect オプションが指定されていないため、スクリプトには独自の接続コードが含まれている必要があります。

test.txtHeartCore Robo Desktopのインストールフォルダに テストスクリプトがあります:

# 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;poi-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上で動作するVNCサーバーにポート5902で接続し、test.txtGUIモードで呼び出されるスクリプトの自動実行を開始します。認証が成功し、サーバーへの接続が確立されると、GUIが表示され、タイムアウトカウントダウンが開始されます。パラメータ-oはタイムアウト値を再定義するため、標準の15秒ではなく5秒間続きます。時間がなくなると、スクリプトの実行が開始されます。-vオプションでAPPLICATION変数を再定義すると、スクリプトはGNOMEターミナルウィンドウを起動し、スクリーンショットを作成します。その後、標準15秒のシャットダウンカウントダウンが開始されます。時間がなくなると、GUIが廃棄され、HeartCore Robo Desktopが終了します。

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 -o scripting.delayBeforeAutomaticExecutionSeconds=5 -v APPLICATION=gnome-terminal -n
このコマンドは、GUIが表示されず、HeartCore Robo Desktopが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
test.txt Javaネイティブクライアントを介してローカルデスクトップ上でテストスクリプトを実行します。ローカルマシンは、デスクトップソフトウェアを実行する必要はありません。自動化は、ローカルOSレベルのディスプレイにアクセスするJavaのネイティブインタフェースを介して行われます。これにより、テストスクリプト、HeartCore Robo Desktopインスタンス、およびJavaで構成された、再配置可能、自己完結型およびローカル実行可能なテストスイートを作成できます。この例のテストスクリプトは、もともとRFBサーバーで設計されていましたが、Javaを実行するための変更は必要ありません。(エンタープライズ版のみ)


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

T-Plan統合CLIオプションは、他のT-Plan製品、特にT-Plan Professional 7.0との統合をサポートするための既存の標準インターフェースの拡張です。詳細については、インテグレーションリファレンスドキュメントを参照してください。このインターフェースは-o/--option、でサポートされているユーザー設定オーバーライド・メカニズムを利用しているため、実際には標準インターフェースでは新しいオプションを定義しません。各オプションは一緒に使用する必要があります-oまたは--optionたとえば、"-o tplan.url=http://localhost:4000"

統合オプションは、HeartCore Robo Desktopに次のようなT-Planテスト管理データベースの統合タスクの1つを実行するように指示するように設計されています。
  1. T-Plan Professionalのスクリプトエンティティを自動スクリプトにインポートし、
  2. 自動化されたテスト結果をT-Planデータベースにエクスポートします。
共通のオプションとタスク固有のオプションがあります。

一般的な統合オプション

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

オプション名
説明
tplan.url SOA WebサービスURL(例: "http://tplandb.mycompany.com:4000")。HeartCore Robo DesktopとT-Planデータベースとの間のすべての通信は、通常データベースサーバ上のポート4000上で実行されるWebサービスを通じて実現されます。このパラメーターは、各統合タスクに必須です。
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コマンドの属性として追加されます。

エクスポートオプション

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

オプション名
説明
tplan.autoExport スクリプト実行後にテスト結果をエクスポートするかどうかを示すフラグ(通常は-r / - runオプションを使用)。このタスクを実行するには、値が「true」である必要があります。エクスポートタスクには必須です。
tplan.mode テスト結果のエクスポートモード。許容できる値は次のとおりです。
  • "create" はテスト結果をインポートするための新しいテストスイートを作成します。tplan.newSuiteNameこのモードと一緒に提供されなければなりません。tplan.suiteNumber オプションも指定されている場合、このパラメータで指定されたテストスイートは、新しいものの親として機能します。それ以外の場合、テストスイートはルート管理ノードのすぐ下に作成されます。
  • "rewrite" は、tplan.suiteNumberオプションで指定された既存のテストスイートのテスト結果を書き換えます。
  • "append"は、tplan.suiteNumber オプションで指定された既存のテストスイートにテスト結果を追加します。
tplan.suiteNumber テスト結果をエクスポートするためのテストスイート番号。パラメータは、tplan.mode オプションの値に応じて新しいテストスイートまたはターゲットテストスイートを識別します。
tplan.newSuiteName 新しいテストスイートの名前。このオプションは、エクスポート・モードが「作成」("tplan.mode=create")のときに指定する必要があります。それ以外の場合は無視されます。

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

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

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 welcome -r test.tpr -o tplan.url=http://localhost:4000 -o tplan.user=admin -o tplan.password=dbadmin -o tplan.database=testdb -o "tplan.group=System Administrators" -o tplan.autoExport=true -o tplan.mode=rewrite -o tplan.suiteNumber=111

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


T-Planロボットエンタープライズ4.4.2オフラインイメージ比較CLIオプション

シノプシス | オプション | 終了コード |

シノプシス
HeartCore Robo Desktop 4.4は、シンプルなCLIインターフェイスを使用してオフラインイメージの比較にも使用できます。これを実行するには、次のコマンドのいずれかを使用します。ラッパースクリプトは9つ以上のパラメーターを処理できないことに注意してください。より多くのパラメータを渡す必要がある場合、またはHeartCore Robo Desktopのstartコマンドをカスタマイズする必要がある場合は、javaでコマンドを使用します。

Unix / Linux:
./imgcompare.sh <source_image> <template_image> [options]
java -classpath robot.jar com.tplan.robot.ImageComparison <source_image> <template_image> [options]

MS Windows:
imgcompare.bat <source_image> <template_image> [options]
java -classpath robot.jar com.tplan.robot.ImageComparison <source_image> <template_image> [options]

HeartCore Robo Desktopで利用可能なすべての画像比較モジュールを呼び出すことができます。これには、プラグインAPIを介してツールにプラグインされたカスタムのものも含まれます。このCLIはユーザー設定も読み込み、デフォルトの比較方法(モジュール)、デフォルトの合格率値、「検索」 比較の検索ヒットの最大数など、GUIを使用してカスタマイズされたすべての画像比較設定を使用することに注意してください。

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

-c
簡潔なモード。'search'メソッドと共に使用すると、[x、y]形式で1行に1つの座標が正確に出力されます。この出力は言語に依存せず、フォーマットは将来のバージョンと言語の変異によって保存され、サードパーティのツールで解析するのに適しています。

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

-m [module]
使用する画像比較モジュール(メソッド)。HeartCore Robo Desktopは、ヒストグラムベースの比較ための「デフォルト と画像検索のための「検索」の 2つを定義します。イメージの比較の詳細については、Compareto コマンドの仕様およびHeartCore Robo Desktop ドキュメントとのイメージの比較を参照してください。Plugin APIを使用

してツールにプラグインされたカスタムモジュールも使用でき-mます。パラメータの値getMethodName()は、モジュールのメソッドによって再チューニングされた名前に対応する必要があります。

このオプションを省略すると、ユーザー設定のデフォルト値が使用されます。

-p [passrate]
合格率(%)。この値は、0と100の間の浮動小数点数でなければなりません。この値は、画像比較結果が「合格」(終了コード0)になるように、ソース画像とテンプレート画像がどれくらい一致しなければならないかを示します。

このオプションを省略すると、ユーザー設定のデフォルト値が使用されます。'デフォルト 'の方法(通常は95%)と'検索'(100%)の別々のデフォルトの合格率があることに注意してください。

-r [rectangle]
イメージの比較をソースイメージの特定の領域に制限します。これはむしろ、画像の一部のアイコンまたはサブ画像を検索する意味がある'検索'方法で使用することです。

値は、HeartCore Robo Desktopの矩形形式にする必要があります'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 画像の比較に失敗しました(「デフォルト」:合格率が満たされていない、「検索」:合格率が合致していない)
2 エラー:ソースイメージを読み込めませんでした。
3 エラー:テンプレート画像を読み込めませんでした。
4
入力引数に構文エラーがあります(エラーを説明するメッセージが出力されます)。
5 内部エラー - HeartCore Robo Desktopサポートに報告してください。

使用例
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
pattern.png ソースイメージの[0,20,120,320]矩形内のテンプレートイメージを検索しますimage.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ソース画像内のテンプレート画像の最初の99.9%一致の出現を検索しますimage.png。上記のコマンドは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.pngimage2.png、それらは、少なくとも99%一致する場合PASS(終了コード0)を返します。上記のコマンドはWindowsで有効です。Linux / Unixの場合、セミコロン ';' コロン ':'でクラスパスに追加します。