EDI目前已广泛应用于电子、物流、汽车、零售等行业。
越来越多的交易伙伴要求建立EDI连接,通过EDI来对接上下游交易伙伴,收发业务单据。
当我们与新的交易伙伴建立EDI连接时,有多种实施方案可供选择,如果您的单据量较少,预算也不多的话,Excel方案相对来说就比较适合了。
本文章主要给大家讲解当您自主实施时,如何写将EDI报文解析到Excel中的代码。
以830物料需求预测为例
一、搭建工作流
在知行之桥EDI系统中,所有文件转换的中间格式都是XML,所以在任何格式转前,都需要先转换为XML,再进行下一步处理。 830是ANSI X12报文标准中的一类消息,要将830解析到Excel中,可以先通过X12端口进行预处理,知行之桥EDI系统的X12端口可以进行报文到XML的双向转换,所以先通过X12端口将X12报文格式转换为对应的XML格式,再将转换的XML解析到Excel即可。
根据上述需求,可搭建如下工作流:
二、使用规范中的示例830报文通过X12端口生成对应XML文件
示例报文和生成的XML文件见如下附件:
下载示例报文和生成的XML文件
示例报文可参考如下解析进行阅读:
ISA*00* *00* *01*123456789 *01*987654321 *940613*1025*U*04010*000000333*0*P*\'
GS*PS*005346481*005346481*940613*1025*000000433*X*004010'
ST*830*000001048'
BFR*05**123456*DL*A*20230606*20230801'
-929701 版本号
-DL 预测类型
-20230606 预测开始日期
-20230801 预测结束日期
N1*ST*EDI SENDER INC*01*123456789'
-ST 指收货方
-EDI SENDER INC 收货方名称
-123456789 收货方编号
N1*SF*EDI RECEIVING INC*01*987654321'
-SF指发货方
-EDI RECEIVING INC 发货方名称
-987654321 发货方编号
LIN**BP*BP001*VP*VP001*PO*PO123'
-BP001 买方物料号
-VP001 供应商物料号
-PO123 订单号
REF*DK*DOCK1'
-DOCK1 码头编号
FST*600*C*D*20230606'
-600 预测数量
-C 预测标识
-D 预测时间标识
-20230606 交付起始日期
FST*5000*D*W*20230704'
FST*10000*D*F*20230905*20231002'
SHP*01*10000*050*20230613'
-10000 上次接收日期
-20230613 接收日期
SHP*02*10000*051*20230606**20230613'
-10000 累计接收数量
-20230606 累计开始日期
LIN**BP*4562*VP*100*EC*123*PO*PO456'
FST*50*C*D*20230606'
FST*50*C*D*20230613'
FST*150*C*W*20230627'
FST*2000*D*W*20230801'
CTT*2*20550'
SE*49*000001048'
GE*1*000000433'
IEA*1*000000333'
三、根据实际业务需求设计Excel模版
根据客户提供的规范整理对应的Mapping,然后参考Mapping和对应XML文件可以自定义一个830的Excel模版,本文提供如下示例:
示例模版见如下附件:
示例模版
四、写转换代码
通过X12端口获得830报文对应的XML,并且已经设置好Excel目标格式,接下来就可以进行代码解析了
可以通过在Excel模版中添加批注,然后使用xpath从XML文件中取到对应值
注意,逻辑代码和赋值代码写在批注里,只有需要输出的写在单元格里
1.从XML中进行取值
打开830报文生成的XML文件可以看到如下图所示的层级结构
首先需要进入到/Interchange/FunctionalGroup/TransactionSet/TX-00401-830该路径里,然后对header部分进行取值
可通过call关键字(rsb:call或arc:call)和xmlDOMSearch运算器进入到指定目录
<rsb:set attr="xml.uri" value="[FilePath]" />
<rsb:set attr="xml.xpath" value="/Interchange/FunctionalGroup/TransactionSet/TX-00401-830" />
<rsb:call op="xmlDOMSearch" in="xml">
...
</rsb:call>
扩展阅读:call关键字的使用方法 xmlDOMSearch运算器的使用方法
取值方式:[xpath("") | def]
[xpath("BFR/BFR03") | def] 即取BFR下的BFR03的值
[xpath(“N1Loop1[N1/N101='ST']/N1/N102″) | def] 即取NILoop1下N1里N101等于 ‘ST’时N102的值, N1Loop1根据N101值的不同,存放不同的信息,N101=’ST’时放的是收货方信息 [N1/N101='ST']即加在取值中的条件,条件的写法如下: 1.位置:条件要加在循环的节点后,可以看到XML文件中有多个N1Loop1,所以N1Loop1就是循环的节点,[N1/N101='ST']需加在N1Loop1后 2.写法:[判断路径='条件值'],注意,条件内不能包含任何空格
整个Item部分都在LINLoop1里,且一个830里可能会包含多个物料信息,所以需要再通过call关键字和xmlDOMSearch运算器进入到LINLoop1里,如果有多个LINLoop1,call关键字就可以进行循环读取
<rsb:set attr="xml.xpath" value="LINLoop1" />
<rsb:call op="xmlDOMSearch" in="xml">
...
</rsb:call>
预测部分在”FSTLoop1中,一个Item也可能会对应多组预测信息,所以先进入到FSTLoop1里再进行取值
<rsb:set attr="xml.xpath" value="FSTLoop1" />
<rsb:call op="xmlDOMSearch" in="xml">
...
</rsb:call>
五、测试代码
打开Excel端口,选择转换模式为Template,然后上传写好的代码文件
在X12端口的输入出上传要解析的830报文并发送
从Excel端口的输出处即可拿到生成的Excel文件
最后打开生成的Excel,与原报文中的字段进行对比,检查是否遗漏或者取值错误。