筛选数据表

UiPath.Core.Activities.FilterDataTable

用于在筛选器向导窗口中指定条件来筛选 DataTable 变量。此活动可以根据在该向导中指定的逻辑条件保留或删除行或列。活动主体包含筛选器向导按钮，便于您随时访问向导并自定义设置。

重要提示： 由于内部更改，如果在使用 UiPath.System.Activities v19.4 或更旧版本的“收藏夹”列表中添加此活动，则在升级到 v20.4 或更高版本时，“收藏夹”列表中将不再显示这些活动。

项目兼容性

Windows - 旧版 | 跨平台

跨平台配置

属性

• 数据表- 要筛选的 DataTable 变量。此字段仅支持 DataTable 变量。
• 筛选条件 - 用于筛选数据表的条件。

高级选项

• 操作 - 指定是通过保留还是删除目标行来筛选表。
• 筛选的数据表 - 生成的筛选数据表。

• 第一行 - 与配置的筛选条件匹配的数据表第一行。

  
  

  

  
  

Windows - 旧版 Windows 配置

属性

常见

• “显示名称 ” - 活动的显示名称。 此字段仅支持字符串或 String 变量。

输入

• 数据表- 要筛选的 DataTable 变量。此字段仅支持 DataTable 变量。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

• “筛选行模式 ” - 指定是通过保留还是删除目标行来筛选表格。 从下拉菜单中选择以下两个选项之一： 保留 或 删除。 默认值为 “保留”。
• 列选择模式 - 指定通过保留或删除目标列来筛选表格。从下拉菜单中选择以下两个选项之一： 保留或删除。默认值为保留。

输出

• 数据表 - 最终筛选出的 DataTable 变量。若使用与“输入”字段中相同的变量，则系统会覆盖初始变量，但添加新变量不会影响初始变量。此字段仅支持 DataTable 变量。
  备注：

  • 若在设计器面板内复制并粘贴自定义筛选数据表活动，则其不会保留自有配置。
  • 此活动不支持将 Excel 范围作为输入。

筛选器向导

此向导有助于构建 DataTable 变量的筛选选项。您可前往“设计器”面板，然后使用活动主体内的“筛选器向导”按钮打开该向导。您可以从以下字段中选择要修改的 DataTable 以及要在其中保存更改的数据表：

• “输入数据表”- 要筛选的 DataTable 变量。此字段仅支持 DataTable 变量。
• “输出数据表”- 输出的 DataTable 变量。若您使用与“输入”字段中的现有变量相同的变量，则系统会根据此次更改覆盖该变量。提供不同变量则不会导致“输入”变量发生更改。

您还可以选择按行或列进行筛选，具体取决于所选的选项卡。有如下两个选项卡：

行筛选选项卡字段描述

“筛选行”选项卡可让您按行筛选 DataTable。为此，您可以使用以下选项:

1. 保留或删除匹配的行- 指定通过保留或删除来筛选行。这可以通过选择保留或删除单选按钮来完成。选择保留仅保留符合指定条件的行，而选择删除将删除符合指定条件的行。
2. And/Or - 指定要在条件之间使用的逻辑。仅当您有多个条件时，系统才会显示此按钮。默认情况下，当您添加新条件时，按钮将显示为 And。单击按钮以将其值更改为 Or。
3. 列- 满足条件的列的名称或索引。
4. 运算 - 列和值之间要满足的逻辑条件。
5. 值- 要使用运算和列检查的值。
6. 添加/删除条件 - 单击 + 按钮可在条件中另添一个句子，而单击 x 按钮则会删除句子。
   注意：在“列”文本框中提供变量时，您可使用 Int32 变量指定“列索引”，或使用 String 变量指定“列名称”。

输出

输出列选项卡可让您按列筛选 DataTable。为此，您可以使用以下选项:

1. 列选择模式 - 指定通过保留或删除列来筛选列。这可以通过选择“保留”或“删除”单选按钮来完成。若选择“保留”，则系统只会保留下方指定的列；若选择“删除”，则系统会从输入 DataTable 中删除下方指定的行。
2. 列 - 要在 DataTable 中保留或删除的列。
   注意：在列文本框中提供变量时，您可使用 Int32 变量指定“列索引”，或使用 String 变量指定列名称。
3. 添加/删除列 - 单击 + 按钮可另添一列，而按 x 按钮则会删除列。
   注意：在“向导”中添加列时，其添加顺序与输出表中的列的排列顺序相同。

“数据表排序”活动使用示例

您 可以在此查看包含多个活动的示例，了解如何使用 筛选数据表 活动。