要素スコープ

既存の UI 要素にアタッチし、それを複数の子アクティビティのスコープとして公開する要素スコープ アクティビティです。

重要:

[ 要素スコープ ] モダン アクティビティはプレビュー版でのみ利用可能です。

UiPath.UIAutomationNext.Activities.NElementScope

説明

[ 要素スコープ] アクティビティは、1 つの UI 要素を一度識別すると、その本体に配置されたすべてのアクティビティのスコープとして公開されます。すべての子アクティビティ ( [クリック]、[ 文字を入力]、[テキストを 取得]、[ 属性を取得] など) は、画面全体を再度検索するのではなく、指定した要素 からの相対的な 要素をターゲットにします。

セレクターを短く、安定して高速に保ちながら、同じコンテナー (表の行、フォーム セクション、カード、またはパネル) 内で複数のアクションを実行する場合に使用します。

アクティビティの本体はコンテナーです。指定した要素 (またはその子孫) を対象とする子アクティビティは、本体内に配置されます。すべての子アクティビティは、スコープでキャプチャされた要素に対して実行されるため、親要素を指定するのは 1 回だけです。

注:

[要素スコープ ] は [ アプリケーション/ブラウザーを使用 ] アクティビティ内に配置できます。これにより、要素はそのアプリケーション/ブラウザーのスコープ内で解決され、子アクティビティはその設定を継承できます。要素を直接指定して単独で使用することもできます。

プロジェクトの対応 OS

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

構成

• 画面上で指定 - アタッチする UI 要素を指定します。ターゲットを指定すると、アクティビティ カードにターゲット要素とそのアンカーのプレビューが表示されます。
  ターゲットを指定したら、メニュー オプション ボタンを選択し、以下のいずれかのオプションを選択してターゲットを管理します。
  • ターゲットを指定 - ターゲットをもう一度指定します。記述子がオブジェクト リポジトリで定義されている場合は、現在のアクティビティに対してのみ記述子を指定する前にリンクを解除する必要があります。
  • ターゲットを編集 - 選択ヘルパーを開いて、ターゲット要素を設定します。
  • 参考スクリーンショットを削除 - ターゲット要素のスクリーンショットを削除します。
  • 参考スクリーンショットを変更 - ターゲット要素のスクリーンショットを変更します。
  • オブジェクト リポジトリに表示 - 記述子を選択した状態で [オブジェクト リポジトリ] パネルを開きます。
  • オブジェクト リポジトリへのリンクを解除 - オブジェクト リポジトリへの記述子のリンクを解除します。
  • オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用できます。

プロパティ パネル

ターゲット

スコープがアタッチされる UI 要素です。ターゲットは、画面上で要素を指定したときに設定され、以下のオプションを使用して調整できます。

• ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウ (アプリケーション/ブラウザー) のセレクターです。
• 厳密セレクター - 指定した要素に対して生成されるセレクターです。セレクターは、要素をその属性によって識別する XML フラグメントです。

オプション

• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、 Boolean 値 (True、 False) のみがサポートされています。既定値は Falseです。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を Trueに設定すると、プロジェクトの実行はエラーに関係なく継続されます。
• 入力モード - ターゲット要素の操作に使用するテクノロジを指定します。スコープ内の子アクティビティは、このモードを継承できます。利用可能なオプションは次のとおりです。
  • ハードウェア イベント - オペレーティング システム上でマウスとキーボードを使用して、実際のユーザーのように動作します。人間の操作を完全にエミュレートしますが、一部のイベントが失われる可能性があるため、対象のアプリケーションにフォーカスする必要があります。
  • シミュレート - アクセシビリティ API を使用してアクションをシミュレートします。ブラウザー、Java ベースのアプリ、SAP を使用する場合に推奨されます。通常はハードウェア イベントよりも信頼性が高く、すべてのテキストを 1 回の操作で送信し、対象のアプリにフォーカスしていなくても動作します。ターゲット要素がこのオプションをサポートしていることを確認します。
  • Chromium API - デバッガー API を使用してアクションを実行します。これは、Chromium の要素に対してのみ動作します。すべてのテキストを一度に送信し、対象のアプリにフォーカスしていなくても動作します。
  • ウィンドウ メッセージ - Win32 メッセージを使用します。デスクトップ アプリに適しています。通常はハードウェア イベントよりも信頼性が高く、すべてのテキストを一度に送信し、対象のアプリにフォーカスしていなくても動作します。ターゲット要素がこのオプションをサポートしていることを確認します。
  • バックグラウンド - バックグラウンドで実行されます。可能な場合は [シミュレート] を使用します。複雑なアクティビティ (画像、ネイティブ テキスト) は引き続きフォアグラウンドで実行されます。

タイミング

• タイムアウト - エラーがスローされる前にターゲット要素が見つかるまで待機する時間 (単位: 秒) を指定します。既定値は 30 秒です。

注:

[ 実行前の待機時間 ] プロパティと [ 実行後の待機時間 ] プロパティは [ 要素スコープ ] では使用されず、デザイナーには表示されません。プロジェクト レベルの待機時間の設定は、このアクティビティには意図的に適用されません。

入力/出力

• 入力要素 - アクティビティの実行対象となる UI 要素で、 UiElement オブジェクトに保存されます。このフィールドでは UiElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [ 出力要素 ] プロパティ フィールドから取得できます。
• 出力要素 - 解決された UI 要素で、 UiElement オブジェクトに保存されます。その後、この変数を、 UiElement を入力として受け入れる他のアクティビティに渡すことができます。