UiPath データテーブルを検索アクティビティ

2020年4月1日2020年10月5日

「データテーブルを検索」はデータテーブルに検索条件を指定し

条件に一致する行の列を表示するアクティビティです。

この記事では使い方を紹介します。

アクティビティの使い方

「プログラミング」、「データテーブル」より

「データテーブルを検索」をデザイナーパネルの中にドロップします。

次にプロパティを下記のように設定します。

プロパティ	データ型	内容
ターゲット列-列名	String	検索結果として取得する列を指定
入力-データテーブル	DataTable	検索対象のデータテーブルを指定
入力-ルックアップ値	String	検索する値を指定。数値でも文字列("で囲む)で指定
出力-セル値	Object	検索結果の値を格納する変数を指定
出力-行数	Int32	検索結果が何行目かを格納する列を指定。先頭行は0。指定なしで可
検索列-列名	String	ルックアップ値を探す列を指定

代表的なプロパティ

例として下記のデータテーブルを検索します。

名前はString型で数量はInt32型です。

名前の"あいうえお"と"かきくけこ"はそれぞれ2行存在します。

入力-データテーブルの例

条件関係のプロパティを下のように設定します。

プロパティの設定例

この条件でシーケンスを実行すると、名前"かきくけこ"に最初に該当する2行目の

数量の2が出力-セル値に指定した変数に格納され、

1（先頭行が0なので行数-1）が出力-行数に指定した変数に格納されます。

セル値はObject型のため適宜、データ型を変換する必要があります。

デザイナーパネル上の表示名を設定します。

項目名	説明
データテーブル	検索する対象のDataTable型変数を指定します。
ルックアップ値	検索する値を文字列を指定します。検索列が検索対象です。検索列が数値(Int32)の場合も"15"のように文字列で指定します。検索は完全一致のみで、部分一致は不可能です。

項目名	説明
セル値	検索に合致する行のターゲット列の内容を格納するObject型変数を指定します。 Object型変数のままでは利用できないため適宜、データ型を変換する必要があります。
行インデックス	検索に合致する行数（先頭行を0）を格納するInt32型変数を指定します。

3項目のうち1項目のみを設定します。

（2項目以上、値を入力するとエラー）

項目名	説明
列	検索結果の取得列を、 DataColumn型で指定します。たとえばDataCulumn型の変数を用意して代入アクティビティの右辺値(Value)にデータテーブル変数.Columns(インデックスの整数) またはデータテーブル変数.Columns(列名の文字列) を指定して列を変数として格納し、列プロパティに指定すると可能です。実質、インデックスや名前を指定するのと同じで回り道をしているためこれだけの用事では使用しません。他に列変数に用事がある場合にのみこのプロパティを使用するでしょう。
列インデックス	検索結果の取得列を、最も左の列を0とした連番の数値で指定します。
列名	検索結果の取得列を、文字列（"で囲むかString型変数）で列名を指定します。

3項目のうち1項目のみを設定します。

（2項目以上、値を入力するとエラー）

項目名	説明
列	検索の対象列を、 DataColumn型で指定します。たとえばDataCulumn型の変数を用意して代入アクティビティの右辺値(Value)にデータテーブル変数.Columns(インデックスの整数) またはデータテーブル変数.Columns(列名の文字列) を指定して列を変数として格納し、列プロパティに指定すると可能です。実質、インデックスや名前を指定するのと同じで回り道をしているためこれだけの用事では使用しません。他に列変数に用事がある場合にのみこのプロパティを使用するでしょう。
列インデックス	検索の対象列を、最も左の列を0とした連番の数値で指定します。
列名	検索の対象列を、文字列（"で囲むかString型変数）で列名を指定します。

UiPathのログに引数や変数の値が表示されるかを指定します。

機密性の高い情報を取り扱う場合にのみチェックする必要があります。

クリックで開閉

UiPath データテーブル(DataTable)についての説明と関連記事一覧