JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式，易于阅读和编写，同时也易于机器解析和生成。因此在EDI项目中常常需要将EDI报文解析为Json格式的文件来与ERP系统集成。与其他方案类似，Json格式的EDI 解决方案中同样包含传输和转换两个步骤，但如何将收到的EDI报文解析为能与ERP系统集成的Json文件呢？
要将EDI报文解析为Json格式的文件，首先需要了解EDI报文的结构，根据报文设计出对应的XML文件格式，最后将XML文件转换为Json格式的文件，再将其Json文件发送到ERP系统对应的API中即可。
下面小知就以ORDERS报文为例，来带大家看看如何将EDI报文解析为对应的Json文件，并传输到ERP系统中。
1 EDIFACT ORDERS报文
下方即为示例ORDERS报文的内容：
| BGM+220+123456789' DTM+137:20200202:102' DTM+2:20200202:102' NAD+SU+1234567890102::9' NAD+BY+1234567890123::9' CTA+OC+ChinaShangHai:First Street' COM+?+112233441:TE' COM+?+443322115:FX' NAD+DP+1234567890098::9' CTA+GR+A company:The EDI apartment' COM+?+123456789:TE' COM+?+987654321:FX' NAD+IV+4567890123456::9' CUX+2:USD:9' PAT+22++5::D:45' TOD+3++FOB' LOC+1+:::BeiJing' LIN+00010++5463728190345:EN' PIA+1+123456789:BP::92' IMD+F+ABC+:::Item01, M, red' IMD+C+98+::92:M' IMD+F+35+::92:red' QTY+21:3:PCE' PRI+AAA:2.2:::1:PCE' LIN+00020++6574839201098:EN' PIA+1+12345678:BP::92' IMD+F+CBA+:::Item2, S, blue' IMD+C+98+::92:S' IMD+F+35+::92:blue' QTY+21:5:PCE' PRI+AAA:9.9:::1:PCE' UNS+S' MOA+86:56.1' CNT+2:2' UNT+31+1' UNZ+1+10001' |
看着这样的EDI报文，难免有些头大，不要着急，小知带大家看看这EDI报文的真面目。首先看看报文的首部的UNA、UNB和UNH字段，这几个字段表示的是EDI报文的头部信息，这些头部信息中包含着该EDI报文Message ID，报文的日期、报文的种类以及报文的规范等信息。同时UNA字段与报文尾部的UNH字段为一对，表示报文的开始与结束。
再往下看，从BGM到LOC字段包含此订单的主信息，其中BGM字段表示此EDI报文的业务主键，DTM表示与此报文有关的日期时间，NAD则表示联系人的信息，例如NAD+SU则表示供应商的信息。CTA以及COM表示联系人的联系方式等信息，LOC则表示地址信息。而从LIN字段到PRI字段则表示此订单的物料信息，通常一个订单中往往包含多种物料，因此在一个报文中可能含有多个此结构。在知道了这些信息后，我们就可以按照此报文的结构来设计对应的XML模板了。
2 设计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 | <Items> <order_header> <id /> <buyer_number/> <buyer_telephone /> <buyer_company /> <create_datetime /> <currency /> <delivery_datetime /> <rff_1 /> <invoice_recipent_number/> <order_number /> <status /> <supplier_number/> <supplier_telephone /> <order_items> <id /> <buyer_item_number /> <item_description /> <unit_price /> <po_number /> <price_unit /> <status/> </order_items> </order_header> </Items> |
有了模板之后还需要将EDI 报文输出的标准XML文件与此自定义XML文件在XML Map端口完成映射，生成Json文件对应的XML文件。如何使用XML Map端口来映射文件，可以参考XML Map端口实战，映射完成的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 | <?xml version="1.0" encoding="UTF-8"?> <Items> <order_header> <id>1</id> <buyer_number>1234567890123</buyer_number> <buyer_company>A company</buyer_company> <buyer_telephone>112233441</buyer_telephone> <create_datetime>20200202</create_datetime> <currency>USD</currency> <delivery_datetime>20200202</delivery_datetime> <rff_1>The EDI apartment</rff_1> <invoice_recipent_number>4567890123456</invoice_recipent_number> <order_number>123456789</order_number> <status type="int">0</status> <supplier_number>1234567890102</supplier_number> <supplier_telephone>+123456789</supplier_telephone> <plant>BeiJing</plant> <order_items> <id>1</id> <buyer_item_number>5463728190345</buyer_item_number> <item_description>Item01, M, red</item_description> <unit_price type="double">PCE</unit_price> <po_number>123456789</po_number> <price_unit>2.2</price_unit> <status>0</status> </order_items> <order_items> <id>2</id> <buyer_item_number>6574839201098</buyer_item_number> <item_description>Item2, S, blue</item_description> <unit_price type="double">PCE</unit_price> <po_number>12345678</po_number> <price_unit>9.9</price_unit> <status type="int">0</status> </order_items> </order_header> </Items> |
3 将XML文件转换为Json文件
我们将上面映射好的XML文件，在Json port转换为Json格式就能得到对应的Json文件了，如下所示：
| 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 | { "order_header": { "id": "1", "buyer_number": "1234567890123", "buyer_company": "A company", "buyer_telephone": "112233441", "create_datetime": "20200202", "currency": "USD", "delivery_datetime": "20200202", "rff_1": "The EDI apartment", "invoice_recipent_number": "4567890123456", "order_number": "123456789", "status":"0", "supplier_number": "1234567890102", "supplier_telephone": "+123456789", "plant": "BeiJing", "order_items": [ { "id": "1", "buyer_item_number": "5463728190345", "item_description": "Item01, M, red", "unit_price":"PCE", "po_number": "123456789", "price_unit": "2.2", "status": "0" }, { "id": "2", "buyer_item_number": "6574839201098", "item_description": "Item2, S, blue", "unit_price":"PCE", "po_number": "12345678", "price_unit": "9.9", "status": "0" } ] } } |
4 调用Http post请求将Json文件发送到ERP系统中
将EDI报文成功解析为对应的Json文件后，我们还需要将其发送到ERP系统对应的API中，这样才能完成EDI报文与ERP系统的集成。而要如何将此Json文件发送到ERP系统中呢，我们的知行EDI系统为我们提供了方法——利用代码，调用httppost方法，将此Json文件传输到ERP系统中。
下面即为实现此功能的代码：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 | <rsb:set attr="http.header:name#" value="Authorization"/> <rsb:set attr="http.header:value#" value="4z7D0m9d7Q7i8z3W3o6w "/> <rsb:set attr="http.header:name#" value="Connection"/> <rsb:set attr="http.header:value#" value="keep-alive"/> <rsb:set attr="http.header:name#" value="User-Agent"/> <rsb:set attr="http.header:value#" value="Apache-HttpClient/4.5.3 (Java/1.8.0_45)"/> <rsb:set attr="http.url" value="http://localhost:8001/api.rsc/orders "/> <rsb:set attr="http.postdata" value='file://[FilePath]'/> <rsb:call op="httpPost" in="http" out="out"> <rsb:set attr="output.data" value="[out.http:content]"/> </rsb:call> <rsb:set attr="output.FileName"value="Response.json" /> <rsb:push item="output" /> |
在这段代码中，首先将http post请求的头部信息写入httpPost方法的header属性中，这里要注意，因为Header属性包含了多种参数，所以需要将各个参数对应的值放入其header属性对应的数组中。这些头部的参数中包含认证、服务器，连接等信息，如非必须的头部信息也可以不填写。其次将请求的URL地址写入HttpPost方法的url属性中，再将Json文件的内容放入httpPost方法的postdata属性中。最后调用httpPost方法，传入这些参数，将Json文件发送到对应的ERP系统的API中