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

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 変数です。Input フィールドのいずれかの変数と同じ変数を使用すると最初の変数が上書きされますが、新しい変数を追加すると最初の変数はそのままになります。このフィールドでは 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 変数を使用して列名を指定できます。

出力

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

1. Columns Selection Mode - 列をフィルター処理する際に列を維持するか削除するかを指定します。指定には、Keep または Remove ラジオ ボタンを選択します。Keep を選択すると、下で指定した列のみが維持されます。一方、Remove を選択すると、入力 DataTable から下で指定した列が削除されます。
2. 列 - DataTable で維持または削除する列です。
   注: [列] テキスト ボックスで変数を指定するときは、Int32 変数を使用して列インデックスを指定するか、String 変数を使用して列名を指定できます。
3. 列の追加/削除 - + ボタンをクリックすると列をもう 1 つ追加します。x ボタンをクリックすると列を削除します。
   注: ウィザードで列を追加すると、その順序で出力表に列が配置されます。

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

複数のアクティビティの中で [データ テーブルをフィルター] アクティビティが使用されている例を、こちらから確認できます。