跳转到主要内容
EANCOM 端口支持从 XML 生成 EANCOM 文件(也称为 GS1 文件),也支持将 EANCOM 文件转换为 XML。

核心功能

  • EANCOM 与 XML 格式的双向转换:支持两种格式之间的完整互转。
  • 全面的交换标头验证与生成:确保报文结构的合规性。
  • 支持多个 EANCOM 版本:具有自动架构检测功能。
  • 交换确认与功能性确认支持:实现消息收发的闭环确认。

概览

接收 EANCOM 文件时,EANCOM 端口会验证交换头并将 EANCOM 文件转换为 XML。这作为一个暂存步骤非常有用,因为 XML 是 在流程中处理数据的主要格式。EANCOM 端口会自动读取输入文件以确定合适的架构,然后根据该架构解析文件。 生成 EANCOM 文件时,EANCOM 端口会将 XML 转换为 EANCOM 文件语法并应用相应的交换头。在流程的其他位置获取并转换 XML 数据后,这通常是创建 EANCOM 文件的最后一步。

端口配置

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

设置

转换配置

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

EDI 交易伙伴

交换头配置

与 EANCOM 交换头相关的设置。将 EANCOM 文件转换为 XML 时,会根据这些设置验证文件头;从 XML 生成 EANCOM 文件时,这些设置用于生成文件头。

请求确认

与生成和请求确认相关的设置。

示例文件选项卡

高级页面

EDI 分隔符

指定用于分隔元素、段等内容的字符。

交换头配置

与 EANCOM 交换头相关的其他设置。这些选项会根据“设置”选项卡上指定的 语法版本 显示或隐藏。

功能组配置

与 EANCOM 文档功能组头相关的设置。这些可选标识符可以帮助将相似的交换分组在一起,或促进组织内的子地址。

高级设置

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

消息

日志

杂项

EDI 交易伙伴选项卡

自动化

自动化设置

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

性能

警报

SLA

XML 转换为 EANCOM

生成 EANCOM 文件时,将 转换类型 选择为 XML 转换为 EANCOM。应用程序会从设置选项卡中配置的设置读取交换、功能组和消息部分的头信息。这些设置包括发送方标识符和代码限定符、接收方标识符和代码限定符等。 使用交易伙伴协议中的设置配置端口后,点击 交易 选项卡并选择 More > Create Test Files。应用程序会创建一组测试 XML 文件,提供示例数据,展示端口生成 EANCOM 文档时 XML 应采用的格式。也可以选择这些文档并点击 Send 查看生成的 EANCOM 文档。

EANCOM 转换为 XML

生成 XML 时,将 转换类型 选择为 EANCOM 转换为 XML。选择此选项后,应用程序仅处理 EANCOM 文件。你需要在此页面上配置交易伙伴协议的设置,以便应用程序在处理期间验证 EANCOM 文档中的信息。XML 文件会生成到此端口的 Output 文件夹中。 点击 交易 选项卡并选择 More > Create Test Files,为多个 EANCOM 文档创建测试 EANCOM 文件。可以选择这些文档并点击 Send 查看生成的 XML。

与 XML Map 端口结合使用

上传测试文件

请求确认

确认会路由到流程图中灰色虚线指定的端口,如下图所示: 指定的端口使用当前端口接收到的事务数据生成确认。指定的端口添加交换头,并像任何其他消息一样在流程中传递确认。因此,通常应将其设置为预先配置的 EANCOM 端口,该端口会为目标收件人生成出站文档。 确认可以由应用程序自动生成和处理。EANCOM 通信中常用两种确认类型:交换确认和功能性确认。这两类确认都归类为 EANCOM CONTRL 消息。

交换请求确认

这表示双方之间已经发生了交换(但不一定表示已交换任何单独的消息)。它们会响应交换中的请求自动生成。

功能性请求确认

功能性确认表示已接受单个消息(如发票或采购订单)。它们响应双方的双向协议生成。

消息发起者

要求回执

可以配置 XML 到 EDI 模式下的 EANCOM 端口,使其为消息请求交换确认和功能性确认。在设置选项卡上选择 Technical acknowledgment (CONTRL)Functional acknowledgment (CONTRL) 复选框,指示端口在适当的确认返回并处理之前,保持传输的 Pending ACK 状态。 ![接收 ACK(/public/images/edifact-ack-receive.png) 上图从消息发起者的角度显示了完整的消息交换。XML 到 EDI 模式下的 EANCOM 端口生成要交换的文档 (1),并将其保持为 Pending ACK 状态。交易伙伴在其业务逻辑中处理传输,并根据配置的交换参数和双方的双向协议创建确认 (2)。确认返回后,会由 EDI 到 XML 模式下的 EANCOM 端口解析,并路由到原始 EANCOM 端口(XML 到 EDI)以更新传输状态 (3)

处理回执

当 EANCOM 端口在 EDI 到 XML 模式下收到交换和功能性 EANCOM 确认时,可以将该端口配置为自动将检测到的任何确认路由到最初生成传输的 EANCOM 端口。在流程图中,将接收端(EDI 到 XML)EANCOM 端口上的灰色圆圈拖到发起端(XML 到 EDI)EANCOM 端口上。 配置好的(XML 到 EDI)EANCOM 端口会将确认与原始消息配对,并解析匹配的消息。

消息回执

生成回执

当 EDI 到 XML 模式下的 EANCOM 端口处理从发起者收到的消息并生成 XML 时,可以通过在设置选项卡中选择 Acknowledgment 复选框,指示端口自动生成 CONTRL 确认。将这些确认路由到 XML 到 EDI 模式下的 EANCOM 端口,以生成 EANCOM 确认。在流程图中,将灰色圆圈拖到为此伙伴生成 EANCOM 文档的(XML 到 EDI)EANCOM 端口上。 ![生成 ACK(/public/images/edifact-ack-create.png) 如上图所示,当合作伙伴发送需要确认的消息 (1) 时,为该伙伴配置的(EDI 到 XML)EANCOM 端口会自动生成确认 (2),该确认是包含该文件相关交易信息的 XML 文件。此 XML 确认必须路由回(XML 到 EDI)EANCOM 端口 (3),以便在生成发送回交易伙伴的 EANCOM 文件时使用所有 EDI 方协议设置。

主从层次结构:转换 CPS 循环

在 EDI 文档中,大多数层次关系由 EDI 段的顺序表示。某些 EDI 结构(如 DESADV 文档中的 CPS 循环)不遵循此约定,而是将层次关系嵌入 EDI 元素数据本身。这会使将 EDI 数据转换为 XML 时保留这些层次关系变得困难。 EANCOM 端口通过高级页面上的 嵌套循环 设置,支持在 CPS 段中保留层次关系。启用后,端口会解析 CPS 段中的元素,以确定哪些段在层次关系中“属于”其他段。这些层次关系会在输出 XML 中体现为父子关系:换句话说,此设置会将 EDI 内容隐含的层次结构转换为 XML 结构表示的层次结构。 本节将简要说明 CPS 数据中如何编码层次结构,以及启用 嵌套循环 时如何将此层次结构转换为 XML。

CPS 层次结构

所有 CPS 段都有两个有助于建立层次结构的值:
  • Id 值,用于标识当前 CPS 段(此值存储在 CPS01,即 CPS 段中的第一个元素)
  • 父 Id 值,用于标识当前 CPS 段的层次父级(此值存储在 CPS02,即 CPS 段中的第二个元素)
例如,假设某个 CPS 段的 Id 值为 “2”。如果下一个 CPS 段在层次关系中应“属于”此前的段,则下一个 CPS 段的父 Id 也应为 “2”。 如果 CPS 段的父 Id 为 “0”,则该段没有父级(位于层次结构顶层)。

将 CPS 层次结构转换为 XML

启用 嵌套循环 时,EANCOM 端口会自动处理 CPS 层次结构到 XML 层次结构的转换。端口解析 CPS 段中的 Id 和父 Id 值,并确保生成的 XML 元素适当地嵌套(缩进)在表示其父元素的元素中。 换句话说,如果 segmentA 的父 Id 值等于 segmentB,则生成的 XML 会将 segmentA 作为 segmentB 的子级。这样,在转换 EDI 数据时,层次关系会保留在 XML 结构中。

示例