UI Automation のアクティビティ

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

テキストを取得

UiPath.UIAutomationNext.Activities.NGetText

説明

UI 要素からテキストを抽出してコピーします。

このアクティビティは [アプリケーション/ブラウザーを使用] アクティビティに追加する必要があります。

このアクティビティを [アプリケーション/ブラウザーを使用] アクティビティの外で使用するには、入力要素を指定する必要があります。

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

プロジェクトの対応 OS

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

Windows and cross-platform configuration

作業スコープ - 自動化対象の Web アプリケーションを表示するブラウザータブを選択します。
画面上でターゲットを指定 - ターゲットとして使用する UI 要素を指定します。

ターゲットを指定したら、プラスボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。

Proprieties panel

入力/出力

テキスト値 - 指定された UI 要素からのテキストを変数に格納できます。このフィールドで作成される変数は String 型です。
文字情報 - 画面座標など、取得したテキストの追加情報は、このフィールドで指定した変数に保存されます。このフィールドでは NWordInfo 型の変数のみがサポートされています。
入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティフィールドから取得できます。
出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。

オプション

スクレイピングメソッド - 使用するスクレイピングメソッドを示します。次のオプションを使用できます。
- 既定 - 使用できるスクレイピングメソッド ([テキスト属性]、[フルテキスト] の順) を確認し、データが返される最初のメソッドで停止します。テキストが返されても正しいテキストが返されない場合にのみ、既定のメソッドを変更する必要があります。既定のメソッドで何も返されない場合は、他のスクレイピングメソッドでも同様です。
- テキスト属性 - 指定した UI 要素のテキスト属性値を抽出します。
- フルテキスト - UI 要素とその子要素のフルテキストを抽出します。このメソッドは、複数の子要素を含むコンテナー要素のフルテキストを抽出する場合に便利です。
- OCR - Extracts the text using the OCR engine.
Scraping options:
- Text formatting
- Ignore hidden text
- Word coordinates
Healing Agent モード - プロセスレベルまたはジョブレベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
- 無効化 - このアクティビティの Healing Agent をオフにします。
- ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセスレベルまたはジョブレベルで適用します。
- 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
- アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). 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.

ターゲット

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 サイトのレイアウトを有効化します。

Target - Clipping region

アンカーポイント - [X のオフセット] プロパティと [Y のオフセット] プロパティで設定したオフセットが追加される、カーソルの開始位置を表します。指定できるオプションは、TopLeft、 TopRight、BottomLeft、BottomRight および Center です。既定では、Center が選択されています。
X のオフセット - カーソルの位置を、[アンカーポイント] プロパティで選択した位置から水平方向にずらす距離を指定します。既定値は 300 秒です。このフィールドは、Int32 型変数のみをサポートします。
Y のオフセット - カーソルの位置を、[アンカーポイント] プロパティで選択した位置から垂直方向にずらす距離を指定します。既定値は 300 秒です。このフィールドは、Int32 型変数のみをサポートします。
Offset width - Width of the offset region.
Offset height - Height of the offset region.

タイミング

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

Windows - レガシでの設定

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

ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- オブジェクトリポジトリに追加 - 現在の UI 要素をライブラリプロジェクトに追加し、オートメーションプロセス全体で要素を再利用することができます。
- 抽出プレビュー - [テキストを取得] - 抽出結果のプレビュー ウィザードが開き、ターゲットから取得したテキストをリアルタイムで確認できます。
保存先 - 指定された UI 要素からのテキストを変数に格納できます。このフィールドで作成される変数は String 型です。

抽出結果のプレビュー

[テキストを取得] - 抽出結果のプレビュー ウィザードでは、使用するスクレイピングメソッドを選択し、選択したメソッドを使用して表示されるテキストをリアルタイムで表示できます。抽出されたテキストは [抽出結果のプレビュー] テキストボックスに表示され、[クリップボードにコピー] ボタンを使用してコピーできます。

ウィザードを使用しない場合、すべてのスクレイピングメソッドが既定で試行され、最適なメソッドが自動的に選択されます。[抽出結果のプレビュー] ウィンドウでスクレイピングメソッドを選択すると、このメカニズムが上書きされ、そのメソッドのみが使用されるようになります。

次のメソッドを使用できます。

既定 (Default)
テキスト属性
フルテキスト - このメソッドには [非表示のテキストを無視] オプションがあります。このオプションは、該当するチェックボックスをオンにしてアクティブ化できます。
ネイティブ - このメソッドでは、書式設定を許可し、各単語の画面座標を取得できます。それには、各機能のチェックボックスをオンにします。

スクレイピングに使用するメソッドを選択した後、[保存して閉じる] をクリックすると、ウィザードが閉じて、アクティビティの [プロパティ] パネルで加えた変更が反映されます。

プロパティパネル

共通

エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
表示名 - デザイナーパネルに表示される、アクティビティの名前です。表示名は、ターゲットを指定すると自動的に生成されます。
タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

ドロップダウンメニューから、あらかじめ定義された値 (10 (s)、20 (s)、または 30 (s) のいずれか) を選択することもできます。

- 既定 - 使用できるスクレイピングメソッド ([テキスト属性]、[フルテキスト] の順) を確認し、データが返される最初のメソッドで停止します。テキストが返されても正しいテキストが返されない場合にのみ、既定のメソッドを変更する必要があります。既定のメソッドで何も返されない場合は、他のスクレイピングメソッドでも同様です。
- テキスト属性 - 指定した UI 要素のテキスト属性値を抽出します。
- フルテキスト - UI 要素とその子要素のフルテキストを抽出します。このメソッドは、複数の子要素を含むコンテナー要素のフルテキストを抽出する場合に便利です。
- ネイティブ - 指定した UI 要素に対して表示されるテキストを抽出します。
注: このアクティビティのターゲットとしてオンになっているチェックボックスを指定した場合、返されるテキストは checked になります。このアクティビティのターゲットとして画像を指定した場合、画像の alt テキストが返されます。
- 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 オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。