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文件见如下附件:
示例报文可参考如下解析进行阅读:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
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运算器进入到指定目录
1 2 3 4 5 |
<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关键字就可以进行循环读取
1 2 3 4 |
<rsb:set attr="xml.xpath" value="LINLoop1" /> <rsb:call op="xmlDOMSearch" in="xml"> ... </rsb:call> |
预测部分在”FSTLoop1中,一个Item也可能会对应多组预测信息,所以先进入到FSTLoop1里再进行取值
1 2 3 4 |
<rsb:set attr="xml.xpath" value="FSTLoop1" /> <rsb:call op="xmlDOMSearch" in="xml"> ... </rsb:call> |
五、测试代码
打开Excel端口,选择转换模式为Template,然后上传写好的代码文件
在X12端口的输入出上传要解析的830报文并发送
从Excel端口的输出处即可拿到生成的Excel文件
最后打开生成的Excel,与原报文中的字段进行对比,检查是否遗漏或者取值错误。