Find Elements

UiPath.UIAutomationNext.Activities.NFindElements

説明

Retrieves a collection of UI elements, either children, descendants or top levels, according to a specified scope and filter criteria.

このアクティビティはオブジェクト リポジトリに対応しています。

プロジェクトの対応 OS

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

構成

• Mode - Enables you to set the find mode of the UI elements in the collection. The following options are available:
  • Find children - Find first level elements that match the filter from the indicated target/element/scope.
  • Find descendants - Find all the elements that match the filter from the indicated target/element/scope.
  • Find top levels - Find all the elements that match the filter from all opened applications.

• Filter - XML string specifying the conditions all elements in the collection should meet. The filter is a selector. The activity searches for all the children or descendants of the target element, matching the selector.

  For instance, using <webctrl tag='UL' /> would initiate a search for unordered list elements within a certain web page.
  注: 使用しているフィルター条件ですべての可能な要素を除外した場合、空の要素リストが返されます。

プロパティ パネル

オプション

• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

タイミング

• 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

入力/出力

• 入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティ フィールドから取得できます。
• 出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。

出力

Children - All UI children found according to the filter and scope set. The field supports only IEnumerable<UiElement> variables.