核心功能
- 支持层级 XML 记录分组与聚合，可按键分组并使用多个分组键
- 支持通过 XPath 识别并执行 MIN、MAX、SUM、AVG、COUNT 和 CONCATENATE 等聚合函数
- 在添加汇总和分组元素的同时保留原始记录结构
概述
XML Group 端口通过聚合、验证和转换结构化数据来处理相关 XML 记录集合，以便与各种系统无缝集成。它能够高效处理层级 XML 数据，确保数据交换、报告和自动化工作流等应用之间的一致性和互操作性。端口配置
本节包含所有可配置的端口属性。组配置选项卡
与配置组相关的设置。示例文件
使用 示例文件 切换按钮指定示例文件，使端口能够提供有关文档的更多上下文。有关更多信息，请参阅使用示例文件。循环设置
与端口应使用的 XPath 相关的设置，该 XPath 表示输入文档中的单条记录；同时还包括用于保存每组相关记录的 XML 元素。分组设置
定义每条记录中哪些元素用于确定每个组键值的设置。有关更多信息，请参阅使用分组设置。聚合设置
使用 聚合设置 切换按钮查看用于定义如何汇总每个组中记录的设置。有关更多信息，请参阅使用聚合设置。排序依据设置
使用 排序依据 切换按钮查看用于定义如何对每个组中的记录进行排序的设置。设置选项卡
配置
与建立连接相关的设置。| 设置 | 描述 |
|---|---|
| 端口 Id | 端口的静态、唯一标识符。 |
| 端口类型 | 显示端口类型及其用途的描述。 |
| 端口描述 | 一个可选字段，用于提供端口及其在流中的角色的自由格式描述。 |
自动化选项卡
自动化设置
与端口自动处理文件相关的设置。性能
与端口资源分配相关的设置。
| 设置 | 描述 |
|---|---|
| 最大工作线程数 | 此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
| 最大文件数 | 分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
警报选项卡
SLA 选项卡
高级选项卡
消息
消息设置确定端口如何搜索消息并在处理后管理它们。
| 设置 | 描述 |
|---|---|
| 保存到已发送文件夹 | 选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。 |
| 已发送文件夹方案 | 端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。 |
日志
用于管理日志创建和存储的设置。
| 设置 | 描述 |
|---|---|
| 日志级别 | 指定要记录在端口日志目录中的信息类型：
|
| 日志文件夹结构 | 指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。 |
| 保留消息副本 | 指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。 |
其他设置
杂项
特殊设置适用于特定用例。
| 设置 | 描述 |
|---|---|
| 其他设置 | 允许在以分号分隔的列表中配置隐藏的端口设置，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。 |
使用示例文件
开启 示例文件 以上传一个示例输入 XML，该 XML 模拟将传递到端口中的 XML 输入。 启用后，它会为 UI 中的每个 XPath 字段提供 XPath 助手，从而更容易查看文档结构并选择正确的 XPath。根据 XPath 在端口中代表的内容，只能点击符合条件的 XML 元素。 例如，在 循环设置 中，只能选择父元素，因为 知行之桥 期望这些元素代表一条 记录。
使用分组设置
分组设置定义每条记录中用于确定每个组键值的元素。键通常是Id 值，例如 CustomerID 或 InvoiceID。可以有多个键，它们会作为循环设置中设置的元素名称和 XPath 的子项出现。
- 元素名称 告诉端口在输出文件中用于分组的 XML 元素应命名为什么。这通常与键 XPath 指向的输入文件元素名称相同，但也可以使用不同名称。
- 键 XPath 是输入文件中要用作 key（分组依据）的元素的 XPath。键 XPath 相对于 记录 XPath。
<MaterialCode> 元素是键。这样就可以在输出中将 ALPHA、BRAVO 和 CHARLIE 的所有出现项分组在一起，而不是分别出现多个重复项。
使用聚合设置
聚合设置控制端口应如何聚合数据。可以定义一个 XPath，其中包含要执行操作运算符（MIN、MAX、SUM、AVG、COUNT、CONCATENATE）的值，然后端口会对组中的所有记录执行该运算符。一个常见示例是对每条记录的价格求和。 以下示例使用前面图片中描述的 循环设置 和 分组设置，以及以下 聚合设置：MaterialCode）都有一个 InvoiceDetailGroup。每个 InvoiceDetailGroup 内都有来自 分组设置 的 MaterialCode 键，以及来自 聚合设置 的计算结果 NetAmountSUM。最后，还会包含原始的 InvoiceDetail 元素及其子元素：