UI Automation のアクティビティ

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

テキストを取得

UiPath.UIAutomationNext.Activities.NGetText

説明

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

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

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

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

プロジェクトの対応 OS

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

Windows、クロスプラットフォームでの設定

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

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

プロパティパネル

入力/出力

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

オプション

スクレイピングメソッド - 使用するスクレイピングメソッドを示します。次のオプションを使用できます。
- 既定 - 使用できるスクレイピングメソッド ([テキスト属性]、[フルテキスト] の順) を確認し、データが返される最初のメソッドで停止します。テキストが返されても正しいテキストが返されない場合にのみ、既定のメソッドを変更する必要があります。既定のメソッドで何も返されない場合は、他のスクレイピングメソッドでも同様です。
- テキスト属性 - 指定した UI 要素のテキスト属性値を抽出します。
- フルテキスト - UI 要素とその子要素のフルテキストを抽出します。このメソッドは、複数の子要素を含むコンテナー要素のフルテキストを抽出する場合に便利です。
- OCR - OCR エンジンを使用してテキストを抽出します。
スクレイピングオプション:
- テキストの書式設定
- 非表示のテキストを無視
- 単語の座標
Healing Agent モード - プロセスレベルまたはジョブレベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
- 無効化 - このアクティビティの Healing Agent をオフにします。
- ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセスレベルまたはジョブレベルで適用します。
- 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
- アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

ターゲット

ターゲットのプロパティを展開 - ターゲットとアンカーのプロパティを表示します。これにより、アクティビティの他のプロパティは非表示になり、ターゲットに関連するプロパティのみが表示されます。

ターゲットのプロパティを折りたたみ - ターゲットとアンカーのプロパティを非表示にします。これにより、ターゲットに関連するプロパティが非表示になり、アクティビティのプロパティが表示されます。

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

ターゲット - クリッピング領域

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

タイミング

実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 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 オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。