要素スコープ

重要:

The modern Element Scope activity is only available in Preview.

UiPath.UIAutomationNext.Activities.NElementScope

説明

The Element Scope activity identifies a single UI element once and then exposes it as the scope for every activity placed in its body. All child activities (for example, Click, Type Into, Get Text, Get Attribute) target elements relative to the element you indicated, instead of searching the whole screen again.

Use it when you want to run several actions inside the same container — a table row, a form section, a card, or a panel — while keeping selectors short, stable, and fast.

The body of the activity is a container. Child activities that should target the indicated element (or its descendants) are placed inside the body. Every child activity runs against the element captured by the scope, so you only indicate the parent element once.

注:

Element Scope can be placed inside a Use Application/Browser activity, so the element is resolved within that application/browser scope and child activities can inherit its settings. It can also be used on its own by indicating an element directly.

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• Indicate on screen - Indicate the UI element you want to attach to. Once indicated, the activity card displays a preview of the target element and its anchors.
  ターゲットを指定したら、メニュー オプション ボタンを選択し、以下のいずれかのオプションを選択してターゲットを管理します。
  • Indicate target - Indicate the target again. If the Descriptor is defined in Object Repository, you have to unlink it before you can indicate a Descriptor only for the current activity.
  • Edit target - Open the Selection Helper to configure the target element.
  • Remove Informative Screenshot - Removes the screenshot of the target element.
  • Change Informative Screenshot - Changes the screenshot of the target element.
  • オブジェクト リポジトリに表示 - 記述子を選択した状態で [オブジェクト リポジトリ] パネルを開きます。
  • オブジェクト リポジトリへのリンクを解除 - オブジェクト リポジトリへの記述子のリンクを解除します。
  • Add to Object Repository - Adds the current UI element to a library project, from where it can be reused throughout your automation process.

プロパティ パネル

ターゲット

The UI element the scope attaches to. The target is configured when you indicate the element on screen and can be refined using the following options:

• ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウ (アプリケーション/ブラウザー) のセレクターです。
• Strict selector - The selector generated for the indicated element. A selector is an XML fragment that identifies the element by its attributes.

オプション

• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
• Continue on error - Specifies whether the automation should continue even when the activity throws an error. This field only supports Boolean (True, False) values. The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
• Input mode - Specifies which technology is used to interact with the target element. Child activities inside the scope can inherit this mode. The available options are:
  • Hardware Events - Acts like a real user, using the mouse and keyboard through the operating system. Emulates human behavior fully, but some events may be lost, and the target application must be in focus.
  • Simulate - Simulates the action using accessibility APIs. Recommended for browsers, Java-based apps, and SAP. Usually more reliable than Hardware Events, sends all text in a single action, and works even when the target app is not in focus. Verify that the target element supports it.
  • Chromium API - Performs actions using debugger APIs. Works for Chromium elements only. Sends all text in one go, and works when the target app is not in focus.
  • Window Messages - Uses Win32 messages. Recommended for desktop apps. Usually more reliable than Hardware Events, sends all text at once, and works even when the target app is not in focus. Verify that the target element supports it.
  • Background - Runs in the background. Uses Simulate where possible; complex activities (image, native text) still run in the foreground.

タイミング

• Timeout - Specifies the amount of time (in seconds) to wait for the target element to be found before an error is thrown. The default value is 30 seconds.

注:

The Delay before and Delay after properties are not used by Element Scope and are hidden in the Designer. Project-level delay settings are intentionally not applied to this activity.

入力/出力

• Input element - The UI element on which the activity is executed, stored in a UiElement object. This field supports only UiElement objects. This object can be obtained from the Output element property field of other UI Automation activities.
• Output element - The resolved UI element, stored in a UiElement object. This variable can then be passed to other activities that accept UiElement as input.