XML Group 端口

XML Group 端口处理相关 XML 记录集合，并按列对其进行分组，以实现高效的数据管理和分析。

核心功能

支持层级 XML 记录分组与聚合，可按键分组并使用多个分组键
支持通过 XPath 识别并执行 MIN、MAX、SUM、AVG、COUNT 和 CONCATENATE 等聚合函数
在添加汇总和分组元素的同时保留原始记录结构

概述

XML Group 端口通过聚合、验证和转换结构化数据来处理相关 XML 记录集合，以便与各种系统无缝集成。它能够高效处理层级 XML 数据，确保数据交换、报告和自动化工作流等应用之间的一致性和互操作性。

端口配置

本节包含所有可配置的端口属性。

组配置选项卡

与配置组相关的设置。

示例文件

使用 示例文件 切换按钮指定示例文件，使端口能够提供有关文档的更多上下文。有关更多信息，请参阅使用示例文件。

设置	说明
示例文件	选择现有示例文件，或上传新文件。

循环设置

与端口应使用的 XPath 相关的设置，该 XPath 表示输入文档中的单条记录；同时还包括用于保存每组相关记录的 XML 元素。

设置	说明
元素名称	输出文件中用于分组的 XML 元素名称。
记录 XPath	输入中的哪个 XPath 应代表单条记录。

分组设置

定义每条记录中哪些元素用于确定每个组键值的设置。有关更多信息，请参阅使用分组设置。

设置	说明
元素名称	告诉端口在输出文件中用于分组的 XML 元素应命名为什么。这通常与键 XPath 指向的输入文件元素名称相同，但也可以使用不同名称。
键 XPath	输入文件中要用作 key（分组依据）的元素的 XPath。键 XPath 相对于记录 XPath。
添加键 XPath	点击此按钮以定义其他键。

聚合设置

使用 聚合设置 切换按钮查看用于定义如何汇总每个组中记录的设置。有关更多信息，请参阅使用聚合设置。

设置	说明
元素名称	用于汇总记录的 XPath 名称。
函数	用作聚合的函数。可从 MIN、MAX、SUM、AVG、COUNT 和 CONCATENATE 中选择。
XPath	要聚合的元素的相对 XPath。
添加聚合 XPath	点击此按钮以添加更多聚合 XPath。

排序依据设置

使用 排序依据 切换按钮查看用于定义如何对每个组中的记录进行排序的设置。

设置	说明
XPath	用于排序的元素的相对 XPath。
排序依据	按升序还是降序排序。
添加排序依据 XPath	点击此按钮以添加更多用于排序的 XPath。

设置选项卡

配置

与建立连接相关的设置。

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

设置	说明
发送	勾选此项，使端口在组准备就绪后自动发送。

性能

警报选项卡

SLA 选项卡

高级选项卡

消息

日志

其他设置

设置	说明
处理延迟	放入交易选项卡的文件在处理前延迟的时间（秒）。这是一个旧版设置。最佳实践是使用 File 端口来管理本地文件系统，而不是使用此设置。

杂项

使用示例文件

开启 示例文件 以上传一个示例输入 XML，该 XML 模拟将传递到端口中的 XML 输入。启用后，它会为 UI 中的每个 XPath 字段提供 XPath 助手，从而更容易查看文档结构并选择正确的 XPath。根据 XPath 在端口中代表的内容，只能点击符合条件的 XML 元素。例如，在 循环设置 中，只能选择父元素，因为期望这些元素代表一条记录。

然后，在 分组设置 中，可见元素是 循环设置 父元素的子元素，因为期望 key 元素是父记录的子元素。

使用分组设置

分组设置定义每条记录中用于确定每个组键值的元素。键通常是 Id 值，例如 CustomerID 或 InvoiceID。可以有多个键，它们会作为循环设置中设置的元素名称和 XPath 的子项出现。

元素名称 告诉端口在输出文件中用于分组的 XML 元素应命名为什么。这通常与键 XPath 指向的输入文件元素名称相同，但也可以使用不同名称。
键 XPath 是输入文件中要用作 key（分组依据）的元素的 XPath。键 XPath 相对于 记录 XPath。

例如，在以下 XML 中，<MaterialCode> 元素是键。这样就可以在输出中将 ALPHA、BRAVO 和 CHARLIE 的所有出现项分组在一起，而不是分别出现多个重复项。

<Items>
    <Invoice>
        <InvoiceDetail>
            <MaterialCode>ALPHA</MaterialCode>
            <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
            <NetAmount>1000.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>ALPHA</MaterialCode>
            <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
            <NetAmount>2000.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>BRAVO</MaterialCode>
            <MaterialCodeDescription>Bravo Materials</MaterialCodeDescription>
            <NetAmount>100.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>CHARLIE</MaterialCode>
            <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
            <NetAmount>500.00</NetAmount>
        </InvoiceDetail>
        <InvoiceDetail>
            <MaterialCode>CHARLIE</MaterialCode>
            <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
            <NetAmount>100.00</NetAmount>
        </InvoiceDetail>
    </Invoice>
</Items>

使用聚合设置

聚合设置控制端口应如何聚合数据。可以定义一个 XPath，其中包含要执行操作运算符（MIN、MAX、SUM、AVG、COUNT、CONCATENATE）的值，然后端口会对组中的所有记录执行该运算符。一个常见示例是对每条记录的价格求和。以下示例使用前面图片中描述的 循环设置 和 分组设置，以及以下 聚合设置：

使用上一节中的 XML 会生成一个输出 XML，其中每个键元素（MaterialCode）都有一个 InvoiceDetailGroup。每个 InvoiceDetailGroup 内都有来自 分组设置 的 MaterialCode 键，以及来自 聚合设置 的计算结果 NetAmountSUM。最后，还会包含原始的 InvoiceDetail 元素及其子元素：

<Items>
  <Invoice>
    <InvoiceDetailGroup>
      <MaterialCode>ALPHA</MaterialCode>
      <NetAmountSUM>3000</NetAmountSUM>
      <InvoiceDetail>
        <MaterialCode>ALPHA</MaterialCode>
        <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
        <NetAmount>1000.00</NetAmount>
      </InvoiceDetail>
      <InvoiceDetail>
        <MaterialCode>ALPHA</MaterialCode>
        <MaterialCodeDescription>Alpha Materials</MaterialCodeDescription>
        <NetAmount>2000.00</NetAmount>
      </InvoiceDetail>
    </InvoiceDetailGroup>
    <InvoiceDetailGroup>
      <MaterialCode>BRAVO</MaterialCode>
      <NetAmountSUM>100.00</NetAmountSUM>
      <InvoiceDetail>
        <MaterialCode>BRAVO</MaterialCode>
        <MaterialCodeDescription>Bravo Materials</MaterialCodeDescription>
        <NetAmount>100.00</NetAmount>
      </InvoiceDetail>
    </InvoiceDetailGroup>
    <InvoiceDetailGroup>
      <MaterialCode>CHARLIE</MaterialCode>
      <NetAmountSUM>600</NetAmountSUM>
      <InvoiceDetail>
        <MaterialCode>CHARLIE</MaterialCode>
        <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
        <NetAmount>500.00</NetAmount>
      </InvoiceDetail>
      <InvoiceDetail>
        <MaterialCode>CHARLIE</MaterialCode>
        <MaterialCodeDescription>Charlie Materials</MaterialCodeDescription>
        <NetAmount>100.00</NetAmount>
      </InvoiceDetail>
    </InvoiceDetailGroup>
  </Invoice>
</Items>

由于关联记录已作为键的嵌套子项存在，而不是扁平结构，因此当此 XML 进入 XML Map 端口时更易于处理。

入门指南

工作流

EDI 交易伙伴管理控制台

端口

映射

操作指南

脚本编写

软件许可和第三方版权

核心功能

概述

端口配置

组配置选项卡

示例文件

循环设置

分组设置

聚合设置

排序依据设置

设置选项卡

配置

自动化选项卡

自动化设置

性能

警报选项卡

SLA 选项卡

高级选项卡

消息

日志

其他设置

杂项

使用示例文件

使用分组设置

使用聚合设置

宏

示例

​核心功能

​概述

​端口配置

​组配置选项卡

​示例文件

​循环设置

​分组设置

​聚合设置

​排序依据设置

​设置选项卡

​配置

​自动化选项卡

​自动化设置

​性能

​警报选项卡

​SLA 选项卡

​高级选项卡

​消息

​日志

​其他设置

​杂项

​使用示例文件

​使用分组设置

​使用聚合设置

​宏

​示例

核心功能

概述

端口配置

组配置选项卡

示例文件

循环设置

分组设置

聚合设置

排序依据设置

设置选项卡

配置

自动化选项卡

自动化设置

性能

警报选项卡

SLA 选项卡

高级选项卡

消息

日志

其他设置

杂项

使用示例文件

使用分组设置

使用聚合设置

宏

示例