联接数据表

UiPath.Core.Activities.JoinDataTables

描述

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台配置

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

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

  备注：

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

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

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

    如果“数据表 2”中的列与“数据表 1”中的列名称相同，则“数据表 2”中的列名称将在生成的表中更改为“[ColumnName]_1”。如果已存在名为“[ColumnName]_1”的列，则该活动会转用尚未使用的连续数字。例如，如果“数据表 1”中包含名为“ID”、“ID_1”和“ID_2”的列，而“数据表 2”中包含名为“ID”的列，则在联接之后，“数据表 2”中的列名称将变为“ID_3”。

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

Windows - 旧版 Windows 配置

属性面板

常见

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

输入

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

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

其他

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

选项

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

    如果“数据表 2”中的列与“数据表 1”中的列名称相同，则“数据表 2”中的列名称将在生成的表中更改为“[ColumnName]_1”。如果已存在名为“[ColumnName]_1”的列，则该活动会转用尚未使用的连续数字。例如，如果“数据表 1”中包含名为“ID”、“ID_1”和“ID_2”的列，而“数据表 2”中包含名为“ID”的列，则在联接之后，“数据表 2”中的列名称将变为“ID_3”。

输出

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

联接向导

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

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

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

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

• “表 1 的列”- 第一张表中列的名称。该字段仅支持包含列名称的“String”变量、包含列索引的“Int32”变量或“ExcelColumn”变量。
• “运算”- 定义列之间关系的运算。可用的选项如下：
  • “=”- 等于
  • “!=”- 不等于
  • > - Greater than
  • < - Less than
  • >= - Greater than or equal to
  • <= - Less than or equal to
• “表 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. 最终的工作流应如下所示：