当前位置:首页 » 技术资料 » 产品知识库 » 正文

产品功能详解-JSON报文(二):JSON解码器算子详解

产品功能详解 · 算子功能 · 编解码

把 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以其先进的设计理念、强大的功能特性与极致的用户体验,成为企业实现高效、安全数据交换的理想之选。

未经允许不得转载:北京聚信万通科技有限公司 » 产品功能详解-JSON报文(二):JSON解码器算子详解
分享到
0 赞

相关推荐

联系我们

sinowintop

复制已复制
contact@sinowintop.com复制已复制
13810521470复制已复制
微信公众号
sinowintop复制已复制
关注官方微信,了解最新资讯
contact-img
客服邮箱