★アクションの説明、概要
JobAutoでアプリ画面の要素を指定し、
その部分のスクリーンショットを取得して保存する方法について説明します。
「【要素】キャプチャー」アクションでは、
アプリデザインでキャプチャーしたい箇所を要素として認識し、
指定した要素のスクリーンショットをファイルへ保存します。
保存先のファイルパスには、
変数やシステム値を使用できます。
★アクションの作成方法
★アクションの設定画面について
アクション設定画面の設定項目について説明します。「画面を読み込み」「操作対象にフォーカス」「背景色」については、アプリデザインの使い方をご確認ください。
1.基本設定
1-1.要素が見つかるまでのタイムアウト(秒)
設定した時間まで、選択した要素をロボットが探し続けます。
1-2.保存先
キャプチャー画像を保存するファイルパスを設定します。保存先には変数やシステム値を使用できます。システム値の説明はこちら。
1-3.対象の要素
操作対象として設定した要素の画像が表示されます。
2.高度な設定
2-1.アクション有効
このアクションを無効にする場合は、チェックを外します。
2-2.キャッシュクリア
処理速度を上げるため、取得した要素の情報を保持しています。保持している要素情報をクリアし、再取得する場合にチェックを入れます。アプリの画面表示が変化した後に実行する場合などに使用します。
2-3.要素をアクティブにする
要素をアクティブな状態にしてから実行する場合は、チェックを入れます。
2-4.名前
要素を名前で指定するときに設定します。名前には変数を使用できます。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。
名前の設定で要素を安定して特定できない場合は、 JobAutoの要素マッチングを安定させる方法|名前に正規表現を使うも確認してください。
2-5.クラス
要素をクラスで指定するときに設定します。
2-6.タイプ
要素をタイプで指定するときに設定します。
タイプの設定で要素を安定して特定できない場合は、次のFAQも確認してください。
2-7.AID
要素をAIDで指定するときに設定します。AIDには変数を使用できます。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。
2-8.要素インデックス
名前・クラス・タイプ・AIDなどの設定だけでは操作対象を1つに絞り込めない場合に、何番目の要素を操作するか指定します。先頭の要素は「0」です。要素インデックスには変数を使用できます。変数の値が空の場合など、インデックスが空欄のときは自動的に「0」が使用されます。
3.エラー発生時の対応
3-1.エラー時の処理
エラーが発生したときの設定を行います。詳細はこちらをご確認ください。
3-2.基点となる条件分岐
エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。
3-3.エラー時にログ出力
エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。
アプリ画面の指定した要素をキャプチャーする
「【要素】キャプチャー」では、 アプリ画面全体ではなく、 アプリデザインで指定した要素のスクリーンショットを取得して保存します。
アプリ内の特定の表示箇所や、 確認したい部分だけを画像として保存したい場合に使用します。
キャプチャー画像の保存先を指定する
「保存先」には、 キャプチャーを保存するファイルパスを設定します。
保存先は変数参照できます。 また、システム値を使用することもできます。
処理内容に応じて保存先を変更したい場合は、 変数やシステム値を利用してファイルパスを設定します。
キャプチャーする要素を確認する
アクション設定画面の「対象の要素」には、 操作対象として設定した要素の画像が表示されます。
想定している箇所がキャプチャーされない場合は、 まず対象の要素が正しく設定されているか確認してください。
操作対象を正しく認識しているか確認する
別の箇所がキャプチャーされる場合や、 対象要素を見つけられない場合は、 JobAutoが目的の要素を正しく認識しているか確認します。
アプリデザインの「操作対象にフォーカス」を使用すると、 現在の設定でどの要素が操作対象になっているか確認できます。
画面が変化したあとにキャプチャーする場合
JobAutoは処理速度を上げるため、 要素の情報を保持しています。
アプリの画面表示が変化したあとにキャプチャーを行う場合は、 高度な設定の「キャッシュクリア」を使用して、 要素情報を再取得してください。
同じ条件の要素が複数ある場合
「名前」「クラス」「タイプ」「AID」などの設定だけでは 操作対象を1つに絞り込めない場合は、 「要素インデックス」で対象を指定します。
要素インデックスは0から始まるため、 1番目の要素を指定する場合は「0」を設定します。
対象要素が見つからない場合
「【要素】キャプチャー」では、 「要素が見つかるまでのタイムアウト(秒)」で設定した時間まで 対象の要素を探します。
アプリや対象要素の表示に時間がかかる場合は、 タイムアウト時間も確認してください。
キャプチャーがうまくいかない場合
想定した箇所をキャプチャーできない場合は、 次の点を確認してください。
- 操作対象となるアプリへ正しく接続しているか
- アプリデザインに最新の画面が表示されているか
- 「対象の要素」に目的の要素が設定されているか
- 「操作対象にフォーカス」で目的の要素を認識できているか
- 画面が変化した場合は「キャッシュクリア」が必要ではないか
- 複数の要素が見つかる場合は要素インデックスが適切か
- 対象要素の表示に時間がかかる場合はタイムアウト時間が適切か
関連するアプリ操作・FAQ