
产品功能详解 · 算子功能 · 编解码
把 JSON 报文读成结构化对象,模板说了算
EasyLink JSON解码器 算子详解
JSON解码器 用于将 JSON 字符串按照指定数据格式反序列化为结构化对象:自定义节点别名,开启高级参数后配置输入来源、输出变量,选择数据类型与解析模板,支持多组别名配置,保存后即完成 JSON 报文自动解码。
| 📌 来源:聚信万通 · 易连EDI | 🗓 发布:2026-11-17 | ⏱ 阅读时长:约 5 分钟 |
一、JSON解码器 是什么
JSON解码器 是“编解码”分组中把 JSON 报文读成结构化对象的算子:从输入参数绑定的变量获取 JSON 原始报文,按“类型”参数指定的数据解析模板约束“JSON 转实体”的规则,反序列化结果写入输出参数指定的变量,向下游流程传递。它还支持多组别名配置——原始 JSON 字段与业务实体字段名不一致时,可通过字段别名映射自定义适配。与 JSON编码器 配对完成 JSON 数据的双向转换,与 XML解码器 按“伙伴发什么格式”分工。
二、典型使用场景
JSON解码器 适合在流程中把伙伴发来的 JSON 报文读成数据对象再加工的场景。常见场景如下。
| 场景 | 解决什么问题 | 预期效果 |
| 接收 JSON 订单发票 | 伙伴发来的 JSON 报文无法直接做字段映射 | 按数据解析模板解成结构化对象,Mapping 即取即用 |
| 字段名对不上 | 原始 JSON 字段名与业务实体字段不一致 | 多组别名配置批量映射,字段自定义适配 |
| 接口请求解析 | 上游 API 调用传入的 JSON 需要拆解加工 | 从 %{messages.request.content} 取报文,解析即接力 |
| 解码后接力处理 | 解出的数据要继续映射、存档或回执 | 输出变量交由下游算子接手,链路即插即用 |
| 💡 解码前必须先建好“数据格式” “类型”参数引用的是数据解析模板——JSON解码器不是万能解析器,它按你在「数据格式」功能中定义好的结构去读报文。所以正确顺序是:先在「数据格式」创建对应的数据映射模板,再回来给解码器选择分类与模板;模板定义错了,解码必然出错。 |
三、参数设置
进入流程设计器界面,打开左边栏的执行单元(编解码),拖拽“JSON解码器”算子。基础配置页面中可设置别名;开启“高级参数”开关后,可配置输入、输出、类型与多组字段别名,共 4 项参数(默认值中的变量引用表达式可按你的实际流程变量调整)。

图 1 JSON解码器的基础配置页面(高级参数已开启)
参数
| 类别 | 名称 | 类型 | 高级参数 | 说明 | 默认值 |
| 输入 | 输入 | 格式化字符串 | 否 | 从请求内容中获取待解析的JSON原始报文 | %{messages.request.content} |
| 输出 | 输出 | 格式化字符串 | 否 | 存储解码完成后的结构化对象至临时变量 | %{messages.temporary.variables.decoded} |
| 配置 | 类型 | 双下拉选择项 | 否 | 依次选择分类与绑定的数据解析模板 | – |
| 配置 | 别名 | 多组扩展配置项 | 是 | 可新增多组字段别名映射配置 | – |
参数说明
• 别名:设置流程内算子展示名称,用于区分多个JSON解码节点。
• 输入:绑定上游请求报文变量,作为JSON原始解析数据源,配置示例:%{messages.request.content}。
• 输出:接收反序列化后的结构化数据,向下游流程传递解析结果,配置示例:%{messages.temporary.variables.decoded}。
• 类型:第一下拉选择格式分类,第二下拉选择预定义的数据映射模板,约束JSON转实体规则。
• 别名(配置分组):批量配置字段别名映射,用于原始JSON字段和业务实体字段自定义适配,可点击“+”新增多组。
编辑对话框中的示例配置与默认值一致:输入/输出保持默认,“类型”第一下拉选择格式分类(如“数据格式”)、第二下拉选择具体模板;“别名”分组点击“+”即可按需新增多组字段映射。
四、输入与输出端口
算子在流程中以端口衔接上下游,各端口职责如下。
输出
| 端口类型 | 名称 | 说明 |
| 输入 | 输入 | 接收待解析的 JSON 原始报文 |
| 输出 | 成功 | 解码成功,输出结构化数据对象 |
五、解码的对象长什么样
解码器的输入是伙伴发来的 JSON 报文,下面是一份订单 JSON 的结构示意(实际内容以伙伴报文为准):
| { “orderNo”: “PO1”, “orderDate”: “2020-05-11”, “buyer”: “BYNAME”, “shipTo”: “STNAME”, “lines”: [ { “lineNo”: 1, “item”: “CPN1”, “qty”: 6200, “price”: “30.0000” } ] } |
图 2 待解码的 JSON 报文结构示意(按类型参数指定的解析模板反序列化)
解码完成后,输出变量(如 %{messages.temporary.variables.decoded})中即为结构化数据对象,可直接交给格式映射、JSON编码器、文件传输等下游算子继续加工。
六、容易被忽略的配置要点
• “类型”是双下拉,两步都要选
“类型”先选格式分类、再选数据解析模板——模板来自「数据格式」功能中的预定义映射。只选分类不选模板,解码规则不完整;模板与报文结构对不上,解码必然出错——先查它,而不是先查流程。
• 字段名对不上用“别名”映射
伙伴报文里的字段名与业务实体不一致时,不必改上游——在“配置>别名”中点击“+”新增多组字段别名映射,让原始 JSON 字段与实体字段按你的约定适配,报文照收、数据照用。
• 输入是报文文本,不是数据对象
解码器的输入是“待解析”的 JSON 原始报文(如 %{messages.request.content})。若把数据对象喂给解码器,方向就反了——那是 JSON编码器 的活。
| ⚠ 解码失败?先查“解析模板”再查“报文” 解码报错或输出为空时,按顺序排查:一看“类型”引用的数据解析模板与报文实际结构是否一致——字段名、层级对不上是最常见错因;二看字段别名映射是否把关键字段映射错了方向;三看输入变量是否真的装着报文全文(而不是空值或已被上游改写)。模板侧问题修定义,数据侧问题修上游。 |
七、小结
JSON解码器 是编解码分组中把 JSON 报文反序列化为结构化对象的算子。4 项参数中“类型”是灵魂——双下拉选择格式分类与数据解析模板,约束 JSON 转实体的规则;“配置>别名”则负责字段级适配——多组字段别名映射让报文字段与业务实体字段自由对齐。它与 JSON编码器 配对完成双向转换,与 XML解码器 按伙伴报文格式分工,与格式映射、文件传输等算子组合即可实现“接收—解码—映射—发送”的完整链路。使用时重点保证解析模板与报文结构一致、字段别名按需配置、输入是报文文本而非数据对象。
| 📌 想进一步了解 EasyLink 的产品能力,欢迎访问 www.sinowintop.com 与我们联系。 |

易连EDI—EasyLink是由北京聚信万通科技有限公司(以下简称“聚信万通”)经过多年潜心研究成功打造出的新一代国产化EDI产品方案,100%自主研发,拥有完全知识产权的EDI软件,是目前国内唯一通过了Drummond Group AS2 & Odette OFTP2 双国际认证的EDI产品。
🏆以创世界纪录的速度通过AS2国际认证预测试
🏆Drummond Group首次提前完成AS2正式测试
🏆中国唯一通过AS2国际认证的国产EDI软件产品
🏆中国唯一受邀参加新版AS2国际标准制定的公司
🏆中国唯一通过Drummond&Odette双国际认证的公司
🏆EasyLink AS2、OFTP2技术标准支持能力处于世界领先水平
🏆中国唯一同时受邀加入AS2、OFTP2两大国际技术专家组的公司
🏆全球首款原生适配华为自研麒麟PC芯片、鸿蒙PC操作系统的EDI产品
🏆Odette CA官方授权的中国区Odette ID及数字证书的注册审批管理机构
🏆全球首款获得华为鲲鹏技术、openEuler、麒麟、统信、天翼云适配认证的EDI产品
🏆首款实现AI驱动自动化WebEDI开发、数据映射、流程编排、平台迁移的国产EDI软件
易连EDI—EasyLink以其先进的设计理念、强大的功能特性与极致的用户体验,成为企业实现高效、安全数据交换的理想之选。





