JobAutoでアプリの要素に値を入力する方法

★アクションの説明、概要

JobAutoでアプリ画面の入力欄などを要素として指定し、値を入力する方法について説明します。

「【要素】値入力」アクションでは、アプリデザインで操作したい箇所を要素として認識し、指定した要素に対して値を入力します。

入力欄などを要素として認識できる場合に使用する、要素マッチングの値入力アクションです。

★アクションの作成方法

★アクションの設定画面について

アクション設定画面の設定項目について説明します。「画面を読み込み」「操作対象にフォーカス」「背景色」については、アプリデザインの使い方をご確認ください。

１．基本設定

１－１．要素が見つかるまでのタイムアウト（秒）

設定した時間まで、選択した要素をロボットが探し続けます。

１－２．要素が最前面に表示されるまで待つ

設定した時間まで、選択した要素が最前面に表示されるまでロボットが処理を停止します。

・待つ

最前面に表示されるまで処理を停止します。

・待たない

最前面に表示されるまで処理を停止しません。

１－３．入力前

値を入力する前に、入力対象の箇所をクリックするか設定します。基本的には「クリックする」を推奨します。

・クリックする

入力する前にクリックします。

・クリックしない

入力する前にクリックしません。

１－４．値入力

入力する値を設定します。入力する値には変数やシステム値を使用できます。システム値の説明はこちら。

１－５．入力方式

値を入力する方式を設定します。基本的には「クリップボードからCtrl+V」の使用を推奨します。

「直接入力」では、「~」（チルダ）はEnterキーとして扱われます。そのため、ファイル名などに「~」が含まれている場合、入力が途中で終了することがあります。
「~」を入力する可能性がある場合は、「クリップボードからCtrl+V」を使用してください。

・直接入力

キーボードを使って値を入力する方法です。入力する値が小文字の場合、キーボードがCaps Lockの状態でも小文字で入力されます。

・クリップボードからCtrl+V

コピーした値を貼り付ける入力方法です。

１－６．入力後

値を入力した後に、Enterキーを押すか設定します。

・入力する

値を入力後にエンターキーを押します。

・入力しない

値を入力後にエンターキーを押しません。

１－７．行間の待ち時間

値を連続して入力する場合に、値を入力する間隔を設定します。

１－８．対象の要素

操作対象として設定した要素の画像が表示されます。

２．高度な設定

２－１．アクション有効

このアクションを無効にする場合は、チェックを外します。

２－２．キャッシュクリア

JobAutoは処理速度を上げるため、取得した要素の情報を保持しています。保持している要素情報をクリアし、再取得する場合にチェックを入れます。アプリの画面表示が変化した後に実行する場合などに使用します。

２－３．要素をアクティブにする

要素をアクティブな状態にしてから実行する場合は、チェックを入れます。

２－４．名前

要素を名前で指定するときに設定します。名前には変数を使用できます。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。

名前の設定で要素を安定して特定できない場合は、 JobAutoの要素マッチングを安定させる方法｜名前に正規表現を使うも確認してください。

２－５．クラス

要素をクラスで指定するときに設定します。

２－６．タイプ

要素をタイプで指定するときに設定します。
タイプの設定で要素を安定して特定できない場合は、次のFAQも確認してください。

２－７．AID

要素をAIDで指定するときに設定します。AIDには変数を使用できます。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。

２－８．要素インデックス

名前・クラス・タイプ・AIDなどの設定だけでは操作対象を1つに絞り込めない場合に、何番目の要素を操作するか指定します。先頭の要素は「0」です。要素インデックスには変数を使用できます。変数の値が空の場合など、インデックスが空欄のときは自動的に「0」が使用されます。

３．エラー発生時の対応

３－１．エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

３－２．基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

３－３．エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。

要素マッチングでアプリに値を入力する

「【要素】値入力」では、アプリ内の入力欄などを要素として認識し、認識した要素へ値を入力します。

操作したい入力欄を要素として認識できる場合は、要素マッチングによる値入力を使用します。

値入力が空振りする場合

アプリ操作の値入力では、実行時に値が入力されず、空振りする場合があります。

値を入力するときに入力箇所からカーソルが外れた状態になると、値入力が空振りする場合があると案内されています。

入力されたか確認してから後続処理へ進む

値入力の空振りに備える場合は、値入力後に「【要素】値取得」を使って実際に入力された値を取得し、想定した値が入力されているか確認する方法があります。

入力されていない場合は、条件分岐などを使って値入力を再実行するフローを作成できます。

後続処理でエラーになった場合に再入力する

値が入力されていないことによって後続のアクションでエラーが発生する場合は、値入力の直前へ戻り、再度入力を行う方法もあります。

値入力の直前にブックマークを作成し、後続処理でエラーになった場合にそのブックマークへ戻って再入力する方法が案内されています。

操作対象を正しく認識しているか確認する

想定した入力欄へ値が入力されない場合は、 JobAutoが操作対象の要素を正しく認識しているか確認してください。

アプリデザインの「操作対象にフォーカス」を使用すると、設定した操作対象をJobAutoが正しく認識しているか確認できます。

また、接続中のアプリ画面とアプリデザインに表示されている画面が異なる場合は、「画像を読込み」で画面を更新してから確認してください。

要素が見つかるまでに時間がかかる場合

「【要素】値入力」は、アプリ操作のタイムアウト時間を設定できる対象アクションです。

アプリや入力欄の表示に時間がかかり、対象要素を見つけられない場合は、アプリ操作のタイムアウト設定も確認してください。

要素マッチングで値入力できない場合

「【要素】値入力」で想定した入力ができない場合は、次の点を確認してください。

操作対象となるアプリへ正しく接続しているか
アプリデザインに最新の画面が表示されているか
「操作対象にフォーカス」で目的の入力欄を認識できているか
値入力後に「【要素】値取得」で入力結果を確認できるか
アプリの表示に時間がかかる場合はタイムアウト設定が適切か

要素として入力欄を認識できない場合は、対象画面に応じて画像マッチングによる値入力なども検討してください。