★アクションの説明、概要
JobAutoでアプリ画面の要素を指定し、 キーボードのキー操作を送信する方法について説明します。
「【要素】キー送信」アクションでは、 アプリデザインで操作したい箇所を要素として認識し、 その要素に対してキーボードのキー操作を送信します。
Enter、Tab、矢印キーなどの単一キーのほか、 Ctrl+A、Ctrl+C、Ctrl+V、Ctrl+Xなどの キー操作を設定できます。
なお、使用しているキーボードの配列によっては、 Homeキーや矢印キーなどを送信したときに 意図したキーと異なる動作になる場合があります。 その場合は、Ctrlキーと組み合わせて送信することで 動作する場合があります。
★アクションの作成方法
★アクションの設定画面について
アクション設定画面の設定項目について説明します。「画面を読み込み」「操作対象にフォーカス」「背景色」については、アプリデザインの使い方をご確認ください。
１．基本設定
１－１．要素が見つかるまでのタイムアウト（秒）
設定した時間まで、選択した要素をロボットが探し続けます。
１－２．要素が最前面に表示されるまで待つ
設定した時間まで、選択した要素が最前面に表示されるまでロボットが処理を停止します。
・待つ
最前面に表示されるまで処理を停止します。
・待たない
最前面に表示されるまで処理を停止しません。
１－３．送るキーの設定
送信するキーを設定します。
一部のキーやキーの組み合わせは送信できません。たとえば、Shiftキーを押しながらCtrl＋Xを実行するような、3つ以上のキーを同時に押す操作には制限があります。
・＋
設定を追加します。
— down
キーボードの↓キーを送信します。
— up
キーボードの↑キーを送信します。
— left
キーボードの←キーを送信します。
— right
キーボードの→キーを送信します。
— tab
キーボードのTabキーを送信します。
— enter
キーボードのEnterキーを送信します。
— esc
キーボードのEscキーを送信します。
— space
キーボードのSpaceキーを送信します。
— backspace
キーボードのBackspaceキーを送信します。
— ctrl+a
キーボードのCtrl＋Aキーを送信します。
— ctrl+c
キーボードのCtrl＋Cキーを送信します。
— ctrl+v
キーボードのCtrl＋Vキーを送信します。
— ctrl+x
キーボードのCtrl＋Xキーを送信します。
— alt+f4
キーボードのAlt＋F4キーを送信します。
— オリジナル
「ここで実行したいキー操作を行ってください」をクリックして選択状態にし、送信したいキーを押します。
＃ここで実行したいキー操作を行ってください
・ ここで実行したいキー操作を行ってください
ここで実行したいキー操作を行ってくださいをクリックして、選択状態にします。そして送信したいキーを押します。
・ ー
選択したキー送信の操作を一覧から削除します。
・ ↑
キー送信の順番を1つ上へ移動します。
・ ↓
キー送信の順番を1つ下へ移動します。
— 変数
変数に格納された値をキーとして送信します。送信できるのは半角英数字と記号です。
— wait
キーを連続して送信する場合に、一定の待ち時間を設定できます。
・ー
設定を削除します。
・↑
キー送信順を１つ上にあげます。
・↓
キー送信順を１つ下にさげます。
１－４．対象の要素
操作対象として設定した要素の画像が表示されます。
２．高度な設定
２－１．アクション有効
このアクションを無効にする場合は、チェックを外します。
２－２．キャッシュクリア
処理速度を上げるため、取得した要素の情報を保持しています。保持している要素情報をクリアし、再取得する場合にチェックを入れます。アプリの画面表示が変化した後に実行する場合などに使用します。
２－３．要素をアクティブにする
要素をアクティブな状態にしてから実行する場合は、チェックを入れます。
２－４．名前
要素を名前で指定するときに設定します。名前には変数を使用できます。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。
名前の設定で要素を安定して特定できない場合は、 JobAutoの要素マッチングを安定させる方法｜名前に正規表現を使うも確認してください。
２－５．クラス
要素をクラスで指定するときに設定します。
２－６．タイプ
要素をタイプで指定するときに設定します。
タイプの設定で要素を安定して特定できない場合は、次のFAQも確認してください。
２－７．AID
要素をAIDで指定するときに設定します。AIDには変数を使用できます。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。
２－８．要素インデックス
名前・クラス・タイプ・AIDなどの設定だけでは操作対象を1つに絞り込めない場合に、何番目の要素を操作するか指定します。先頭の要素は「0」です。要素インデックスには変数を使用できます。変数の値が空の場合など、インデックスが空欄のときは自動的に「0」が使用されます。
３．エラー発生時の対応
３－１．エラー時の処理
エラーが発生したときの設定を行います。詳細はこちらをご確認ください。
３－２．基点となる条件分岐
エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。
３－３．エラー時にログ出力
エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。
「【要素】キー送信」でできること
「【要素】キー送信」では、 アプリデザインで指定した要素に対して、 キーボードのキー操作を送信できます。
EnterやTab、矢印キーなどの単一キーだけでなく、 Ctrl+A、Ctrl+C、Ctrl+Vなどの キーを組み合わせた操作も設定できます。
よく使用するキー操作
| 設定 | 送信するキー |
|---|---|
| down | ↓キー |
| up | ↑キー |
| left | ←キー |
| right | →キー |
| tab | Tabキー |
| enter | Enterキー |
| esc | Escキー |
| space | Spaceキー |
| backspace | Backspaceキー |
| ctrl+a | Ctrl＋A |
| ctrl+c | Ctrl＋C |
| ctrl+v | Ctrl＋V |
| ctrl+x | Ctrl＋X |
| alt+f4 | Alt＋F4 |
任意のキーを送信する
一覧に用意されているキー以外を送信する場合は、 「オリジナル」を使用します。
「ここで実行したいキー操作を行ってください」を選択した状態で、 実際に送信したいキーを押して設定します。
複数のキー操作を順番に実行する
キー送信は複数設定できます。
設定したキー操作は一覧に表示され、 上下に移動して送信する順番を変更できます。 不要なキー操作は一覧から削除できます。
キーとキーの間に待ち時間を入れる
キーを連続して送信するときに、 一定の時間を空けたい場合は「wait」を使用します。
複数のキー操作を続けて実行すると 対象アプリ側の処理が追いつかない場合などは、 キー操作の間にwaitを設定します。
変数に格納された値をキーとして送信する
「変数」を使用すると、 変数に格納されている値をキーとして送信できます。
変数から送信できる値は、 半角英数字と記号です。
「値入力」と「キー送信」の違い
「【要素】値入力」と「【要素】キー送信」は、 どちらもアプリの入力欄などに対して使用できますが、 役割が異なります。
| アクション | 用途 |
|---|---|
| 【要素】値入力 | 指定した要素へ値を入力するときに使用します。 |
| 【要素】キー送信 | Enter、Tab、Ctrl＋Vなどのキーボード操作を送信するときに使用します。 |
文字列や値そのものを入力する場合は「値入力」、 キーボード操作を実行したい場合は「キー送信」を使用します。
送信できないキー操作がある場合
キー送信では、 一部のキーやキーの組み合わせを送信できない場合があります。
たとえば、 Shiftキーを押しながらCtrl＋Xを実行するような、 3つ以上のキーを同時に押す操作には制限があります。
複雑なキー操作を設定する場合は、 実際に対象アプリで意図した動作になるか確認してください。
キーボード配列によって意図したキーが送信されない場合
使用しているPCのキーボード配列によっては、 Homeキーや矢印キーなどを送信したときに、 別のキーとして処理される場合があります。
その場合は、 Ctrlキーと組み合わせてキーを送信することで 動作する場合があります。
操作対象の要素が見つからない場合
「【要素】キー送信」では、 「要素が見つかるまでのタイムアウト（秒）」で設定した時間まで 操作対象の要素を探します。
対象要素の表示に時間がかかる場合は、 タイムアウト時間を確認してください。
また、 アプリ画面の表示が変わったあとに実行する場合は、 高度な設定の「キャッシュクリア」を確認してください。
キーが送信されない場合
キーが想定した要素へ送信されない場合は、 次の点を確認してください。
- JobAutoが操作対象のアプリへ正しく接続しているか
- アプリデザインで目的の要素を正しく指定できているか
- 対象要素が最前面に表示されているか
- 必要に応じて「要素をアクティブにする」を使用しているか
- 画面表示が変わった場合は「キャッシュクリア」が必要ではないか
- キーを連続送信する場合はwaitが必要ではないか
- 使用しているキーボード配列の影響を受けていないか
操作対象が正しく認識されているか確認する場合は、 アプリデザインの「操作対象にフォーカス」も使用してください。