Version 26.1.9526

• 概览
  • 视频资源
• EDI to Excel
  • Excel to EDI
• Create an EDI to Excel Flow
  • Step 1: EDI 端口
  • Step 2: Excel 端口
  • Step 3: 测试 EDI to Excel 工作流
• Create an Excel to EDI Flow
  • Step 1: Excel 端口
  • Step 2: EDI 端口
  • Step 3: 测试 Excel to EDI 工作流
    • 调整样本 Excel 表格

将 EDI 文档可视化为 Excel 是 EDI 集成入门最快的方法之一。将 EDI 转换为 Excel 的流程是其它更为复杂的 EDI 集成方案的先驱，也是在熟悉的业务环境中处理 EDI 文档的一个长期解决方案。

知行之桥的 Excel 端口带有内置模板，用于将 EDI 文档呈现为样式化的 Excel 工作表，并将这些 Excel 工作表转换为 EDI 文档。本指南说明了如何快速开始使用这些模板且不需要任何自定义映射或自定义逻辑的 EDI 工作流。

知行之桥还包括功能强大的映射工具，可将 EDI 数据转换为许多不同的格式，另外两个方法可作为更复杂的 EDI 映射项目的参考：

• 将 EDI 映射到 CSV
• 将 MySQL 输出转换为 EDI

概览

本文将讨论以下两个方面：

• 将传入的 EDI 文件转换为样式化的 Excel 工作表
• 通过将数据插入 Excel 单元格以生成新的 EDI 文档

本节简要介绍了所涉及的概念，以下各节将逐步介绍创建工作流的过程，该工作流可以双向完成 EDI 和 Excel 的相互转换。

视频资源

观看此简短视频，了解如何使用知行之桥在 Excel 中可视化 EDI 数据。

EDI to Excel

Excel 端口 预配置了一个模板 Excel 文件，可将 EDI XML 转换为样式美观、格式规范的 Excel 表格。该模板文件使得 EDI 文档无需任何自定义配置或映射，即可在 Excel 中呈现。

Excel 端口还支持生成测试 EDI XML 文件，以立即转换为样式化的 Excel 表格。快速开始在 Excel 中可视化 EDI 的最简单方式是使用以下两个功能创建测试 Excel 表格：

• 在端口的 Settings 页面，将 Translation Type 设置为 Template，然后选择 EDI_XML_to_XLSX_styled_template.xlsx 作为 Template File
• 在 Input 页面，使用 More > Create Test Files 创建两个测试文件
• 在 Output 页面，点击端口生成的 .xlsx 文件链接

注意： 中无法预览二进制消息内容，因此请点击显示的消息上的下载按钮，然后在 Excel 中打开文件。输出结果应类似于下图：

Create Test Files 选项有助于快速上手。但通常更有用的是从实际生产 EDI 数据生成样式化的 Excel 表格，而不是使用端口附带的测试文件。要实现此目的，请保持 Template File 设置为 EDI_XML_to_XLSX_styled_template.xlsx，同时按照以下额外步骤生成更相关的输入文件。

首先，需要将样本 EDI 数据转换为 XML，因为 使用 XML 作为操作和转换数据的中间格式。将样本 EDI 文档转换为 XML 需要一个与 EDI 文档类型匹配的 EDI 端口（例如，X12 端口用于 X12 文档，EDIFACT 端口用于 EDIFACT 文档）。这些端口除了将 EDI 转换为 XML 外，还会验证 EDI 文档的结构，并可选地验证 EDI 交换头。

EDI 文档转换为 XML 后，将其上传到 Excel 端口的 Input 页面。请记住，保持模板文件设置为 EDI_XML_to_XLSX_styled_template.xlsx，该模板会将 XML 转换为样式化的 Excel 表格。可以在 Output 页面下载转换后的文件查看。

有关如何创建 工作流以从自定义 EDI 数据生成 Excel 表格的详细信息，请参阅 Create an EDI to Excel Flow。

Excel to EDI

如上所述，Excel 端口包含一个模板文件，用于将 EDI XML 转换为样式化的 Excel 表格。该端口还包含另一个模板文件，可将此样式化的 Excel 表格转换回 XML。这意味着可以将自定义 EDI 数据输入到样式化的 Excel 表格中，转换为 XML，然后再转换为 EDI 文档。

这是一种将数据转换为 EDI 的简便方法：将相关数据插入适当的 Excel 表格， 会使用此表格生成 EDI 文档。

由于数据应输入到与 Excel 端口模板匹配的样式化 Excel 表格中，因此第一步是生成适当格式的 Excel 表格。从 Excel 表格生成 EDI 文档的完整流程如下：

1. 从一个样本 EDI 文档开始
2. 将样本 EDI 文档转换为 XML（使用 X12 或 EDIFACT 端口等）
3. 使用 Excel 端口附带的模板文件（EDI_XML_to_XLSX_styled_template.xlsx）将生成的 XML 转换为 Excel 表格
4. 将生成的 Excel 表格（包含样本数据）保存（例如 sample_excel.xlsx）
5. 将 sample_excel.xlsx 中的数据替换为生产数据
6. 使用 Excel 端口的 EDI_XLSX_to_XML_template.xml 模板文件将生产表格转换回 XML
7. 将生成的 XML 转换为 EDI 文档（再次使用 X12 或 EDIFACT 端口等）
8. 对于未来的 EDI 文档，重新加载 sample_excel.xlsx 文件并重复步骤 5-7

以下章节详细说明如何创建 工作流以实现 EDI 与 Excel 之间的相互转换。

Create an EDI to Excel Flow

如 EDI to Excel 中所述，将 EDI 转换为 Excel 的第一步是将 EDI 转换为 XML。

Step 1: EDI 端口

将 EDI 文档转换为 XML 需要一个特定 EDI 文档类型的端口（X12、EDIFACT、EANCOM 等）。本指南以 X12 810（发票）作为 EDI 文档示例。在 X12 端口前面是一个触发端口（以下示例中为 AS2），它接收 X12 810 文档并直接传递给 X12 端口。但实际使用场景可能需要不同的触发端口，例如 SFTP。有关可能适合使用场景的端口类型的更多信息，请参阅 Connector Categories。

在 X12 端口 Settings 页面的 Interchange Settings 部分，将 Usage Indicator 设置为 T-Test Data。这会禁用交换验证，使生成样本文档的过程更简单（EDIFACT 端口对应的字段为 Test Indicator，应启用以复制此行为）。

在 X12 端口的 Advanced 页面，使用 Generate Description As 设置决定是否在生成的表格中包含每个 EDI 元素的描述。该设置的默认值为 XML Comment，而 XML 注释不会被 Excel 模板读取，因此描述不会出现在样式化的 Excel 表格中。将此设置更改为 Element Attribute，模板即可解析描述值并将其包含在生成的 Excel 表格中。

Step 2: Excel 端口

接下来，将 X12 端口连接到 Excel 端口，以便将 XML 文件传递给 Excel 端口。

在 Excel 端口 Settings 页面，将 Template File 设置为 EDI_XML_to_XLSX_styled_template.xlsx。

添加一个终结端口实例（上图未显示），作为工作流的最后一个端口。此使用场景常用的终结端口是 File 端口，可将完成的文件放置到磁盘路径上。有关可能适合使用场景的端口类型的更多信息，请参阅 Connector Categories。

Step 3: 测试 EDI to Excel 工作流

现在可以向工作流发送样本 EDI 文件。在 X12 端口的 Input 页面点击 More > Create Test Files 生成样本 810 文档。

提示：可以在 X12 端口生成 810、850、855 和 856 的样本文档。如果需要其他文档类型，必须从其他地方上传。

将样本文档通过工作流发送后，Excel 端口的输出应类似于下图：

现在，只要将任何标准 X12 文档输入到此工作流的开头，即可将其转换为如上图所示的样式化 Excel 表格。

Create an Excel to EDI Flow

如 Excel to EDI 中所述，创建 Excel to EDI 工作流的第一步是生成样本 Excel 表格。要生成此表格，请按照 Create an EDI to Excel Flow 中的步骤进行。该工作流生成的样式化 Excel 表格即作为样本 Excel 表格。以下步骤说明如何从 Excel 表格创建 X12 810 发票文件。

注意：如果需要多种类型的 EDI 文档（例如 810 发票 和 850 采购订单），则需为每种文档类型创建样本 Excel 表格。

生成样本 Excel 表格后，即可配置 Excel-to-EDI 工作流。该工作流与上述工作流分开，但类似。

Step 1: Excel 端口

首先，向工作流添加一个 Excel 端口。在 Excel 端口前面是一个触发端口（以下示例中为 File）。实际使用场景可能需要不同的触发端口，例如 SFTP。有关端口类型的更多信息，请参阅 Connector Categories。

在 Excel 端口 Settings 页面，将 Template File 设置为 EDI_XLSX_to_XML_template.xml。

Step 2: EDI 端口

接下来，将 Excel 端口连接到 X12 端口（其他 EDI 工作流可能使用 EDIFACT 或 EANCOM 端口）：

在 Settings 页面，将 Translation Type 设置为 XML to X12。更多信息请参阅 X12 文档。本示例中的 X12 端口设计为直接连接到终结端口。通常使用 AS2，但也可以使用其他 MFT 端口。

Step 3: 测试 Excel to EDI 工作流

配置好工作流后，匹配样本 Excel 表格格式的 Excel 文档即可通过工作流生成 EDI 文档。可以通过上传样本 Excel 表格到 Excel 端口进行快速测试。在 Excel 端口的 Input 页面，选择 More > Upload Files 并浏览到样本表格。

Excel 端口生成代表 EDI 文档的 XML。以下是 X12 810 文档的 XML 部分示例：

X12 端口将此 XML 转换为 EDI 格式，并根据 X12 端口的 Interchange Settings 应用交换头。最终输出应类似于下图（默认以 Print View 打开，但可切换到 Raw View 查看原始数据）：

确认工作流能将样本 Excel 表格转换为所需的 EDI 格式后，即可将 Excel 表格中的具体值替换为实际生产数据，并使用相同工作流将生产数据转换为 EDI。

调整样本 Excel 表格

某些 EDI 文档需要向样本 Excel 表格中添加或删除行。例如，EDI 采购订单可能具有不同数量的行项目（PO1 循环），这些数量并不总是与样本 Excel 表格中的行项目数量匹配。

在这种情况下，如果需要更多循环，则向 Excel 表格插入行；如果需要更少循环，则删除行。这确保表格结构与 EDI 文档结构匹配。

鉴于某些 EDI 循环需要以可预见的方式添加或删除，建议包含更多（而不是更少）可能的区段和循环重复的 EDI 文档样本开始，因为从示例 Excel 工作表中删除多余的行通常比添加新的行更容易。