产品功能详解 · 流程设计开发 ③
左出右入，一条映射串起两种报文
EasyLink 格式转换功能详解
格式转换定义输入与输出数据格式之间的映射关系，是系统运行的必要环节。EDIFACT 转 XML、XML 转 X12，都在这里完成。字段值既可以是常量，也可以是一段 Groovy 脚本。
| 📌 来源：聚信万通市场部 · 易连EDI | 🗓 发布：2026-09-09 | ⏱ 阅读时长：约 3 分钟 |
一、格式转换在 EDI 里的位置
格式转换是系统运行所需要输入和输出的数据格式转换过程，是系统运行的必要环节。例如 EDIFACT 转换 XML、XML 转换 X12 等。
如果把一个 EDI 项目拆开看：伙伴发来的是 EDIFACT 或 X12 报文，企业内部的 ERP、WMS 认识的是XML、JSON 或数据库表结构。两者之间的“翻译工作”，就是格式转换承担的。
图 1 格式转换列表页
二、界面布局：左输出，右输入
进入格式转换后，界面左侧为输出数据格式，右侧为输入数据格式。中间通过映射关系把两侧字段关联起来。
图 2 格式转换说明：编号对应下方速查表
界面功能速查表
| 编号 | 功能 | 说明 |
| 1 | 数据转换名称 | 当前格式转换的名称 |
| 2 | 保存 | 保存转换配置 |
| 3 | 选择输出数据格式 | 指定转换的目标格式 |
| 4 | 收起所有（输出） | 收起输出数据格式的子节点 |
| 5 | 展开所有（输出） | 展开输出数据格式的子节点 |
| 6 | 展示所有注释（输出） | 显示输出数据格式的注释 |
| 7 | 隐藏所有注释（输出） | 隐藏输出数据格式的注释 |
| 8 | 一键清除所有代码（输出） | 清空输出数据格式上已填的映射代码 |
| 9 | 在映射规则代码中查找内容 | 添加要查找的内容，匹配上内容后代码编辑器对应行变成黄色 |
| 10 | 选择输入数据格式 | 指定转换的源格式 |
| 11 | 收起所有（输入） | 收起输入数据格式的子节点 |
| 12 | 展开所有（输入） | 展开输入数据格式的子节点 |
| 13 | 展示所有注释（输入） | 显示输入数据格式的注释 |
| 14 | 隐藏所有注释（输入） | 隐藏输入数据格式的注释 |
| 15 | 码编辑器 | 输出数据格式字段内容，可以是常量，也可以是 Groovy 脚本语言 |
| 💡 收起/展开与查找，是给复杂结构报文准备的 一个完整的 EDIFACT ORDERS 或 X12 850 结构展开后字段数量可观。用 4/5、11/12 快速折叠展开，能明显提升映射效率。 |
三、映射规则：常量 与 Groovy 脚本
输出数据格式的字段内容，可以是常量，也可以是 Groovy 脚本语言。这带来了两种用法：
| 方式 | 典型用法 | 举例 |
| 常量 | 字段取固定值时直接填写 | 如固定发送方代码、默认币种、恒定版本号 |
| Groovy 脚本 | 需要计算、判断、拼接、查表时编写脚本 | 如日期格式转换、按条件取值、字符串截取与拼接 |
| 💡 为什么需要脚本能力 现实中的映射很少是“一对一照搬”：伙伴要求的日期格式可能与内部系统不同，某些字段需要按业务规则判断后才能确定。把脚本能力内置在映射里，就不必为了下游系统的特殊要求再去改上游系统的报文生成逻辑。 |
四、典型场景
• 入站：EDI → XML——
• 把伙伴发来的 EDIFACT / X12 报文转换成内部系统可解析的 XML，再进入后续入库流程。
• 出站：XML / JSON → X12——
• 把 ERP 产生的业务数据转换成伙伴要求的标准报文格式后发出。
• 字段补默认值——
• 对源数据中没有、但目标报文必填的字段，用常量直接补齐。
| ⚠ 脚本灵活，也要可维护 脚本能解决复杂映射，但过度使用会让转换逻辑难以交接。建议：能在常量里说清的不用脚本；确实需要脚本的，在注释里写清业务规则与改动原因。 |
五、小结
格式转换把“输入格式”与“输出格式”用一条可视化的映射连起来，常量与 Groovy 脚本两种取值方式，覆盖了从简单照搬到复杂业务规则的场景。官方也提供了格式转换样例可供下载参考。下一篇我们进入低代码模块——给业务人员快速搭管理界面的能力。
| 📌 想进一步了解 EasyLink 的产品能力，或获取本文对应模块的配置支持，欢迎访问 www.sinowintop.com 与我们联系。 |
