テキストを取得

UiPath.UIAutomationNext.Activities.NGetText

説明

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

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

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

プロジェクトの対応 OS

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

Windows - レガシ、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 要素に対して表示されるテキストを抽出します。
• ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。
  注: このアクティビティのターゲットとしてオンになっているチェック ボックスを指定した場合、返されるテキストは checked になります。このアクティビティのターゲットとして画像を指定した場合、画像の alt テキストが返されます。
  • CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
  • CV テキスト - Computer Vision で識別するテキストを指定します。
  • あいまいセレクター - あいまいセレクターのパラメーターです。
  • ネイティブ テキスト - UI 要素の識別に使用されるテキストです。
  • レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。
  • 厳密セレクター - UI 要素に対して生成される厳密セレクターです。
  • ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
    • None
    • 厳密セレクター
    • あいまいセレクター
    • 画像
    • ネイティブ テキスト
    • Computer Vision
  • 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
    • なし - 可視性を確認しません。
    • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
    • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
  • ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
    • なし - ターゲットの準備ができるまで待機しません。
    • 対話型 - アプリの一部のみが読み込まれるまで待機します。
    • 完了 - アプリ全体が読み込まれるまで待機します。
  • ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。

入力/出力要素

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

その他

• プライベート - オンにすると、変数および引数の値が Verbose レベルでログに出力されなくなります。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。

出力

• テキスト - デザイナー パネルの [保存先] の説明をご覧ください。
• 文字情報 - 画面座標など、取得したテキストの追加情報は、このフィールドで指定した変数に保存されます。このフィールドでは NWordInfo 型の変数のみがサポートされています。

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

• 作業スコープ - 自動化対象の Web アプリケーションを表示するブラウザー タブを選択します。

• 画面上でターゲットを指定 - ターゲットとして使用する UI 要素を指定します。

  ターゲットを指定したら、プラス ボタンをクリックします。以下のオプションが表示されます。

  • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。

その他のオプション

タイミング

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

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

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

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

オプション

• スクレイピング メソッド - 使用するスクレイピング メソッドを示します。次のオプションを使用できます。

  • 既定 - 使用できるスクレイピング メソッド ([テキスト属性]、[フル テキスト] の順) を確認し、データが返される最初のメソッドで停止します。テキストが返されても正しいテキストが返されない場合にのみ、既定のメソッドを変更する必要があります。既定のメソッドで何も返されない場合は、他のスクレイピング メソッドでも同様です。
  • テキスト属性 - 指定した UI 要素のテキスト属性値を抽出します。
  • フルテキスト - UI 要素とその子要素のフル テキストを抽出します。このメソッドは、複数の子要素を含むコンテナー要素のフル テキストを抽出する場合に便利です。

入力/出力

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