Split 端口

Split 端口可以将单个 XML 文件拆分为多个 XML 文件。

核心功能

基于 XPath 的 XML 文件拆分，支持将批量记录分离为单个文件
可配置的批量分组，支持通配符 XPath 以实现动态元素匹配
文件的最大记录数控制，用于管理输出文件的大小

概述

Split 端口配置有一个 XPath，输入 XML 文件应根据该 XPath 拆分为多个输出 XML 文件。当 XML 文件包含一批数据（例如多个订单、多个明细项或多个客户记录）时，此功能很有用。Split 端口会将这批 XML 数据按每个订单、项目或记录拆分为单独的 XML 文件。有关更多信息，请参见拆分示例。

端口配置

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

设置选项卡

配置

与端口核心操作相关的设置。

设置	说明
端口 ID	端口的静态唯一标识符。
端口类型	显示端口名称及其功能说明。
端口说明	可选字段，用于提供端口及其在工作流中作用的自由格式说明。
XPath	XML 结构中应据以拆分的元素路径。指定 XPath 的每个唯一出现都会生成一个唯一的输出 XML 文件。

高级设置

前面类别中未包含的设置。

设置	说明
批量大小	控制将多少条消息放入一个批处理组。默认值为 1，表示不创建批处理组。如果设置为小于 1 的值，所有消息都会包含在单个批处理组中。如果设置为大于 1 的值，每个批处理组都会包含此处指定数量的消息。有关更多信息，请参见拆分示例。
最大记录数	单个输出消息中包含的最大记录数。使用 -1 表示所有输出记录都应放入单个文件，使用 0 表示端口可根据配置的输出文件格式自行决定。默认情况下，XML 每个文件输出一条记录，平面文件格式会将所有记录包含在一个文件中。
本地文件方案	为端口输出的消息分配文件名的方案。可以在文件名中使用宏，动态包含标识符和时间戳等信息。有关更多信息，请参见宏。

高级选项卡

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置	描述
保存到已发送文件夹	选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案	端口根据选定的时间间隔对已发送文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在已发送文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

设置

描述

保存到已发送文件夹

选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。

已发送文件夹方案

端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置	描述
日志级别	指定要记录在端口日志目录中的信息类型： None - 不创建任何日志。 Error - 仅当端口遇到错误时才创建日志。 Warning - 仅当端口发出警告时才创建日志。 Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。 Debug - 记录成功和失败工作流的详细调试信息。 Trace - 记录成功和失败工作流的详细跟踪信息。请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构	指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本	指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。

其他设置

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

其他设置

特殊设置适用于特定用例。

设置	描述
其他设置	允许在以分号分隔的列表中配置隐藏的端口设置，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用这些设置。

自动化选项卡

自动化

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

设置	说明
发送	到达端口的消息是否自动处理。

性能

与端口资源分配相关的设置。

设置	描述
最大工作线程数	此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖高级设置页面的性能设置部分的默认设置。
最大文件数	分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖高级设置页面的性能设置部分的默认设置。

告警选项卡

SLA 选项卡

拆分示例

下面是一个包含多个 TransactionSet 元素的 XML 输入文件示例（换言之，它包含一批交易）：

<Items>
  <Interchange>
    <Id>1</Id>
    <TransactionSet>
      <Data>value1</Data>
    </TransactionSet>
    <TransactionSet>
      <Data>value2</Data>
    </TransactionSet>
    <TransactionSet>
      <Data>value3</Data>
    </TransactionSet>
    <TransactionSet>
      <Data>value4</Data>
    </TransactionSet>
  </Interchange>
</Items>

Split 端口可以将此输入文件拆分为四个独立的输出文件，每个 TransactionSet 元素对应一个文件。要实现此操作，请将 XPath 字段设置为 TransactionSet 元素的 XPath： /Items/Interchange/TransactionSet 将为每个 TransactionSet 生成一个输出文件。下面显示一个示例。输出 1：

<Items>
  <Interchange>
    <Id>1</Id>
    <TransactionSet>
      <Data>value1</Data>
    </TransactionSet>
  </Interchange>
</Items>

如果将批量大小设置为 2，端口会输出两个批处理组，每组包含两条消息。下面显示一个批处理组示例。批处理 1 批处理消息 1：

<Items>
  <Interchange>
    <Id>1</Id>
    <TransactionSet>
      <Data>value1</Data>
    </TransactionSet>
  </Interchange>
</Items>

批处理消息 2：

<Items>
  <Interchange>
    <Id>1</Id>
    <TransactionSet>
      <Data>value2</Data>
    </TransactionSet>
  </Interchange>
</Items>

XPath 通配符

XPath 可以包含通配符字符（*），以拆分给定 XPath 下的所有元素。例如，输入 XML 可能包含多组需要拆分为独立文件的数据，但这些数据组具有不同的元素名称：

<Items>
  <Group1>
    <Data>value1</Data>
  </Group1>
  <Group2>
    <Data>value2</Data>
  </Group2>
  <Group3>
    <Data>value3</Data>
  </Group3>
</Items>

通过将 XPath 设置为以下值来拆分这些组： /Items/* 将生成以下三个输出文件：输出 1：

<Items>
  <Group1>
    <Data>value1</Data>
  </Group1>
</Items>

输出 2：

<Items>
  <Group2>
    <Data>value2</Data>
  </Group2>
</Items>

输出 3：

<Items>
  <Group3>
    <Data>value3</Data>
  </Group3>
</Items>

入门指南

工作流

EDI 交易伙伴管理控制台

端口

映射

系统 API

操作指南

脚本编写

软件许可和第三方版权

核心功能

概述

端口配置

设置选项卡

配置

高级设置

高级选项卡

消息

日志

其他设置

其他设置

自动化选项卡

自动化

性能

告警选项卡

SLA 选项卡

拆分示例

XPath 通配符

宏

示例

​核心功能

​概述

​端口配置

​设置选项卡

​配置

​高级设置

​高级选项卡

​消息

​日志

​其他设置

​其他设置

​自动化选项卡

​自动化

​性能

​告警选项卡

​SLA 选项卡

​拆分示例

​XPath 通配符

​宏

​示例

核心功能

概述

端口配置

设置选项卡

配置

高级设置

高级选项卡

消息

日志

其他设置

其他设置

自动化选项卡

自动化

性能

告警选项卡

SLA 选项卡

拆分示例

XPath 通配符

宏

示例