- 概要
- UI Automation
- UI Automation アクティビティ パッケージについて
- UI Automation を使用して自動化されるアプリケーションと技術
- プロジェクトの対応 OS
- UI-ANA-016 - [ブラウザーを開く] に使用されている URL を検出
- UI-ANA-017 - [エラー発生時に実行を継続] の値が True
- UI-ANA-018 - OCR/画像関連のアクティビティのリスト
- UI-DBP-006 - コンテナーの使用
- UI-DBP-013 - Excel の自動化方法の誤用
- UI-DBP-030 - セレクター内での変数の使用禁止
- UI-DBP-031 - アクティビティの検証
- UI-PRR-001 - クリックをシミュレート
- UI-PRR-002 - 入力をシミュレート
- UI-PRR-003 - [アプリケーションを開く] の誤用
- UI-PRR-004 - ハードコードされた待機時間
- UI-REL-001 - セレクター内の大きいインデックス値
- UI-SEC-004 - メール アドレスのデータを含むセレクター
- UI-SEC-010 - アプリ/URL の制限
- UI-USG-011 - 許可されていない属性
- UX-SEC-010 - アプリ/URL の制限
- UX-DBP-029 - セキュリティで保護されていないパスワードの使用
- UI-PST-001 - [プロジェクト設定] の監査ログ レベル
- UiPath ブラウザー移行ツール
- クリッピング領域
- Computer Vision レコーダー
- Remote UI Automation design (Live authoring)
- アクティビティの索引
- アクティベート
- アンカー ベース
- ブラウザーにアタッチ
- ウィンドウにアタッチ
- ユーザー入力をブロック
- 吹き出し
- チェック
- クリック
- 画像をクリック
- 画像クリック トリガー
- OCR で検出したテキストをクリック
- テキストをクリック
- クリック トリガー
- アプリケーションを閉じる
- タブを閉じる
- ウィンドウを閉じる
- コンテキスト対応のアンカー
- 選択されたテキストをコピー
- 要素属性変更トリガー
- 要素の存在を確認
- 要素スコープ
- 要素ステート変更トリガー
- UI ツリーをエクスポート
- 構造化データを抽出
- 子要素を探す
- 要素を探す
- 画像を探す
- 一致する画像を探す
- OCR でテキスト位置を探す
- 相対要素を探す
- テキスト位置を探す
- アクティブ ウィンドウを取得
- 親要素を取得
- 属性を取得
- イベント情報を取得
- クリップボードから取得
- フル テキストを取得
- OCR でテキストを取得
- パスワードを取得
- 位置を取得
- ソース要素を取得
- テキストを取得
- 表示中のテキストを取得
- 前に戻る
- 次に進む
- ホームに移動
- Google Cloud Vision OCR
- ウィンドウを隠す
- 強調表示
- ホットキー トリガー
- ホバー
- 画像上でホバー
- OCR で検出したテキスト上でホバー
- テキスト上でホバー
- 画像の存在を確認
- 画面上で指定
- .NET コードを挿入
- JS スクリプトを挿入
- ActiveX メソッドを呼び出し
- キー操作トリガー
- 画像を読み込み
- ウィンドウを最大化
- Microsoft Azure ComputerVision OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- ウィンドウを最小化
- イベントを監視
- マウス トリガー
- ウィンドウを移動
- URL に移動
- OCR でテキストの存在を確認
- 要素が出現したとき
- 要素が消滅したとき
- 画像が出現したとき
- 画像が消滅したとき
- アプリケーションを開く
- ブラウザーを開く
- ブラウザーを更新
- ユーザー イベントを再生
- ウィンドウを復元
- 画像を保存
- 項目を選択
- 複数の項目を選択
- ホットキーを押下
- クリッピング領域を設定
- フォーカスを設定
- テキストを設定
- クリップボードに設定
- Web 属性を設定
- ウィンドウを表示
- プロセスを開始
- システム トリガー
- スクリーンショットを作成
- Tesseract OCR
- テキストの存在を確認
- ツールチップ
- 文字を入力
- SecureString で文字を入力
- フォアグラウンドを使用
- 属性を待つ
- 要素の消滅を待つ
- 画像の消滅を待つ
- アクセシビリティ チェック
- アプリケーション イベント トリガー
- ユーザー入力をブロック
- チェック/チェック解除
- アプリのステートを確認
- 要素を確認
- クリック
- クリック イベント トリガー
- ドラッグ アンド ドロップ
- 要素スコープ
- 表データを抽出
- 要素を探す
- 繰り返し (各 UI 要素)
- ブラウザーのデータを取得
- クリップボードを取得
- テキストを取得
- URL を取得
- URL に移動
- ステータス ウィンドウを非表示
- 強調表示
- ホバー
- JS スクリプトを挿入
- キーボード ショートカット
- キー押下イベント トリガー
- マウス スクロール
- ブラウザー内を移動
- 画像を保存
- 項目を選択
- ブラウザーのデータを設定
- クリップボードに設定
- CV サーバを設定
- ランタイム ブラウザーを設定
- フォーカスを設定
- プロジェクト設定を行う
- テキストを設定
- ステータス メッセージを表示
- ステータス ウィンドウを表示
- スクリーンショットを作成
- 文字を入力
- ユーザー入力のブロックを解除
- ウィンドウ操作
- UI Automation API を使用してブラウザー検索を実行し、結果を取得する
- Web の閲覧
- 画像を検索する
- 画像をクリックする
- イベントをトリガーおよび監視する
- ファイルを作成して上書きする
- HTML ページ: 情報を抽出して操作する
- ウィンドウの操作
- リスト項目の選択の自動化
- ウィンドウ要素を探して操作する
- テキスト操作の自動化を行う
- 画像を読み込んで処理する
- マウスでアクティブ化する操作を管理する
- アプリケーションランタイムの操作を自動化する
- ローカル アプリケーションの自動実行
- ブラウザーのナビゲーション
- Web オートメーション
- トリガー スコープの例
- DevExpress での UI Automation の有効化
- Computer Vision Local Server
- モバイル オートメーション
- ターミナル
キーボード ショートカット
UI 要素に 1 つ以上のキーボード ショートカットを送信する [キーボード ショートカット] アクティビティ。
UiPath.UIAutomationNext.Activities.NKeyboardShortcuts
説明
UI 要素に 1 つ以上のキーボード ショートカットを送信します。
このアクティビティは [アプリケーション/ブラウザーを使用] アクティビティに追加する必要があります。
このアクティビティを [アプリケーション/ブラウザーを使用] アクティビティの外で使用するには、 入力要素を指定する必要があります。
このアクティビティはオブジェクト リポジトリに対応しています。
このアクティビティの性質上、バックグラウンド モードで使用することはできません。
このアクティビティの使い方については、「 チュートリアル: Excel データを使用して Acrobat Reader の PDF フォームに入力する」をご覧ください。
プロジェクトの対応 OS
Windows - レガシ | Windows | クロスプラットフォーム
Windows、クロスプラットフォームでの設定
-
作業スコープ - 入れ子になった [アプリケーション/ブラウザーを使用] アクティビティ内にアクティビティが配置されている場合に、自動化するアプリケーションをホストするブラウザー タブまたはアプリケーション ウィンドウを選択します。
-
キーボード ショートカットの対象範囲 - キーボード ショートカットを [メイン ウィンドウ] または [要素] に送信します。既定のオプションは [メイン ウィンドウ] です。
-
Indicate on screen - Indicate the UI element to use as target. This option is only available when the Element option is selected as the Keyboard shortcuts container. After you indicate the target, select the hamburger menu next to the informative screenshot to access the following options:
- ターゲットを指定 - ターゲットをもう一度指定します。記述子がオブジェクト リポジトリで定義されている場合、現在のアクティビティに対してのみ記述子を指定するには、まずオブジェクト リポジトリからのリンクを解除する必要があります。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- 参考スクリーンショットを変更 - 対象のアプリケーションまたは Web ページのスクリーンショットを変更します。
- オブジェクト リポジトリに追加 - オブジェクト リポジトリに現在の UI 要素を追加します。その要素は、オートメーション プロセス全体で再利用できます。このオプションは、オブジェクトがまだオブジェクト リポジトリに追加されていない場合にのみ表示されます。
- オブジェクト リポジトリに表示 - 記述子を選択した状態で [オブジェクト リポジトリ] パネルを開きます。このオプションは、オブジェクトがオブジェクト リポジトリに追加されている場合にのみ表示されます。
- オブジェクト リポジトリへのリンクを解除 - オブジェクト リポジトリへの記述子のリンクを解除します。このオプションは、オブジェクトがオブジェクト リポジトリに追加されている場合にのみ表示されます。
-
ショートカットを記録 - このオプションをクリックした後、ターゲット要素に送信するキーの組み合わせをキーボード上で押します。記録されたショートカットが、アクティビティの [キーの組み合わせを送信] テキスト ボックスに表示されます。ショートカットを記録した後、以下の操作を行います。
- 他のショートカットを 1 つずつ追加する。ショートカットは、送信された順に [キーの組み合わせを送信] テキスト ボックスに表示されます。
- 記録を停止するために、任意の場所をクリックする。
- 追加したショートカットを削除するために、対応する [削除] ボタンをクリックする。
-
キーの組み合わせを送信 - アクティビティのアクションと組み合わせて使用するキー修飾子を 1 つ以上追加します。使用できるオプションは、[Alt]、[Ctrl]、[Shift] です。
-
検証 - アクティビティの実行検証手順を定義します。 次のオプションが利用できます。
- なし - ターゲット要素の検証は実行されません。
- 要素の出現 - 要素が出現するかどうかを確認します。
- 要素の消滅 - 要素が消滅するかどうかを確認します。
- 要素のテキストの変更 - 要素のテキストに変化があるかどうかを確認します。
- 要素の表示の変更 (Windows プロジェクトでのみ利用可能) - 要素の画像に変更があるかどうかを確認します。
-
すべてのアプリで指定 - メイン アクティビティのターゲットと同じ [アプリケーション/ブラウザーを使用] アプリケーションに属していない UI 要素を指定できます。このプロパティは、[検証] プロパティが [要素の出現]、[要素の消滅]、[要素のテキストの変更]、または [要素の表示の変更] のいずれかのオプションに設定されている場合にのみ利用できます。
-
Indicate on screen - Indicate the verification UI element to use as target. After you indicate the target, select the hamburger menu next to the informative screenshot to access the following options:
- ターゲットを指定 - ターゲットをもう一度指定します。記述子がオブジェクト リポジトリで定義されている場合、現在のアクティビティに対してのみ記述子を指定するには、まずオブジェクト リポジトリからのリンクを解除する必要があります。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- 参考スクリーンショットを変更 - 対象のアプリケーションまたは Web ページのスクリーンショットを変更します。
- オブジェクト リポジトリに追加 - オブジェクト リポジトリに現在の UI 要素を追加します。その要素は、オートメーション プロセス全体で再利用できます。このオプションは、オブジェクトがまだオブジェクト リポジトリに追加されていない場合にのみ表示されます。
- オブジェクト リポジトリに表示 - 記述子を選択した状態で [オブジェクト リポジトリ] パネルを開きます。このオプションは、オブジェクトがオブジェクト リポジトリに追加されている場合にのみ表示されます。
- オブジェクト リポジトリへのリンクを解除 - オブジェクト リポジトリへの記述子のリンクを解除します。このオプションは、オブジェクトがオブジェクト リポジトリに追加されている場合にのみ表示されます。
プロパティ パネル
ターゲット
このセクションは、[キーボード ショートカットの対象範囲] として [要素] オプションが選択されている場合にのみ使用できます。
-
ターゲットのプロパティを展開/ターゲットのプロパティを折りたたみ - ターゲット コンテナーとそのアンカーのプロパティを表示/非表示にします。
-
ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティは任意の組み合わせに設定でき、少なくとも 1 つのターゲット メソッドを選択する必要があります。
- 厳密セレクター
- あいまいセレクター
- 画像 (Windows プロジェクトでのみ利用可能)
- ネイティブ テキスト (Windows プロジェクトでのみ利用可能)
- Computer Vision
- セマンティック セレクター
-
Window selector (Application instance) - The selector that is used for the application window. Only applicable when the window attach mode is set to Application instance.
-
厳密セレクター - UI 要素に対して生成される厳密セレクターです。ターゲット メソッドとして [厳密セレクター] が選択されている場合にのみ表示されます。
-
あいまいセレクター - あいまいセレクターのパラメーターです。ターゲット メソッドとして [あいまいセレクター] が選択されている場合にのみ表示されます。
-
画像 - 以下のプロパティは、ターゲット メソッドとして [画像] 選択されている場合にのみ使用できます。
- 画像の精度 - 画像マッチングに使用する信頼度のしきい値を指定します。既定値は 0.8 です。
- 画像の出現 - 一致する画像が複数見つかった場合にどの一致を使用するかを指定します。
-
ネイティブ - 以下のプロパティは、ターゲット メソッドとして [ネイティブ] が選択されている場合にのみ使用できます。
- ネイティブ テキスト - UI 要素の識別に使用されるテキストを指定します。
- ネイティブ テキストの出現 - 複数の一致が見つかった場合にどの出現を使用するかを指定します。
- ネイティブ テキストの大文字と小文字を区別 - テキストの一致で大文字と小文字が区別されるかどうかを指定します。
-
Computer Vision - These properties are available only when the Computer Vision targeting method is selected. To use Computer Vision as a targeting method, you need to go to Project Settings > Computer Vision and make sure to set the correct server endpoint.
- CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
- CV テキスト - Computer Vision で識別するテキストを指定します。
- CV テキストの精度 - OCR のテキストの一致に使用する信頼度のしきい値を指定します。既定値は 0.7 です。
- CV Text occurrence - Specifies which occurrence to use when multiple matches are found.
-
Semantic selector - A semantic description that defines the target. This property is available only when the Semantic selector targeting method has been selected.
- Semantic selector method - Specifies the method used to detect elements on screen.
- Legacy - For desktop apps: Searches the elements found by the Computer Vision on screen. For web apps: Searches the elements available in the DOM. This method is deprecated.
- DOM - Searches the DOM. Reaches any element, including off-screen. Less precise on visual details. Not available on non-web applications.
- Image - Searches the screen image. Detects any object on the screen, including icons, colors, and styles. Limited to what's visible.
- Semantic selector model - Indicates the underlying LLM model used for semantic processing. This value is read-only. It can be changed only from Project settings > UI Automation > Semantic Selector > Legacy - Model / DOM - Model / Image - Model.
- Semantic selector method - Specifies the method used to detect elements on screen.
-
Wait for page load - Before performing the action, waits for the application to become ready to accept input. You can choose one of three options from the drop-down menu:
- なし - ターゲットの準備ができるまで待機しません。
- 対話型 - アプリの一部のみが読み込まれるまで待機します。
- 完了 - アプリ全体が読み込まれるまで待機します。
-
可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
- なし - 可視性を確認しません。
- 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
- 完全に表示されている - UI 要素が表示されるかどうかを確認します。
-
レスポンシブ Web サイト - レスポンシブ Web サイトのレイアウトを可能にします。
ターゲット - アンカー (n)
- ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティは任意の組み合わせに設定でき、少なくとも 1 つのターゲット メソッドを選択する必要があります。
- 厳密セレクター
- あいまいセレクター
- 画像 (Windows プロジェクトでのみ利用可能)
- ネイティブ テキスト (Windows プロジェクトでのみ利用可能)
- Computer Vision
- 厳密セレクター - UI 要素に対して生成される厳密セレクターです。ターゲット メソッドとして [厳密セレクター] が選択されている場合にのみ表示されます。
- あいまいセレクター - あいまいセレクターのパラメーターです。ターゲット メソッドとして [あいまいセレクター] が選択されている場合にのみ表示されます。
- 画像 - 以下のプロパティは、ターゲット メソッドとして [画像] 選択されている場合にのみ使用できます。
- 画像の精度 - 画像マッチングに使用する信頼度のしきい値を指定します。既定値は 0.8 です。
- 画像の出現 - 一致する画像が複数見つかった場合にどの一致を使用するかを指定します。
- ネイティブ - 以下のプロパティは、ターゲット メソッドとして [ネイティブ] が選択されている場合にのみ使用できます。
- ネイティブ テキスト - UI 要素の識別に使用されるテキストを指定します。
- ネイティブ テキストの出現 - 複数の一致が見つかった場合にどの出現を使用するかを指定します。
- ネイティブ テキストの大文字と小文字を区別 - テキストの一致で大文字と小文字が区別されるかどうかを指定します。
- Computer Vision - これらのプロパティは、ターゲット メソッドとして [Computer Vision] が選択されている場合にのみ使用できます。
- CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
- CV テキスト - Computer Vision で識別するテキストを指定します。
- CV テキストの精度 - OCR のテキストの一致に使用する信頼度のしきい値を指定します。既定値は 0.7 です。
- CV Text occurrence - Specifies which occurrence to use when multiple matches are found.
ターゲット - オフセット ポイント
Specifies an offset, which can be further configured.
- Anchoring point - Describes the starting point of the cursor to which it offsets from Offset X and Offset Y properties are added. The following options are available: Top left, Top right, Bottom left, Bottom right, and Center (selected by default).
- X のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から水平方向にずらす距離を指定します。このフィールドは、Int32 型変数のみをサポートします。
- Y のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から垂直方向にずらす距離を指定します。このフィールドは、Int32 型変数のみをサポートします。
実行を検証
- リトライ - オンにすると、期待される結果が達成されない場合は、アクティビティのタイムアウトまでの期間、アクションがリトライされます。
- タイムアウト - 検証対象の要素が出現、消滅、または変化するまで待機する時間 (秒) です。[リトライ] オプションを選択すると、アクションが再度実行された後、アクティビティの [タイムアウト] プロパティで指定した時間の間、検証が行われます。既定値は 10 秒です。
実行を検証 - ターゲット
- Target from any application - Indicates that the selected verification target does not necessarily belong to the same application, and it is also searched in other applications.
- [実行を検証ターゲットのプロパティを展開/ターゲットのプロパティを折りたたみ] ボタン - [実行を検証] のターゲット コンテナーとそのアンカーのプロパティを表示/非表示にします。
- [ターゲット] の同じプロパティが [実行を検証 - ターゲット] にも適用されます。
オプション
- Click before typing - Selects the type of click to execute in the specified UI element before sending the shortcut. The options are None (do not click), Single (execute a single click), or Double (execute a double click). The default option is None.
- Activate - If selected, the specified UI element is brought to the foreground and activated before sending the shortcut. If not selected, the activity sends the shortcut to the current active window. This field only supports Boolean values (True, False). The default value is True.
- Delay between keys - Delay (in seconds) between consecutive keystrokes. The default value is 0.1 seconds. The maximum value is 1 second.
- ショートカット キー入力間の待機時間 - 2 つの連続するキーボード ショートカット間の待機時間 (秒単位) です。既定値は 0.5 秒です。
- Input mode - Selects which method the Robot should use to interact with the target application:
- アプリ/ブラウザーと同一 - [アプリケーション/ブラウザーを使用] アクティビティと同じ入力モードを使用します。
- ハードウェア イベント - マウスの動きやキーボード ストロークなどの「ハードウェア」の入力を使用してアプリケーションを操作することにより、実際のユーザーとして動作します。これらは、オペレーティング システムに直接送信されるハードウェアによってトリガーされるイベントです。このメソッドでは動作が 100% 模倣されますが、まれに一部のイベントが失われる場合があります。開発者には、すべてのイベントが対象のアプリケーションに確実に到達するようにする責任があります。
- Simulate - Simulates using accessibility APIs. Recommended for browsers, Java based applications, SAP. More reliable than Hardware Events for most browser and desktop apps. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
- Chromium API - Performs actions using debugger APIs. Works for Chrome and Edge elements only. Sends all text in one go. Works if the target app is not in focus. For more details, refer to Chromium API.
- Window Messages (Windows only) - Simulates using Win32 messages. Recommended for desktop apps. More reliable than Hardware Events for most browser and desktop apps. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
- Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
- アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
- ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
- 無効化 - このアクティビティの Healing Agent をオフにします。
- 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
- エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。 既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
オプション - オフセット ポイント
- オフセット ポイントを有効化 - オフセット ポイントをアクティビティ レベルで有効化するかどうかを指定します。有効化すると、ターゲット上に設定されているオフセット ポイントよりも優先されます。
- Anchoring point - Specifies the reference point of the cursor from which the Offset X and Offset Y values are applied. The following options are available: Top left, Top right, Bottom left, Bottom right, and Center (selected by default).
- X のオフセット - カーソルの位置を、選択したアンカー ポイントを基準として水平方向にずらす距離を定義します。
- Y のオフセット - カーソルの位置を、選択したアンカー ポイントを基準として垂直方向にずらす距離を定義します。
タイミング
- 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
- 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
- Timeout - Specifies the amount of time (in seconds) to wait for the operation to be performed before generating an error. The default value is 30 seconds.
入力/出力
- 入力要素 - アクティビティの実行対象となる UI 要素で、
UIElementオブジェクトに保存されます。このフィールドではUIElementオブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティ フィールドから取得できます。 - Output element - Outputs a target UI Element and stores it in a
UIElementobject, which can be further used to target the same element with other UI Automation activities.
Windows - レガシでの設定
- [アプリ/ブラウザーで指定] を選択して、ターゲットとして使用する UI 要素を指定します。 ターゲット要素を指定しない場合、ショートカットは親アプリケーション/ブラウザーに送信されます。
ターゲットを指定したら、メニュー
ボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 検証を追加/検証を削除 - アクティビティ カードの [画面上で検証ターゲットを指定] 機能を追加または削除します。検証の実行は既定で有効化されています。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。
- ショートカットを記録 - このオプションをクリックした後、ターゲット要素に送信するキーの組み合わせをキーボード上で押します。アクティビティの本体に、記録されたショートカットが表示されます。 ショートカットを記録した後、以下の操作を行います。
- さらにショートカットを追加するには、[ショートカットを記録] を再びクリックして、キーボード上の目的のキー (複数可) を押します。ショートカットは、アクティビティの本体に表示される順序で送信されます。
- 記録されたショートカットの送信順序を変更するには、アクティビティの本体で、記録されたキーをドラッグ アンド ドロップして位置を変更します。
- 追加したショートカットを削除するには、[削除] をクリックします
。
- キーの組み合わせを送信 - 送信するキーボード ショートカットです。
- 画面上で検証ターゲットを指定 - ターゲットとして使用し、操作の実行後に表示または非表示にする必要のある UI 要素を指定します。この機能は、アクティビティによって実行される特定の操作が実行時に正しく実行されたことを確認する場合に使用します。この機能は特に、自動化されたプロセスで、ある操作の結果として特定の UI 要素が表示されたか、または表示されなくなったかを確認する必要がある場合に便利です。プロセスが期待どおりに実行されていることを確認するための検証レイヤーを追加できます。オートメーション プロセスが特定の手順が正しく実行されることに依存している場合は、実行を検証することをお勧めします。この機能は [プロジェクト設定] で鵜有効化するか、アクティビティの本体で [検証を追加] を選択して有効化できます。
プロパティ パネル
共通
-
エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。 既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
-
実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
-
実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
-
[示名 - デザイナー パネルに表示される、アクティビティの名前です。 ターゲットを指定すると、表示名が自動的に生成されます。
-
Timeout - Specifies the amount of time (in seconds) to wait for the activity to be executed before throwing an error. The default value is 30 seconds.
-
ショートカット - 送信するキーボード ショートカットです。このフィールドでは、文字列と
String型の変数がサポートされています。 -
ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面上で指定する前は、このフィールドは
(null)に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。- クリックのオフセット - [クリック] アクティビティのオフセットを詳細に設定できます。
- Anchoring point - Describes the starting point of the cursor to which it offsets from Offset X and Offset Y properties are added. The following options are available: Top left, Top right, Bottom left, Bottom right, and Center. By default, Center is selected.
- X のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から水平方向にずらす距離を指定します。 このフィールドでは
Int32型の変数のみがサポートされています。 - Y のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から垂直方向にずらす距離を指定します。このフィールドでは
Int32型の変数のみがサポートされています。
- CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
- CV テキスト - Computer Vision で識別するテキストを指定します。
- あいまいセレクター - あいまいセレクターのパラメーターです。
- ネイティブ テキスト - UI 要素の識別に使用されるテキストです。
- レスポンシブ Web サイト - レスポンシブ Web サイトのレイアウトを可能にします。
- 厳密セレクター - UI 要素に対して生成される厳密セレクターです。
- ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
- なし
- 厳密セレクター
- あいまいセレクター
- 画像
- ネイティブ テキスト
- Computer Vision - ターゲット メソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバー エンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリック エンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバー リージョンまたは独自のオンプレミス サーバー専用のエンドポイントを選択します。Computer Vision をターゲット メソッドとして使用するもう 1 つの方法は、[ローカル サーバーを使用] を [True] に設定することです。これは、UiPath.ComputerVision.LocalServer パッケージがプロジェクトにインストールされていることを意味します。ローカル サーバーが有効化されている場合、サーバーの値は上書きされます。ただし、ローカル サーバーはクロスプラットフォーム プロジェクトでは利用できません。
- 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
- なし - 可視性を確認しません。
- 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
- 完全に表示されている
- UI 要素が表示されているかどうかをチェックします。
- Wait for page load - Before performing the action, waits for the application to become ready to accept input. You can choose one of three options from the drop-down menu:
- なし - ターゲットの準備ができるまで待機しません。
- 対話型 - アプリの一部のみが読み込まれるまで待機します。
- 完了 - アプリ全体が読み込まれるまで待機します。
- ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。
- クリックのオフセット - [クリック] アクティビティのオフセットを詳細に設定できます。
-
実行を検証 - 実行時に、アクティビティによって実行された操作が正しいかどうかを検証します。それには、操作の実行後も表示されている必要のある要素、または表示されている必要のない要素を指定して、それをアクティビティの実行後に監視および検証します。この機能は [プロジェクト設定] で有効化するか、アクティビティの本体でコンテキスト メニューから [検証を追加] を選択して有効化します。
- 表示名 - 検証アクションの表示名です。このフィールドは、選択した検証アクションと要素に基づいて自動入力されます。実行の検証を設定すると、この表示名がアクティビティ カード内に表示されます。
- リトライ - オンにすると、期待される結果が達成されない場合は、アクティビティのタイムアウトまでの期間、アクションがリトライされます。既定では、このチェック ボックスはオンになっています。
- ターゲット - このターゲットを使用して、実行時に検証する要素を指定します。このプロパティの下で展開できるプロパティ フィールドの詳細については、上の [ターゲット] プロパティをご覧ください。プロパティの機能は同じです。
- タイムアウト - 検証対象の要素が出現、消滅、または変化するまで待機する時間 (秒) です。[リトライ] チェックボックスをオンにすると、アクションが再度実行された後、アクティビティの [タイムアウト] プロパティで指定した時間の間、検証が行われます。既定値は 10 秒です。
- 要素の次の動作を検証
- 検証ターゲットのどのような変更を確認するかを定義します。利用可能なオプションは次のとおりです。
- 出現 - 要素が出現するかどうかを確認します。
- 消滅 - 要素が消滅するかどうかを確認します。
- テキストの変化 - 要素のテキストに変化があるかどうかを確認します。
- 表示の変化 - 要素の画像に変化があるかどうかを確認します。
-
入力要素 - アクティビティの実行対象となる UI 要素で、
UIElementオブジェクトに保存されます。このフィールドではUIElementオブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティ フィールドから取得できます。 -
出力要素 - ターゲット UI 要素を出力して、
UIElementオブジェクトに保存し、他のアクティビティで同じ要素をターゲットとするために使用できるようにします。 -
プライベート - オンにすると、変数および引数の値が Verbose レベルでログに出力されなくなります。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は [False] です。
-
Activate - Brings the UI element to the foreground and activates it before sending the shortcut. This field only supports Boolean values (True, False). The default value is True.
-
Click before typing - Selects the type of click to execute in the specified UI element before sending the shortcut. The options are None (do not click), Single (execute a single click), or Double (execute a double click). The default option is None.
-
Delay between keys - Delay (in seconds) between consecutive keystrokes. The default value is 0.1 seconds. The maximum value is 1 second.
-
ショートカット キー入力間の待機時間 - 2 つの連続するキーボード ショートカット間の待機時間 (秒単位) です。ドロップダウン メニューから、あらかじめ定義された値 (0.2 (s)、0.5 (s)、または 0.8 (s)) を選択できます。既定値は 0.5 秒です。
-
Input mode - Selects which method the Robot should use to interact with the target application:
- アプリ/ブラウザーと同一 - [アプリケーション/ブラウザーを使用] アクティビティと同じ入力モードを使用します。
- ハードウェア イベント - ハードウェア ドライバーを使用してアクションを実行します。動作が最も遅く、バックグラウンドでの動作も不可能ですが、すべてのデスクトップ アプリに対して使用できます。このオプションは既定で選択されています。
- Chromium API - デバッガー API を使用してアクションを実行します。これは、Chromium の要素に対してのみ動作します。すべてのテキストを一度に送信します。対象のアプリにフォーカスしていなくても動作します。詳しくは、こちらのページをご覧ください。
- Window Messages - Simulates using Win32 messages. Recommended for desktop apps. More reliable than Hardware Events for most browser and desktop apps. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.