表データを抽出

UiPath.UIAutomationNext.Activities.NExtractData

説明

表データや複数のページにわたる Web の検索結果などの構造化された情報を抽出します。

表抽出ウィザードに従って、抽出する情報を指定します。ウィザードの使用方法について詳しくは、「表抽出」をご覧ください。

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

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

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

プロジェクトの対応 OS

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

Windows and Cross-platform configuration

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

• [画面上でターゲットを指定] - 表抽出ウィザードに従って、抽出するデータを指定します。

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

  • データを抽出ウィザード - 表抽出ウィザードを再度開いてデータを抽出します。
  • 抽出データを編集 - 表抽出ウィザードを開き、抽出されたデータを設定します。

Proprieties panel

オプション

• 抽出数の制限 - データの抽出時に使用する制限の種類を指定します。このプロパティは、[項目数] プロパティとともに機能します。利用可能なオプションは、[最大行数](既定)、[制限なし]、[最大ページ数] です。
• 項目数 - 抽出する結果の最大数です。値が 0 の場合、識別されたすべての要素が出力に追加されます。
• ページ間の待機時間 - 次のページを読み込むまでの待機時間 (秒単位) です。既定値は 1.5 秒です。ページの読み込み時間が長いほど、この値を大きくする必要があります。
• 入力モード - ロボットが対象のアプリケーションと対話するメソッドを、以下より選択します。
  • ブラウザーと同一 - 親の [ブラウザーを使用] アクティビティの [入力モード] の設定に使用します。
  • Chromium API - デバッガー API を使用してアクションを実行します。Chrome および Edge の要素にのみ使用できます。すべてのテキストを一度に送信します。対象のアプリにフォーカスしていなくても動作します。
  • シミュレート - アクセシビリティ API を使用してクリックをシミュレートします。ブラウザーに使用できます。すべてのテキストを一度に送信します。この入力メソッドは、バックグラウンドで (対象のアプリにフォーカスしていなくても) 動作します。
• 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.

ターゲット

• ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。
• 厳密セレクター - UI 要素に対して生成される厳密セレクターです。
• Extract metadata - An XML string that enables you to define what data to extract from the indicated web page.

タイミング

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

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

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

• 出力先のデータ テーブル - 抽出したデータの保存場所です。
• 入力データ テーブル - 抽出したデータに追加するデータです。

Windows - レガシでの設定

• [画面上でターゲットを指定] をクリックして、表抽出ウィザードに従って、抽出するデータを指定します。

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

  • 抽出データを編集 - 表抽出ウィザードを開き、抽出されたデータを設定します。
  • 抽出をテスト - 現在の設定でデータ抽出をテストします。結果はプレビュー データ ウィンドウに表示されます。
  • データを抽出ウィザード - 表抽出ウィザードを再度開いてデータを抽出します。
  • 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
  • オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。

• 抽出先 - 抽出したデータの保存先です。

プロパティ パネル

共通

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

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

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

• 表示名 - デザイナー パネルに表示される、アクティビティの名前です。表示名は、ターゲットを指定すると自動的に生成されます。

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

• メタデータを抽出 - 指定した Web ページから抽出するデータを定義できる XML 文字列です。
• 表の設定 - データの抽出時に使用する表の設定です。
• ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (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 つのオプションのいずれかを選択できます。
    • なし - ターゲットの準備ができるまで待機しません。
    • 対話型 - アプリの一部のみが読み込まれるまで待機します。
    • 完了 - アプリ全体が読み込まれるまで待機します。
  • ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。
• ターゲット ([次へ] ボタン) - 2 番目に指定したボタンのターゲットで、これに基づいて表が抽出されます。このプロパティの下で展開できるプロパティ フィールドの詳細については、上の [ターゲット] プロパティをご覧ください。プロパティの機能は同じです。

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

• 結果を追加 - 既存値の後に結果を追加するか (該当する場合)、情報全体を上書きするかを指定します。
• データ テーブル - 指定した Web ページから抽出される情報です。このフィールドでは DataTable 型の変数のみがサポートされています。
• ページ間の待機時間 - 次のページを読み込むまでの待機時間 (秒単位) です。既定値は 1.5 秒です。ページの読み込み時間が長いほど、この値を大きくする必要があります。

• 入力モード - データが複数のページにわたっていた場合に、次ページへのリンクをクリックする方法を選択します。このプロパティは、[次のリンク] ボタンが指定されている場合にのみ機能します。

  • アプリ/ブラウザーと同一 - [アプリケーション/ブラウザーを使用] アクティビティと同じ入力モードを使用します。

    これは既定のオプションです。

  • ハードウェア イベント - ハードウェア ドライバーを使用してアクションを実行します。動作が極めて遅く、バックグラウンドでは動作しませんが、すべてのデスクトップ アプリに対して使用できます。

  • シミュレート - アクセシビリティ API を使用してシミュレートします。ブラウザー、Java ベースのアプリケーション、および SAP を使用する場合に推奨されます。通常はハードウェア イベントよりも信頼性が高くなります。すべてのテキストを 1 回の操作で送信します。対象のアプリにフォーカスしていなくても動作します。対象のアプリケーションの UI 要素がこの方法をサポートしているかどうかをテストしてください。

  • Chromium API - デバッガー API を使用してアクションを実行します。これは、Chromium の要素に対してのみ動作します。すべてのテキストを一度に送信します。対象のアプリにフォーカスしていなくても動作します。詳しくは、こちらのページをご覧ください。

  • ウィンドウ メッセージ - Win32 メッセージを使用してシミュレートします。デスクトップ アプリに適しています。通常はハードウェア イベントよりも信頼性が高くなります。すべてのテキストを 1 回の操作で送信します。対象のアプリにフォーカスしていなくても動作します。対象のアプリケーションの UI 要素がこの方法をサポートしているかどうかをテストしてください。

• 抽出数の制限 - データの抽出時に使用する制限の種類を指定します。このプロパティは、[項目数] プロパティとともに機能します。使用できるオプションは、[最大 UI 要素数]、[制限なし] (既定) および [最大ページ数] です。
• 項目数 - 抽出する結果の最大数です。値が 0 の場合、識別されたすべての要素が出力に追加されます。このプロパティは、[抽出数の制限] プロパティとともに機能します。