UI Automation のアクティビティ

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

構造化データを抽出

UiPath.Core.Activities.ExtractData

指定した Web ページからデータを抽出します。[プロパティ] パネルの [メタデータを抽出] フィールドに XML 文字列を設定することで、どの情報を抽出するかを指定できます。このXML 文字列は、データスクレイピングウィザードを使用して、すべてのプロパティが設定された状態で簡単に生成することができます。

プロパティ

入力

メタデータを抽出 - 指定した Web ページから抽出するデータを定義できる XML 文字列です。
Target.Selector - アクティビティの実行時に特定の UI 要素の検索に使用する Text プロパティです。実際には、検索しようとする GUI 要素とそのいくつかの親要素の属性を指定する XML フラグメントです。
Target.TimeoutMS - アクティビティの実行が完了するまで待機する時間をミリ秒で指定します。指定した時間が経過しても実行が完了しない場合には、SelectorNotFoundException 例外をスローします。既定値は 30000 ミリ秒 (30 秒) です。
Target.WaitForReady - アクションを実行する前に、ターゲットが準備完了になるまで待ちます。次のオプションを使用できます。
- NONE - ターゲット要素以外の要素の読み込みを待たずに、アクションを実行します。たとえば、UI 要素がすべて読み込まれるまで待つことなく、Web ページからテキストを取得したり、特定のボタンをクリックしたりする場合に、このオプションを使用できます。ボタンがまだ読み込まれていない要素 (スクリプトなど) に依存している場合、これは望ましくない結果を招く可能性があります。
- Interactive/Complete - 実際に操作を実行する前に、対象アプリのすべての UI 要素が存在するようになるまで待ちます。
  
  アプリケーションが対話または完了のどちらのステートにあるか調べるには、以下のタグを検証します。
- Desktop applications - <wnd> タグ、<ctrl> タグ、<java> タグ、または <uia> タグの存在を確認するために wm_null メッセージが送信されます。存在する場合、アクティビティが実行されます。
- Web アプリケーション：
1. Internet Explorer - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete に設定されているかどうかを確認するために使用されます。また、Busy ステートは「False」に設定されている必要があります。
2. Others - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete であるかどうかを確認するために使用されます。
- SAP applications - 最初に <wnd> タグを確認した後、SAP 固有の API を使用して、セッションがビジーかどうかを検出します。
Target.Element - 別のアクティビティから返される UiElement 変数を使用します。このプロパティを Selector プロパティと一緒に使用することはできません。このフィールドでは UiElement 変数のみサポートされています。
Target.ClippingRegion - UiElement を基準とし、左、上、右、下の方向で、クリッピング四角形 (ピクセル単位) を定義します。正と負の両方の値をサポートしています。

オプション

ページ間の待機時間 (ミリ秒) - 次のページが読み込まれるまで待機する時間 (ミリ秒単位) です (ページの読み込み時間が長めの場合はこの値を大きめにしてください)。
MaxNumberOfResults - 抽出する結果の最大数です。値が 0 の場合は、識別された要素のすべてが出力に追加されます。既定値は 100 です。
NextLinkSelector - 次のページへの移動に使用するリンクまたはボタンを識別するセレクターです。ExistingUiElement プロパティを基準とする必要があります。
ウィンドウメッセージを送信 - 選択した場合、抽出対象のデータが数ページにまたがっていると、ターゲットアプリケーションに指定のメッセージを送信してページを変更するクリックが実行されます。この入力メソッドはバックグラウンドで動作でき、ほとんどのデスクトップアプリケーションに対して使用できますが、最速のメソッドではありません。既定では、このチェックボックスはオフになっています。このチェックボックスも [クリックをシミュレート] チェックボックスもオフになっている場合は、既定のメソッドがハードウェアドライバーを使用してクリックをシミュレートします。既定のメソッドは最も遅く、バックグラウンドで動作できませんが、すべてのデスクトップアプリケーションに対して使用できます。
クリックをシミュレート - オンにすると、抽出対象のデータが数ページにまたがっている場合、対象のアプリケーションのテクノロジを使用してページを変更するクリックをシミュレートします。この入力メソッドは 3 種類の中で最も速く、バックグラウンドで動作します。既定では、このチェックボックスはオフになっています。このチェックボックスも [ウィンドウメッセージを送信] チェックボックスもオフになっている場合は、既定のメソッドがハードウェアドライバーを使用してクリックを実行します。既定のメソッドは最も遅く、バックグラウンドで動作できませんが、すべてのデスクトップアプリケーションに対して使用できます。

出力

データテーブル - 指定した Web ページから抽出される情報です。このフィールドでは DataTable 型の変数のみがサポートされています。

共通

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

注: このアクティビティが [トライキャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。