Ferrari EDI ⇄ JSON 工作流

近期为了帮助广大用户更好地使用 EDI 系统，我们根据以往的项目实施经验，将成熟的 EDI 项目进行开源。用户安装好知行之桥 EDI 系统之后，只需要下载整理好的示例代码，并放置在知行之桥指定的工作区中，即可开始使用。

本文主要介绍 Ferrari EDI 项目，说明该工作区中各端口的用途、如何在知行之桥 EDI 系统中部署和完善配置，以及如何进行基础测试。

Ferrari 示例工作区基于知行之桥 EDI 系统搭建，围绕 Ferrari 的 ODETTE / EDIFACT 报文和标签生成场景，预配置了以下业务流程：

1. DELINS 交付计划，Ferrari -> 供应商

2. AVIEXP 发运通知，供应商 -> Ferrari

当前 Ferrari 工作区中的核心端口包括：

1. OFTP 端口：Ferrari_OFTP，用于通过 OFTP 通道与 Ferrari 进行 EDI 文件传输。该端口同时承担接收 Ferrari 下发报文和发送供应商生成报文的职责，正式使用前需要根据客户提供的信息确认 SSID/SFID、远程主机、端口、证书、SSL、加密、签名、回执及虚拟文件名规则。

2. EDIFACT 端口：Ferrari_EDIToXML 用于将接收到的 Ferrari EDI 报文转换为 XML；Ferrari_XMLToEDI 用于将内部 XML 转换为 AVIEXP等待发送 EDI 报文。

3. XMLMap 端口：Ferrari_DELINS_XMLMap、Ferrari_AVIEXP_XMLMap分别用于完成 DELINS、AVIEXP相关字段映射。

4. JSON 端口：Ferrari_DELINS_JSON、Ferrari_AVIEXP_JSON 用于在工作流中接收或输出业务 JSON 数据。

除了预配置的端口之外，项目目录中还整理了 Ferrari DELINS、AVIEXP 等报文规范、测试报文和对接指南，可用于理解字段含义和验证映射结果。

Ferrari 工作区当前包含以下主要链路：

1. 接收 DELINS：Ferrari_OFTP -> Ferrari_EDIToXML -> Ferrari_DELINS_XMLMap -> Ferrari_DELINS_JSON。

2. 发送 AVIEXP：Ferrari_AVIEXP_JSON -> Ferrari_AVIEXP_XMLMap -> Ferrari_XMLToEDI -> Ferrari_OFTP。

其中，DELINS 是入站交付计划；AVIEXP 是供应商发送给 Ferrari 的出站报文。

运行知行之桥 EDI 系统，导航到工作流选项卡并单击右上角的添加工作区按钮。选择添加新工作区，为此示例流创建一个新的工作区，例如 Ferrari。

在下拉菜单中，单击导入工作区。在出现的对话框中，选择 Ferrari 示例流的 arcflow 文件以导入相关端口和设置；也可以直接将 arcflow 文件拖拽到指定工作区。

在下拉菜单中，单击导入工作区。在出现的对话框中，选择 Ferrari 示例流的 arcflow 文件以导入相关端口和设置；也可以直接成功导入示例工作流后，你将看到 Ferrari 的完整工作流，包括 OFTP、EDIFACT、XMLMap、JSON、等端口。

导航到 Ferrari_OFTP 端口的设置选项卡。根据 Ferrari 提供的 OFTP 文档配置通信信息，包括本地和远程 ODETTE ID、密码、远程主机、端口、交易伙伴证书、SSL 协议、签名、加密、压缩以及回执策略。

当前示例工作区中已包含 OFTP 端口和基础传输参数，但正式联调前仍需替换或确认供应商自身的个人设置，例如本地 ODETTE ID、私钥证书、证书密码和生产/测试环境连接信息。

配置完成后，可以在 OFTP 端口中进行连接测试，并通过输入或输出选项卡查看测试文件的收发结果。

Ferrari_EDIToXML 和 Ferrari_XMLToEDI 端口负责 EDI 与 XML 的互转。请根据 Ferrari 报文规范确认 UNB 交换头、UNH 报文类型、分隔符、释放符、测试标识和虚拟文件名规则。

Ferrari_EDIToXML 主要处理 Ferrari 下发的 DELINS；Ferrari_XMLToEDI 主要处理供应商发送给 Ferrari 的 AVIEXP 。若后续新增报文类型，需要补充对应 schema、映射和路由规则。

以接收 Ferrari 下发的 DELINS 交付计划为例，测试流程如下：

1. 导航到 Ferrari_EDIToXML 端口，在事务页面上传 DELINS 测试报文。

2. 报文转换为 XML 后会进入 Ferrari_DELINS_XMLMap。

3.映射结果进入 Ferrari_DELINS_JSON，可在事务-输出文件内容中查看业务 JSON。

以发送 AVIEXP 发运通知为例，测试流程如下：

1.准备符合 Ferrari_AVIEXP_JSON 输入结构的 JSON 文件。

2.导航到 Ferrari_AVIEXP_JSON 端口，在输入页面上传测试 JSON。

3. 文件经 Ferrari_AVIEXP_XMLMap 转换为 AVIEXP XML，再经 Ferrari_XMLToEDI 生成 ODETTE AVIEXP 报文。
4. 生成的 EDI 文件进入 Ferrari_OFTP，由 OFTP 端口发送给 Ferrari。

如果答案是肯定的，那么你已经成功配置了 Ferrari EDI 示例工作流。接下来可以根据实际项目要求逐步完善 OFTP 通信参数，并使用 Ferrari 的 DELINS、AVIEXP 测试文件进行端到端联调。

如果你遇到任何问题或有任何疑问，请随时联系我们。