EDI Json解决方案

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中