Table コネクタのメソッド

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：19分

    • Table コネクタは、RPA デスクトップデザインスタジオ の自動化 ワークフロー の一部として、表形式データに対してさまざまなアクションを実行する複数のメソッドを提供します たとえば、テーブルの取得、行データの取得、空の行の削除などのタスクです。

    SetTable

    Workflow にテーブルを挿入します。SetTable メソッドは、データテーブルに対して他の処理を行う前に使用する必要があります。設定する必要があるテーブルオブジェクトを指定する必要があります。
    表 : 1. SetTable パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    テーブル 追加または変更するテーブルの名前です。
    例
    DataTable
    		 データ入力 DataTable

    AddColumn

    テーブルに列を追加します。列の位置は、指定した列インデックス値によって決まります。新しい列の名前と、新しい列を追加する必要がある列インデックスを指定する必要があります。
    表 : 2. AddColumn パラメーター
    パラメーター名 説明 データタイプ
    Name (名前) 追加する新しい列の名前。
    例
    顧客データ
    		 文字列
    ColumnIndex 新しい列を追加する必要がある列のインデックス。デフォルトでは、-1 が更新可能なインデックス値です。たとえば、0、1、2 は左から右への列の位置を示すことができます。 整数

    AddColumns

    別のメソッドまたはコンポーネントから列名を受け取って、テーブルに複数の列を追加します。追加された列を表示するには、GetTable メソッドを使用します。データテーブルに追加する必要がある新しい列の名前のリストを指定する必要があります。
    表 : 3. AddColumns パラメーター
    パラメーター名 説明 データタイプ
    名前 アレイ、アレイリスト、またはリストの形式で列の名前を受け入れます。
    例
    { "OrderID", "CustomerName", "OrderDate", "Status"};
    		 IEnumerable

    AddRow

    指定されたインデックスに行とその内容を追加します。行を追加する必要がある RowIndex を指定する必要があります。

    行の内容を追加するインデックス値を設定するには、次のアクションを実行します。

    1. コンポーネント設定アイコン (コンポーネント設定アイコン) をクリックします。
    2. インデックスの追加アイコン (インデックスの追加アイコン) をクリックします 。
    3. インデックスを入力します。
    4. 複数のインデックスを追加するには、手順を繰り返します。
    5. [OK] をクリックします。
      注:
      追加される行ごとに、データ入力ポートが追加されます。
    表 : 4. AddRow パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    RowIndex 新しい行を追加する必要がある行のインデックス。 データ入力 整数

    GetTable

    AddColumn、AddColumns、および AddRow の各メソッドで作成したテーブルを返します。
    注:
    このメソッドは、AddColumn、AddColumns、および AddRow の各メソッドを実行した後に実行する必要があります。
    表 : 5. GetTable パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    DataTable 基になる DataTable オブジェクトを表す DataTable 型を返します。 データ出力 DataTable

    ClearColumns

    テーブルからすべての列の値をクリアします。

    ClearRows

    テーブルからすべての行の値をクリアします。

    DeleteColumnByIndex

    指定されたインデックス値に基づいて、列を削除します。削除する列のインデックスを [インデックス] パラメーターに指定する必要があります。
    表 : 6. DeleteColumnByIndex パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    インデックス 削除する必要がある列のインデックス値。 データ入力 整数

    DeleteColumnByName

    指定された名前に基づいて、列を削除します。削除する必要がある列の名前を指定する必要があります。
    表 : 7. DeleteColumnByName パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    Name (名前) 削除する必要がある列の名前。 データ入力 文字列

    DeleteRow

    指定されたインデックス値に基づいて、行を削除します。このメソッドを実行する前に、カスタムインデックス値を行に割り当てる必要があります。削除する必要がある行のインデックスを指定する必要があります。
    表 : 8. DeleteRow パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    インデックス 削除する必要がある行のインデックス。 データ入力 整数

    FilterAndSort

    指定した式に基づいてテーブルをフィルタリングしてソートします。列の値を計算する式、並べ替える列名、および SortColumnName を指定する必要があります。設定された基準に基づいて利用可能な行の数を返し、完全なデータテーブルも返します。
    表 : 9. FilterAndSort パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    式 列の値を計算する式。
    例
    "Status = 'Pending'" - このクエリ式に基づいて、データがフィルタリングされます。
    		 データ入力 文字列
    SortColumnName メソッドがデータをソートする際に使用する列名です。
    例
    日付 - メソッドは [日付] 列に基づいてデータをソートします。
    		 データ入力 文字列
    順序 列名の順序 データ入力 文字列
    DataTable 基になる DataTable オブジェクトからフィルタリングされたデータを含むデータテーブルを返します。 データ出力 DataTable
    カウント ソート後の行数を返します。 データ出力 整数

    FilterByRegEx

    指定した正規表現または正規表現に基づいてテーブルデータをフィルタリングします。フィルタリングに使用される ColumnIndex パラメーターへの列インデックスと RegExpression パラメーターへの正規表現を指定する必要があります。このメソッドは、行数とデータテーブルを返します。
    表 : 10. FilterByRegEx パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    ColumnIndex フィルタリングロジックを適用する必要がある列のインデックス。最初の列のデフォルトのインデックス値は -1 です。カスタムインデックス値の指定はオプションです。フィールドがカスタムインデックス値を受け取らない場合は、メソッドが自動的に列の順序を設定します。 データ入力 整数
    正規表現 フィルタリングロジックとして使用される正規表現。 データ入力 文字列
    戻る 基になる DataTable オブジェクトからフィルター処理されたデータを含む DataTable を返します。 データ出力 DataTable
    RowsCount 正規表現を使用して、フィルターに基づいて利用可能な行の数を返します。 データ出力 整数

    FindText

    1 つ以上の条件に基づいて指定したテーブル内のテキストを検索し、セル値を返します。SearchText パラメーターで検索するテキスト、StartPosition で検索を開始する位置、および必要な一致の種類を指定する必要があります。
    表 : 11. FindText パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    SearchText テーブル内で検索するテキスト。
    例
    「ジョン・ドウ」
    		 データ入力 文字列
    StartPosition 検索を開始する列の位置。 データ入力 整数
    MatchType テキストの一致タイプ:
    • ExactMatch:指定されたテキストと検索されたテキストは完全に一致する必要があります。これはデフォルト値です。
    • [MatchCase]：指定されたテキストの大文字と小文字は検索されたテキストの大文字と小文字と一致する必要があります。
    • [Contains]：指定されたテキストは、検索されたテキストを 1 文字以上含んでいる必要があります。
    		 データ入力 MatchType
    CellValue 検索に基づいて、セル内の値を返します。 データ出力 オブジェクト
    ColIndex その検索されたテキストを含む列のインデックスを返します。 データ出力 整数
    RowIndex その検索されたテキストを含む行のインデックスを返します。 データ出力 整数

    GetCellValue

    指定された行と列のインデックス値に基づいて、セルの値を返します。値を取得する必要があるセルの行番号と列番号を指定する必要があります。
    表 : 12. GetCellValue パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    行 必要なセルの行番号。 データ入力 整数
    列 必要なセルの列番号。 データ入力 整数
    戻る 基になる DataTable オブジェクトからセル値を表すオブジェクト型を返します。 データ出力 オブジェクト

    GetCellValueIfRowHas

    メソッドが指定されたテキストと、指定されたインデックス値に基づく行の値を見つけた場合に True を返します。検索するテキストを指定する必要があります。SearchColumnIndex で指定された特定の列で検索を実行し、StartRowIndex で指定された特定の行からテキストの検索を開始します。デフォルト値は 1 で、テーブルの 1 行目を意味します。

    行の値を指定するには、メソッドを設定する必要があります。

    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. 行インデックスの追加アイコン (行インデックスの追加アイコン) をクリックします 。
    3. 行インデックス値のデータタイプを更新します。
    4. 行インデックス値を入力します。
    5. [OK] をクリックします。
    表 : 13. GetCellValueIfRowHas パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    SearchText 行内で検索するテキスト。
    例
    「ジョン・ドウ」
    		 データ入力 文字列
    SearchColumnIndex テキストを検索する必要がある列のインデックス。 データ入力 整数
    StartRowIndex 検索を実行する必要がある開始行。 データ入力 整数
    見つからない テキストが一致した場合は True を返します。 データ出力 ブール

    GetCellValues

    指定したインデックス値に基づいて、複数のセルの値を返します。値を取得する必要があるセルの行インデックスを指定する必要があります。行インデックスを追加して、構成ウィンドウを使用してこれらのセル値を取得することもできます。

    設定するには、次の手順を実行します。

    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. 行インデックスの追加アイコン (行インデックスの追加アイコン) をクリックします 。
    3. 行インデックス値のデータタイプを更新します。
    4. 行インデックス値を入力します。
    5. [OK] をクリックします。
    表 : 14. GetCellValue パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    RowIndex セル値が必要な行のインデックス。 データ入力 整数

    GetCount

    データテーブルの行と列の合計数を返します。

    表 : 15. GetCount パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    Row (行) 作成された行の合計数を返します。 データ出力 整数
    Column (列) 作成された列の合計数を返します。 データ出力 整数

    GetRowData

    指定されたインデックス値に基づいて行データを返します。データを取得する必要がある行のインデックス値を指定する必要があります。
    表 : 16. GetRowData パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    RowIndex データを取得する必要がある行のインデックス値。 データ入力 整数
    戻る 基になる DataTable オブジェクトから行データを表すオブジェクトタイプのリストを返します。IEnumerable データ型は、行の値データをアレイ、リスト、アレイリストとして受け取り、オブジェクトとして返します。 データ出力 IEnumerable

    GetTableAsCSV

    テーブルデータを CSV 形式でローカルドライブに保存します。CSV ファイルを書き込む必要があるファイルパスを指定し、2 つのレコード間のセパレーターも指定する必要があります。
    表 : 17. GetTableAsCSV パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    Filepath メソッドがテーブルデータを CSV として保存するローカルドライブ内のフォルダーパス。ファイルパスには、ファイル名を含める必要があります。
    例
    D:\Projects\Customer data.csv
    		 データ入力 文字列
    Delimiter テーブルデータを区切る区切り文字です。
    例
    カンマ (,)
    		 データ入力 文字列

    GetTableAsHTML

    テーブルデータを HTML ファイル形式で返します。このメソッドを実行する前に、列、行、およびデータを作成し、GetTable メソッドで実行する必要があります。
    表 : 18. GetTableAsHTML パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    戻る 表形式データを HTML 形式で返します。 データ入力 文字列

    GetTableAsJson

    テーブルデータを JSON ファイル形式で返します。このメソッドを実行する前に、列、行、およびデータを作成し、GetTable メソッドで実行する必要があります。
    表 : 19. GetTableAsJson パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    戻る 表形式データを JSON オブジェクトとして返します。 データ入力 文字列

    LoadFromExcel

    指定された Excel ファイルからデータテーブルにシートまたはデータをインポートします。データをロードする必要がある Excel ファイルのパスを指定する必要があります。シート名を指定するか、SheetOrQuery パラメーターにクエリを指定します。クエリが指定されている場合は IsQuery ブール値を True に設定し、シート名が指定されている場合は IsQuery ブール値を False に設定します。GetTable メソッドを使用して、データが正しくインポートされたかどうかをテストできます。
    表 : 20. LoadFromExcel パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    FilePath データがインポートされる元となる Excel ファイルへのパスです。
    D:\Projects\Sales\Sales data.xlsx
    		 データ入力 文字列
    SheetOrQuery データが Excel ファイルのシートからインポートされるか、ファイルへのクエリを介してインポートされるかを示します。 データ入力 文字列
    IsQuery データがクエリを介してロードされるかどうかを示すブール値です。 データ入力 ブール

    MatchColumn

    列インデックスに基づいて、別のデータテーブルの列を現在のテーブルの列と照合します。dtTable で指定された列を、ColumnIndex パラメーターの現在のテーブルの列のインデックスと一致させる必要があるデータテーブルを指定する必要があります。このメソッドを実行する前に、GetTable メソッドを実行する必要があります。
    表 : 21. MatchColumn パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    dtTable 列を一致させる必要があるデータテーブル。 データ入力 DataTable
    ColumnIndex 一致する必要がある列のインデックス。 データ入力 整数
    戻る 指定した列が一致するかどうかを示す true または false の値を返します。 データ出力 ブール

    RemoveEmptyColumn

    テーブル内のすべての空の列を削除し、操作後のデータテーブルを返します。
    表 : 22. RemoveEmptyColumns パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    戻る 空の列を削除した後のデータテーブルを返します。 データ出力 DataTable

    RemoveEmptyRow

    テーブル内のすべての空の行を削除し、操作後のデータテーブルを返します。
    表 : 23. RemoveEmptyRows パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    戻る 空の行を削除した後のデータテーブルを返します。 データ出力 DataTable

    SetCellValue

    列と行のインデックス値に基づいてセルにデータを追加します。設定する必要がある行番号、列番号、および値パラメーターに値を指定する必要があります。

    このメソッドを実行する前に、列、行、およびデータを作成し、GetTable メソッドで実行する必要があります。

    表 : 24. SetCellValue パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    行 メソッドがデータを入力するために使用する行のインデックス番号です。 データ入力 整数
    列 メソッドがデータを入力するために使用する列のインデックス番号です。 データ入力 整数
    値 セルに設定する必要がある値。 データ入力 オブジェクト

    SetCellValueIfRowHas

    行に指定されたテキストが含まれている場合、特定の行のセル値を設定します。行インデックスは、[行インデックス構成 (Row Index configuration)] ダイアログで指定する必要があります。追加された行インデックスパラメーターの名前は値の設定で考慮され、そのパラメーターに指定された値は、テーブルの行に設定される実際の値です。
    表 : 25. SetCellValueIfRowHas パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    SearchText 行内で検索するテキスト。 データ入力 文字列
    SearchColumnIndex テキストを検索する必要がある列のインデックス。 データ入力 整数
    StartRowIndex テキストを検索する必要がある開始行。 データ入力 整数
    見つからない テキストが一致する場合は True を返します。 データ出力 ブール

    SetColumnName

    指定された列インデックスと名前に基づいて、列名を更新します。まず、SetTable メソッドを使用してテーブルを作成またはインポートする必要があります。
    表 : 26. SetColumnName パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    ColumnIndex 名前を付ける必要がある列のインデックス。 データ入力 整数
    Name (名前) 列の新しい名前です。 データ入力 文字列

    SetJson

    JSON オブジェクトを DataTable に変換します。DataTable に変換する必要がある JSON データを指定します。
    ヒント:
    JSON オブジェクトを作成するには、GetTableAsJson メソッドを使用して、値を SetJson メソッドに渡します。
    表 : 27. SetJson パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    JSON JSON オブジェクトを DataTable に変換する必要があります。 データ入力 文字列

    SetList

    リストを DataTable に変換します。テーブルに変換する必要があるデータリストを指定します。
    表 : 28. SetList パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    データ テーブルに変換する必要があるリストタイプのデータ。IEnumerable 入力データ型は、データをアレイ、リスト、またはアレイリストとして受け入れます。
    { "OrderID": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "出荷済み" };
    		 データ入力 IEnumerable

    SetRowData

    指定された行データをデータテーブルに挿入します。行のインデックス番号を RowIndex パラメーターに指定し、行に追加する必要があるデータを Data パラメーターに指定する必要があります。
    表 : 29. SetRowData パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    RowIndex 変更する必要がある行のインデックス番号。 データ入力 整数
    データ データテーブルに挿入される行のデータ。IEnumerable 入力データ型は、データをアレイ、リスト、またはアレイリストとして受け入れます。
    { "OrderID": 102, "CustomerName": "John Doe", "OrderDate": "2024-02-02", "Status": "出荷済み" };
    		 データ入力 IEnumerable

    ToList

    指定されたテーブルをリストに変換します。
    表 : 30. ToList パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    戻る List に変換された DataTable オブジェクトを表す IEnumerable を返します。IEnumerable データ型は、データをアレイ、リスト、またはアレイリストとして受け入れ、リストを返します。 データ出力 IEnumerable

    VLookUp

    行に指定されたテキストが含まれている場合、特定の行のセル値を取得します。

    値を入力するには、次の手順を行います。
    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. 値を追加アイコンをクリックします。
    3. 値を入力します。
    4. [OK] をクリックします。
    表 : 31. VLookUp パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    ポート名 コンポーネントのポートの名前です。 データ入力 文字列
    SearchText メソッドが行と列で検索するテキストです。 データ入力 文字列
    データ列インデックス 列の左からの順序を示す整数値です。最初の列のデフォルトのインデックス値は -1 です。カスタムインデックス値の指定はオプションです。フィールドがカスタムインデックス値を受け取らない場合は、メソッドが自動的に列の順序を設定します。 データ入力 整数
    SearchColumnIndex 列の左からの順序を示す整数値です。最初の列のデフォルトのインデックス値は -1 です。カスタムインデックス値の指定はオプションです。フィールドがカスタムインデックス値を受け取らない場合は、メソッドが自動的に列の順序を設定します。 データ入力 整数
    StartRowIndex 列の左からの順序を示す整数値です。最初の行のデフォルトのインデックス値は -1 です。カスタムインデックス値の指定はオプションです。フィールドがカスタムインデックス値を受け取らない場合は、メソッドが自動的に列の順序を設定します。 データ入力 整数

    VLookUpSet

    行に指定されたテキストが含まれている場合、特定の行のセル値を設定します。

    値を入力するには、次の手順を行います。
    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. 値を追加アイコンをクリックします。
    3. 値を入力します。
    4. [OK] をクリックします。
    表 : 32. VLookUpSet パラメーター
    パラメーター名 説明 データポートタイプ データタイプ
    ポート名 コンポーネントのポートの名前です。 データ入力 文字列
    SearchText メソッドが行と列で検索するテキストです。 データ入力 文字列
    データ列インデックス 列の左からの順序を示す整数値です。最初の列のデフォルトのインデックス値は -1 です。カスタムインデックス値の指定はオプションです。フィールドがカスタムインデックス値を受け取らない場合は、メソッドが自動的に列の順序を設定します。 データ入力 整数
    SearchColumnIndex 列の左からの順序を示す整数値です。最初の列のデフォルトのインデックス値は -1 です。カスタムインデックス値の指定はオプションです。フィールドがカスタムインデックス値を受け取らない場合は、メソッドが自動的に列の順序を設定します。 データ入力 整数
    StartRowIndex 列の左からの順序を示す整数値です。最初の行のデフォルトのインデックス値は -1 です。カスタムインデックス値の指定はオプションです。フィールドがカスタムインデックス値を受け取らない場合は、メソッドが自動的に列の順序を設定します。 データ入力 整数