UI Automation のアクティビティ

最終更新日時 2024年12月20日

表データを抽出

UiPath.UIAutomationNext.Activities.NExtractData

説明

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

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

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

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

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

プロジェクトの対応 OS

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

Windows - レガシ、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 パッケージがプロジェクトにインストールされていることを意味します。ローカルサーバーが有効な場合、サーバーの値は上書きされます。ただし、ローカルサーバーはクロスプラットフォームプロジェクトでは利用できません。
- 可視性を確認 - 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 の場合、識別されたすべての要素が出力に追加されます。このプロパティは、[抽出数の制限] プロパティとともに機能します。

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

作業スコープ - 自動化対象の Web アプリケーションを表示するブラウザータブを選択します。
[画面上でターゲットを指定] - 表抽出ウィザードに従って、抽出するデータを指定します。

ターゲットを指定したら、プラスボタンをクリックします。以下のオプションが表示されます。
- データを抽出ウィザード - 表抽出ウィザードを再度開いてデータを抽出します。
- 抽出データを編集 - 表抽出ウィザードを開き、抽出されたデータを設定します。

その他のオプション

タイミング

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

オプション

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