データ テーブルをフィルター

UiPath.Core.Activities.FilterDataTable

Filter Wizard ウィンドウで条件を指定して DataTable 変数のフィルター処理を実行できるようにします。このアクティビティでは、ウィザードで指定する論理条件に従って行または列を維持または削除できます。いつでもウィザードにアクセスし、設定をカスタマイズできるよう、アクティビティ本体には Filter Wizard ボタンが含まれています。

重要:

内部的な変更により、このアクティビティが v19.4 以前のバージョンの UiPath.System.Activities で [お気に入り] リストに追加されていた場合、v20.4 以降にアップグレードすると [お気に入り] リストに表示されなくなります。

プロジェクトの対応 OS

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

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

プロパティ

• DataTable - フィルター処理する DataTable 変数です。このフィールドでは DataTable 変数のみサポートされています。
• フィルター条件 - データ テーブルのフィルター処理に使用する条件です。

詳細オプション

• アクション - フィルター処理時にターゲット行を保持するか削除するかを指定します。

• フィルター後のデータテーブル - フィルター処理後のデータ テーブルです。

• 最初の行 - 設定したフィルターに一致する、データ テーブルの最初の行です。

  

Windows - レガシ、Windows での設定

プロパティ

共通

• 表示名 - アクティビティの表示名です。このフィールドでは、文字列または String 型の変数のみがサポートされています。

入力

• DataTable - フィルター処理する DataTable 変数です。このフィールドでは DataTable 変数のみサポートされています。

その他

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

オプション

• FilterRowsMode - 表をフィルター処理する際に対象の行を維持するか削除するかを指定します。 ドロップダウン メニューから [保持] または [削除] を選択します。既定値は [保持] です。
• 列選択モード - 表をフィルター処理する際に対象の列を維持するか削除するかを指定します。ドロップダウン メニューから [保持] または [削除] を選択します。既定値は [保持] です。

出力

• データ テーブル - 結果のフィルター処理された DataTable 変数です。[入力] フィールドの変数と同じ変数を使用すると、最初の変数は上書きされますが、新しい変数を追加しても最初の変数は影響を受けません。このフィールドでは DataTable 変数のみがサポートされています。
  注:

  • カスタマイズした [ データ テーブルをフィルター] アクティビティをコピーして デザイナー パネル内に貼り付けた場合、その設定は保持されません。
  • Excel 範囲はこのアクティビティの入力としてサポートされません。

フィルター ウィザード

このウィザードは、DataTable 変数のフィルター オプションを構築する際に役立ちます。デザイナー パネルのアクティビティの本体内の フィルター ウィザード ボタンを押すと、このウィザードが開きます。次のフィールドから、変更を行う/変更を保存する DataTable を選択できます。

• Input Data Table - フィルター処理する DataTable 変数です。このフィールドでは DataTable 変数のみをサポートします。
• データ テーブルを出力 - 出力の DataTable 変数です。Input フィールドにあるものと同じ変数を使用した場合は、変更内容によって上書きます。別の変数を指定した場合は Input 変数は変更されません。

選択するタブに応じて Row または Column のフィルターを選択できます。次のようにタブは 2 つあります。

Filter Rows タブフィールドの説明

[行をフィルター処理] タブでは、DataTableを行でフィルター処理できます。これを行うには、次のオプションがあります。

1. 一致する行を保持または削除 - 行をフィルター処理する際に行を維持するか削除するかを指定します。指定には、[保持] または [削除] ラジオ ボタンを選択します。[保持] を選択すると、指定した条件を満たす行のみが維持されます。一方、[削除] を選択すると、指定した条件を満たす行が削除されます。
2. And/Or - 条件どうしの間で使用する論理結合を指定します。このボタンは、条件が複数ある場合にのみ表示されます。デフォルトで、新しい条件を追加すると And のボタンが表示されます。そのボタンをクリックして値を Or に変更します。
3. Column - 条件を満たす必要がある列の名前またはインデックスです。
4. Operation - Column と Value の間で満たす必要がある論理条件です。
5. Value - Operation と Column でチェックする値です。
6. 条件の追加/削除 - + ボタンをクリックすると別の文を条件に追加します。x ボタンをクリックすると文を削除します。
   注:

   [列] テキスト ボックスで変数を指定するときは、Int32 変数を使用して列インデックスを指定するか、String 変数を使用して列名を指定できます。

出力

Output Columns タブでは、列によるDataTableのフィルター処理ができます。次のオプションがあります。

1. 列選択モード - 列を保持して削除するかでフィルター処理するかを指定します。これを行うには、[保持] または [削除] ラジオ ボタンを選択します。[保持] を選択すると、以下で指定した列のみが保持されます。[削除] を選択すると、以下で指定した行が入力 DataTable削除されます。
2. 列 - 表示 DataTableに保持または削除する列です。
   注:

   [列] テキスト ボックスに変数を指定する場合、Int32 変数を使用して列インデックスを指定したり、String 変数を使用して列名を指定したりできます。

3. 列の追加/削除 - + ボタンをクリックすると列をもう 1 つ追加します。x ボタンをクリックすると列を削除します。
   注:

   ウィザードで列を追加すると、その順序で出力表に列が配置されます。

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

複数のアクティビティを組み込んだサンプルで [データ テーブルをフィルター] アクティビティを使用する方法を、こちらで紹介しています。