テキストからデータ テーブルを生成

UiPath.Core.Activities.GenerateDataTable

構造化テキストから DataTable 型変数を生成します。このアクティビティでは、生成された表に応じた列と行の区切り文字を選択できます。このアクティビティは、[画像スクレイピング] ウィンドウの表生成機能を使用すると自動的に生成されます。

プロジェクトの対応 OS

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

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

• 入力 - 構造化テキストのソースです。
• 解析方法 - 表のデータの書式設定オプションです。利用可能なオプションは次のとおりです。
  • CSV (コンマ区切り値)
  • カスタム
  • 固定幅列

プロパティ

• 型を自動検出 - オンにすると、列または行の型 (String、Int32 など) を自動的に検出します。
• 最初の行を列ヘッダーとして使用 - 有効化すると、識別された最初の行を列ヘッダーとして使用します。
• 第 1 列を無視 - 有効化した場合、最初に識別された列を無視します。
• エラー発生時に実行を継続 - アクティビティが例外をスローした場合でもオートメーションを続行するかどうかを指定します。このフィールドは Boolean 値 (True、False) のみをサポートします。既定値は False です。結果として、フィールドが空白であり、例外がスローされた場合、プロジェクトの実行は停止されます。値が True に設定されている場合、エラーが発生したとしても、プロジェクトの実行は続行されます。
• DataTable - 生成された表を格納する DataTable 型変数です。

Windows および Windows - レガシでの設定

• 入力: - 構造化テキストのソースです。StudioX では、プラス記号のアイコン を使用して、利用可能なオプションを 1 つ選択できます。

  • プロジェクト ノートブック、親の Excel ファイル、または Outlook アカウントからのデータ。たとえば、Excel ファイルを選択し、[Excel 内で示す] を選択してファイルのセルを指定するか、Outlook のメールを選択して、入力として使用するデータを含むメールのフィールドを選択します。
  • 実行時に確認 - プロジェクトの実行時にデータの入力を求めます。
  • クリップボードから貼り付け - プロジェクトのクリップボードに以前にコピーした値を貼り付けます。
  • テキスト - テキスト ビルダーにデータを入力します。
  • 保存された値を使用 - プロジェクトで後で使用するために以前保存した値を選択します。
  • 詳細エディターを開く - VB の式を入力します。
• オプション - クリックして [Generate Table ウィザード] ウィンドウを開きます。

• データ テーブル - データ テーブルの保存場所を選択します。StudioX では、プラス記号のアイコン を使用して、利用可能なオプションを 1 つ選択できます。

  • 親の Excel ファイルまたはプロジェクト ノートブックを選択し、次にデータの保存先とする名前付き範囲、表、またはシートを選択します。または、[Excel 内で示す] を選択して、ファイルから直接選択することもできます。
  • クリップボードにコピー - データをクリップボードに保存します。
  • 後で使用するために保存 - プロジェクト内の別のアクティビティの入力として後から使用できるように、データを保存します。
  • 詳細エディターを開く - VB の式を入力します。

プロパティ

オプション

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

• 表示名 - アクティビティの表示名です。

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

固定書式オプション

• ColumnSizes - 表に作成する列のサイズを指定します。このフィールドは IEnumerable 変数のみをサポートします。

書式オプション

• ColumnSeparators - 列区切り文字として使用する文字を指定します。このフィールドは String 型変数のみをサポートします。
• CSV 解析 - 入力データを CSV として解析する場合に選択します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は「False」です。
• NewLineSeparator - 改行区切り文字として使用する文字を指定します。このフィールドは String 型変数のみをサポートします。

入力

• 入力 - 表に変換する構造化テキストのソースを指定します。このフィールドでは String 型の変数のみがサポートされています。
• 位置 - スクレイピングに OCR を使用し、[Get Words Info] チェック ボックスをオンにした場合、このフィールドには WordsInfo 値を持つ IEnumerable<KeyValuePair<Rectangle,String>> 変数が格納されます。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• DataTable - 生成された表を格納する DataTable 型変数です。

表オプション

• 型を自動検出 - オンの場合は、列または行の型 (String、Int32 など) を自動的に検出します。
• UseColumnHeader - オンの場合は、最初に識別された列を列見出しとして使用します。
• UseRowHeader - オンの場合は、最初に識別された行を行見出しとして使用します。

データ テーブル生成ウィザード

注:

データ テーブル生成ウィザードは、Windows プロジェクトと Windows - レガシ プロジェクトでのみ使用できます。

[オプション...] ボタンをクリックして、データ テーブル生成ウィザードを開きます。これを使用して、結果として生成される表形式を簡単に構成およびプレビューできます。

表オプション

• autoDetect 列の種類 - オンにした場合、列または行の型を自動的に検出します。
• 第 1 行を列ヘッダーとして使用 - オンにした場合は、最初に識別された列を列見出しとして使用します。
• 第 1 列を無視 - オンにした場合、最初に識別された列を無視します。

データの書式設定オプション

• 形式 - 使用する入力形式を選択します。

  • CSV (コンマ区切り値) - 列区切り文字を設定できます。
  • カスタム - 列区切り文字と改行文字を設定できます。
  • 固定幅列 - すべての列の列幅を設定できます。
• 列区切り文字 - 列区切り文字として使用する文字を指定します。
• 改行文字 - 改行文字として使用する文字を指定します。
• プレビュー - クリックして、結果として生成される表形式のプレビューを生成します。

[データ テーブルを生成] アクティビティの使用例

この例では、特定の情報を収めた表を、[データ テーブルを生成] アクティビティを使用して生成する方法を説明します。

サンプルと同等のオートメーション プロセスは以下のように構築できます。

1. Studio を開いて、新しいプロセスを作成します。

2. デザイナー パネルに [シーケンス] コンテナーをドラッグします。

   変数名	変数の型	既定値
   DT1	データ テーブル
   結果	文字列
   名前	GenericValue

3. [シーケンス] コンテナーに、[データ テーブルを生成] アクティビティをドラッグします。

   • [プロパティ] パネルの [CSV 解析] フィールドに値 False を追加します。
   • [改行区切り] フィールドに値 Environment.NewLine を追加します。
   • [入力] フィールドに式 "Name;Surname; John;Doe; James;Liam;" を追加します。
   • [データ テーブル] フィールドに変数 DT1 を追加します。
   • [列ヘッダーを使用] オプションのチェック ボックスを選択します。

4. [オプション...] ボタンをクリックして、データ テーブル生成ウィザードを開きます。

   • [フォーマット] ドロップダウン メニューから [カスタム] オプションを選択します。
   • [列区切り文字] ドロップダウン リストから [セミコロン] オプションを選択します。
   • [改行文字] ドロップダウン リストから [空白] オプションを選択します。
   • [OK] をクリックしてウィザードを終了します。
   • データ テーブル生成ウィザード パネルは次のような表示になります。

     
     

     

     
     

     
     

     

     
     

     6. [データ テーブルを生成] アクティビティの下に [データ テーブルを出力] アクティビティをドラッグします。

   • [プロパティ] パネルで、変数 DT1 を [データ テーブル]
   • [テキスト] フィールドに変数 Result を追加します。

5. [データ テーブルを出力] アクティビティの下に [1 行を書き込み] アクティビティを配置します。

   • [テキスト] フィールドに変数 Result を追加します。
6. プロセスを実行します。ロボットによって、入力データを使用して表が生成されます。

サンプルをダウンロードする