Static Image 接続
Static Image接続を使用すると、ファイルベースの画像をテストできます。用途:
-
画像ファイルを出力するシステム(スクリーンショット、データ可視化など)のテスト。
-
ライブ画像ファイル(継続的に更新されるもの)のテスト。
-
他の接続からの失敗した画像比較のデバッグ。例えば、Screenshotコマンドで撮影されたスクリーンショットや、Image Doctor機能によって自動的に保存された画像などが対象です。
接続:
-
Login Dialogから手動で接続するには、ドロップダウンでStatic Image接続タイプを選択し、画像ファイルのパスを指定します。
-
テストスクリプトから接続するには、Connectコマンド(TPRスクリプト)またはconnect()メソッド(Javaテストスクリプト)を使用します。引数のURLは、"file://<path>"のような標準的なファイルURLでなければなりません。このURLは、Robotの起動時に接続を確立するためにc/--connect CLIオプションと一緒に使用することもできます。例:
TPRテストスクリプト: Connect file://C:/Users/John/myscreenshot.png
Javaテストスクリプト: connect("file://C:/Users/John/myscreenshot.png");
この接続はデフォルトでキーイベントを拒否します。この接続に依存するTPRテストスクリプトは、Press、Type、Typelineの各コマンドで構文エラーを報告します。これは、静的イメージがキーイベントを一切消費しないことを明確にするための仕様です。この動作を抑制し、クライアント側でキーイベントを消費させたい(かつ黙って破棄させたい)場合は、クライアントの設定を参照してください。この接続は、画像ファイルのサイズと最終更新日時を一定間隔でチェックします。更新が検出されると、画像を再読み込みします。この仕組みにより、この接続はファイルシステム上の画像にグラフィカルな出力を生成するシステムをテストできます。この動作は接続のPreferencesで変更できます。高度なURL構文:
-
ZIPまたはJARファイルに格納された画像を読み込むには、"file://<archive_path>!/<image_path_in_archive>"のようなURLを使用します。例えば、"C:\testdata\images.jar"というJARファイル内の"examples"というフォルダに圧縮された"screen.png"という名前の画像を読み込む場合は、次のようにします:
Connect file://C:/testdata/images.jar!/examples/screen.png
-
相対パスは、Robotのインストールディレクトリを基準に解決されます。例えば、Robotのインストールフォルダにある"screen.png"という画像を読み込むには、次のようにします:
Connect file://screen.png
-
一般的な方法として、テスト画像をRobotのプロジェクトフォルダに配置します。この場合、プロジェクトの安全な移動やコピーを保証するために、Project path variablesを使用してURLを構成できます。例えば、プロジェクトディレクトリ内の"images"フォルダにある"screen.png"という画像に接続するには、次のようにします:
TPRテストスクリプト: Connect file://\{_PROJECT_DIR}/images/screen.png
Javaテストスクリプト: connect("file://" + getVariableAsString("_PROJECT_DIR") + "/images/screen.png");