筛选数据表

UiPath.Core.Activities.FilterDataTable

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

重要提示：

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

项目兼容性

旧版 | Windows - Legacy（旧版）| Windows - Legacy（旧版）跨平台

跨平台配置

属性

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

高级选项

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

• 筛选后的数据表- 生成的筛选后的数据表。

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

  

Windows - 旧版 Windows 配置

属性

常见

• DisplayName - The display name of the activity. This field supports only strings or String variables.

输入

• “数据表”- 要筛选的“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”按钮则会删除列。
   备注：

   在“向导”中添加列时，其添加顺序与输出表中的列的排列顺序相同。

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

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