UI Automation のアクティビティ

最終更新日時 2025年11月11日

表のセルスコープ

UiPath.UIAutomationNext.Activities.NSAPTableCellScope

説明

既存の表 UI 要素にアタッチし、その中で複数のアクションを実行できるコンテナーです。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows and Cross-platform configuration

[アプリ/ブラウザーで指定] を選択して、ターゲットとして使用する UI 要素を指定します。

ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- オブジェクトリポジトリに追加 - 現在の UI 要素をライブラリプロジェクトに追加し、オートメーションプロセス全体で要素を再利用することができます。
列名/フィルター - 表の列名を指定します。表のセルを指定すると、利用可能なすべての列名のリストがアクティビティ内に表示されます。
行の入力の種類 - 行の検索方法を指定します。
- セレクター/フィルター
- 行インデックス
- 最初の空の行 - 既定値です。
実行シーケンス - 含まれる一連の子アクティビティを逐次実行します。

プロパティパネル

ターゲット

Expand target properties - Display target and anchor properties. This will hide the other activity properties and display only those related to the target.

Collapse target properties - Hide target and anchor properties. This will hide target related properties and display the activity properties.

ターゲットメソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウンメニュー内の任意の組み合わせを設定できます。
- None
- Strict selector - The strict selector generated for the target UI element.
- Fuzzy selector - The fuzzy selector parameters.
- Computer Vision - ターゲットメソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバーエンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリックエンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバーリージョンまたは独自のオンプレミスサーバー専用のエンドポイントを選択します。
  
  Another way of using Computer Vision as a targeting method is to set Use Local Server to True. This implies that the UiPath.ComputerVision.LocalServer package is installed in your project. When Local Server is enabled, the server value is over-written. However, the Local Server is not available in cross-platform projects.
  - CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
  - CV テキスト - Computer Vision で識別するテキストを指定します。
  - CV Text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
  - CV Text accuracy - Indicates the accuracy level for OCR text matching.
- Semantic selector - Leverages large language models (LLMs) to generate functional, human-like descriptions of UI elements. These descriptions are highly reliable making them adaptable to UI changes and significantly improving automation resilience when traditional selectors fail.
- Image (Windows only)
  - Image accuracy - Indicates the accuracy level for image matching.
  - Image occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
- Native text (Windows only)
  - Native text - The text to find to identify the UI element.
  - Native text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
Window selector (Application instance) - Selector for the application window. Only applicable when window attach mode is set to application instance.
Wait for page load - Before performing the action, wait for the application to becaome ready to accept input. The options are:
- なし - ターゲットの準備ができるまで待機しません。
- 対話型 - アプリの一部のみが読み込まれるまで待機します。
- 完了 - アプリ全体が読み込まれるまで待機します。
Visibility check - When enabled, the activity also checks whether the UI element is visible or not. You can choose one of three options from the drop-down menu:
- なし - 可視性を確認しません。
- 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
- 完全に表示されている - UI 要素が表示されるかどうかを確認します。
レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。

タイミング

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

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

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

オプション

Healing agent mode (cross-platform only) - Configures the behavior of the Healing Agent for this activity, based on Governance or Orchestrator settings at process or job level.
- 無効化 - このアクティビティの Healing Agent をオフにします。
- ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセスレベルまたはジョブレベルで適用します。
- 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
- アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

入力/出力

Input element - The UI element on which the activity is executed, stored in an 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 - Outputs a target UI Element and stores it in a UIElement object, which can be further used to target the same element with other activities.
Table Row Index - The found row index in case First Empty Row is used. Otherwise, the value in this field is equal to the input in the Row Number property. This field supports only UInt32 variables.

Windows - レガシでの設定

[アプリ/ブラウザーで指定] を選択して、ターゲットとして使用する UI 要素を指定します。

ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- オブジェクトリポジトリに追加 - 現在の UI 要素をライブラリプロジェクトに追加し、オートメーションプロセス全体で要素を再利用することができます。
列名/フィルター - 表の列名を指定します。表のセルを指定すると、利用可能なすべての列名のリストがアクティビティ内に表示されます。
行の入力の種類 - 行の検索方法を指定します。
- セレクター/フィルター
- 行インデックス
- 最初の空の行 - 既定値です。
実行シーケンス - 含まれる一連の子アクティビティを逐次実行します。

プロパティパネル

共通

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

注: このアクティビティが [トライキャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True に設定されている場合、プロジェクトが実行されたときにエラーは発生しません。
実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
表示名 - アクティビティの表示名です。
タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

列名/フィルター - 表の列名を指定します。表のセルを指定すると、利用可能なすべての列名のリストがアクティビティ内に表示されます。このフィールドで作成される変数は String 型です。
行インデックス - 行インデックスを指定します。
行の入力の種類 - 行の検索方法を指定します。
- セレクター/フィルター
- 行インデックス
- 最初の空の行 - 既定値です。
行セレクター - 使用する行セレクター/フィルターを指定します。
ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。
- CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
- CV テキスト - Computer Vision で識別するテキストを指定します。
- あいまいセレクター - あいまいセレクターのパラメーターです。
- ネイティブテキスト - UI 要素の識別に使用されるテキストです。
- レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。
- 厳密セレクター - UI 要素に対して生成される厳密セレクターです。
- ターゲットメソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウンメニュー内の任意の組み合わせを設定できます。
  - None
  - 厳密セレクター
  - あいまいセレクター
  - 画像
  - ネイティブテキスト
  - Computer Vision - ターゲットメソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバーエンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリックエンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバーリージョンまたは独自のオンプレミスサーバー専用のエンドポイントを選択します。
    Computer Vision をターゲットメソッドとして使用するもう 1 つの方法は、[ローカルサーバーを使用] を [True] に設定することです。これは、UiPath.ComputerVision.LocalServer パッケージがプロジェクトにインストールされていることを意味します。ローカルサーバーが有効な場合、サーバーの値は上書きされます。ただし、ローカルサーバーはクロスプラットフォームプロジェクトでは利用できません。
  - セマンティックセレクター - 大規模言語モデル (LLM) を活用して、人間が書くような UI 要素の機能的な記述を生成します。これらの記述は信頼性が高いため、UI の変更に適応でき、従来のセレクターが失敗した場合のオートメーションの回復性が大幅に向上します。
- 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウンメニューの次の 3 つのオプションのいずれかを選択できます。
  - なし - 可視性を確認しません。
  - 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  - 完全に表示されている - UI 要素が表示されるかどうかを確認します。
- ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。ドロップダウンメニューの次の 3 つのオプションのいずれかを選択できます。
  - なし - ターゲットの準備ができるまで待機しません。
  - 対話型 - アプリの一部のみが読み込まれるまで待機します。
  - 完了 - アプリ全体が読み込まれるまで待機します。
- ウィンドウセレクター (アプリケーションインスタンス) - アプリケーションウィンドウに使用されるセレクターです。[ウィンドウアタッチモード] が [アプリケーションインスタンス] に設定されている場合にのみ適用されます。

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