联接数据表

UiPath.Core.Activities.JoinDataTables

描述

该活动会根据联接类型属性中指定的“联接”规则，并使用两张表共有的值来合并两张表格中的行。

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台配置

• 数据表 1- 要在“联接”操作中使用的第一张表，存储在 DataTable 变量中。此字段仅支持 DataTable 变量。

• 数据表 2- 要在“联接”操作中使用的第二张表，存储在 DataTable 变量中。此字段仅支持 DataTable 变量。

备注：两张表的提供顺序非常重要，因为这会影响最终生成的表的结构，具体取决于联接类型属性字段中所选的选项。

• 联接类型 - 要使用的“联接”操作类型。可用的选项如下：可选择以下选项：

  • 内部 - 保留数据表 1和数据表 2中所有满足“联接”规则的行。所有不符合规则的行均会从生成的表中删除。
  • 左侧 - 保留数据表 1中的所有行以及数据表 2中仅满足“联接”规则的值。对于在数据表 2中不存在匹配项的数据表 1的行，将 null 值插入相应列中。

  • 全部 - 保留数据表·1和数据表 2中的所有行，不考虑是否满足“联接”条件。将 null 值插入两张表中不存在匹配项的行。

    注意： 如果DataTable2中的列与 DataTable1 中的列同名，则 DataTable2 中的列名称在生成的表格中更改为 [ColumnName]_1 。 如果名称为 [ColumnName]_1 的列已存在，则使用尚未使用的连续编号。 例如，如果 DataTable1 具有名为 ID、 ID_1 和 ID_2的列，并且 DataTable2 具有名为 ID的列，则在联接后， DataTable2 中的列名为 ID_3。

• 联接规则 - 联接表格的条件。 选择字段将打开一个简单的“筛选器生成器”，您可以在其中添加构成筛选器的规则。

Windows - 旧版 Windows 配置

属性面板

常见

• “显示名称”- 活动的显示名称。

输入

• 数据表 1- 要在“联接”操作中使用的第一张表，存储在 DataTable 变量中。此字段仅支持 DataTable 变量。
• 数据表 2- 要在“联接”操作中使用的第二张表，存储在 DataTable 变量中。此字段仅支持 DataTable 变量。
  备注：两张表的提供顺序非常重要，因为这会影响最终生成的表的结构，具体取决于联接类型属性字段中所选的选项。

其他

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

选项

• 联接类型 - 要使用的“联接”操作类型。可用的选项如下：可选择以下选项：

  • 内部 - 保留数据表 1和数据表 2中所有满足“联接”规则的行。所有不符合规则的行均会从生成的表中删除。
  • 左侧 - 保留数据表 1中的所有行以及数据表 2中仅满足“联接”规则的值。对于在数据表 2中不存在匹配项的数据表 1的行，将 null 值插入相应列中。

  • 全部 - 保留数据表·1和数据表 2中的所有行，不考虑是否满足“联接”条件。将 null 值插入两张表中不存在匹配项的行。

    注意： 如果DataTable2中的列与 DataTable1 中的列同名，则 DataTable2 中的列名称在生成的表格中更改为 [ColumnName]_1 。 如果名称为 [ColumnName]_1 的列已存在，则使用尚未使用的连续编号。 例如，如果 DataTable1 具有名为 ID、 ID_1 和 ID_2的列，并且 DataTable2 具有名为 ID的列，则在联接后， DataTable2 中的列名为 ID_3。

输出

• 数据表 - 此为包含已联接的值的表格，存储在 DataTable 变量中。此字段仅支持 DataTable 变量。

联接向导

此向导可帮助您配置联接数据表活动的属性。您可前往设计器面板，然后使用活动主体内的联接向导按钮打开该向导。

在向导上半部分，您可以从以下字段中同时选择要在联接操作中使用的“DataTable”变量、“联接”类型和输出变量：

• 输入数据表 1 - 此为包含要使用的第一张表的 DataTable 变量。
• 输入数据表 2 - 此为包含要使用的第二张表的 DataTable 变量。
• 输出数据表 - 此为要在其中存储最终生成的表的 DataTable 变量。
• 联接类型 - 要使用的“联接”操作类型。可用的选项如下：可选择以下选项：
• 内部 - 保留数据表 1和数据表 2中所有满足“联接”规则的行。所有不符合规则的行均会从生成的表中删除。
• 左侧 - 保留数据表 1中的所有行以及数据表 2中仅满足“联接”规则的值。对于在数据表 2中不存在匹配项的数据表 1的行，将 null 值插入相应列中。
• 全部 - 保留数据表·1和数据表 2中的所有行，不考虑是否满足“联接”条件。将 null 值插入两张表中不存在匹配项的行。

在向导下半部分，您可以通过添加表示列之间关系的表达式来配置最终生成的表的结构。每个表达式均包含如下三个元素：

• 表 1 的列 - 第一张表中列的名称。该字段仅支持包含列名称的 String 变量、包含列索引的 Int32 变量或 ExcelColumn 变量。

• 运算 - 定义列之间关系的运算。可选择以下选项：

  • = - 等于
  • != - 不等于
  • > - 大于
  • < - 小于
  • >= - 大于或等于
  • <= - 小于或等于
• 表 2 的列 - 第二张表中列的名称。该字段仅支持包含列名称的 String 变量、包含列索引的 Int32 变量或 ExcelColumn 变量。

“联接数据表”活动使用示例

为举例说明如何使用此活动，我们创建了一个项目，用于将工作簿的两张工作表联接到该工作簿的另一张工作表中。第一个工作表包含有关订单的详细信息，而第二个工作表包含有关客户的详细信息。这两个工作表有一个公共列 CustomerID，用于联接操作。该项目可从此处下载。

1. 创建空项目。
2. 将序列容器拖动至设计器面板。
3. 拖动 Excel 应用程序作用域并将 Excel 工作簿路径置于工作簿路径属性中。
4. 创建两个 DataTable 变量，一个用于客户工作表，另一个用于订单工作表。
5. 在 Excel 应用程序作用域内，拖动两个读取范围活动。
6. 设置两个读取范围活动以读取 Excel 工作簿中的这两张工作表，并将工作表存储在相应的变量中。
7. 创建“DataTable”变量来存储生成的表格。
8. 在作用域容器中拖动联接数据表活动。
9. 单击活动主体内的“联接向导”按钮。联接数据表向导随即打开。
10. 在输入数据表 1字段中设置包含“客户”工作表的变量。
11. 在输入数据表 2字段中设置包含“订单”工作表的变量。
12. 在输出数据表字段中设置为存储生成的表格而创建的变量。
13. 在联接类型下拉菜单中，选择内部。
14. 在“表 1 的列”字段中，输入与“客户”工作表中的“客户 ID”列对应的列。
15. 在运算下拉菜单中，选择=。

16. 在表 2 的列字段中，输入与“客户”工作表中的客户 ID 列对应的列。文本应如下所示：

    
    

    

    
    
17. 将写入范围活动拖动至设计器面板。
18. 配置写入范围以将包含最终生成的表的 DataTable 变量写入初始工作簿中的新工作表。

19. 最终的工作流应如下所示：