Target DVS EDI项目开源介绍

近期为了帮助广大用户更好地使用 EDI 系统，我们根据以往的项目实施经验，将成熟的 EDI 项目进行开源。用户安装好知行之桥EDI系统之后，只需要下载我们整理好的示例代码，并放置在知行之桥指定的工作区中，即可开始使用。

今天的文章主要为大家介绍 Target DVS EDI 项目，了解如何获取开源的项目代码以及如何部署到知行之桥 EDI 系统中。

Target DVS EDI & JSON 方案简介

Target DVS EDI 到 JSON 示例流具有预配置的端口，用于依据 Target DVS 提供的 EDI 规范，转换以下交易集：

1. 850 采购订单，Target -> 供应商
2. 855 订单回复，供应商 -> Target
3. 860 采购订单变更，Target -> 供应商
4. 855 订单变更回复，供应商 -> Target
5. 856 发货通知，供应商 -> Target
6. 846 库存报告，供应商 -> Target
7. 864 消息通知，Target -> 供应商
8. 997 功能确认，供应商 <-> Target

通过JSON的方式实现 EDI 系统和 ERP 系统之间的集成是很常见的方案，它可以有效地将两个系统解耦，从而提高整个系统的可靠性和可维护性。

通过JSON的方式，EDI 系统和 ERP 系统可以分别将需要传输的数据以JSON文件的形式存储在指定路径，然后另一方系统再从指定路径中获取JSON进行处理。这样可以避免直接修改对方系统中的数据，从而减少数据传输过程中的风险和错误。

以下端口构成了工作流的核心元素：

1. AS2 端口：用于通过 Internet 网络进行安全传输的功能，确认 Target DVS 的AS2信息，如AS2 ID，URL 及公钥证书，以便进行正确配置。
2. X12 端口：从 XML 生成 EDI 文件或将 EDI 文件转换为 XML 以供进一步处理。
3. XMLMap 端口：提供可视化的方式将 XML 数据从一种结构转换为另一种结构，建立从源文件到模板文件的映射关系。
4. Branch 端口：对 XML 进行判断匹配区分不同业务类型的文件。
5. Notify 端口：向指定的收件人发送电子邮件通知。
6. Script端口：利用应用程序底层引擎中支持的 ArcScript 功能来进行各种可编程操作，例如重命名等。
7. JSON端口：实现 JSON 文件与 XML 文件相互转换的功能。

如何在知行之桥EDI系统中部署上述工作流？

准备下载和运行

Target DVS EDI 到 Json

使用 Json 生成一系列 EDI 文档与 Target 通信。

下载工作流  下载示例文件 

创建工作区

运行知行之桥 EDI 系统，导航到工作流选项卡并单击右上角的齿轮图标。 选择创建工作区选项为此示例流创建一个新的工作区 Target_DVS。

导入工作区

右侧齿轮下拉菜单中，单击导入工作区。 在出现的对话框中，选择下载的示例流 Target_DVS.arcflow 以导入相关的端口和设置。 或者直接将 Target_DVS.arcflow 拖拽到指定工作区。

成功导入示例工作流后，你将看到如下图所示的完整工作流：

成功导入示例流后，你可以开始配置端口以最适合你的特定用例。

完善工作流配置

完善工作流配置

导航到 Target_AS2 端口的设置选项卡。 根据 Target 提供的 AS2 文档配置 Target 的 AS2 信息，比如，Target 的 AS2 ID、交易伙伴 URL、交易伙伴证书。 配置完成后请导航到“输入”选项卡上传测试文件与 Target 进行 AS2 连接测试，同时可以导航到 “输出” 选项卡查看 Target 发送的文件。

同时需要配置AS2个人设置：供应商的 AS2 ID，私钥证书，证书密码，公钥证书。

实现从 X12 到 数据库 XML 的格式转换

实现文件格式转换主要借助 X12 端口以及 XMLMap 端口实现，其中 XMLMap 端口已经对数据映射进行了预配置，用户无需进行额外操作。 X12 端口中，需要在 设置 选项卡下填写用户和 Target 的真实信息，对交换头进行配置：

进入测试流程

以解析方向（即接收 Target 发来的 EDI 850 采购订单，对其进行格式转换后得到自定义 JSON）为例，测试流程如下：

上传测试文件

导航到端口 ID 为 Target_X12ToXML 的 X12 端口中，在 输入 选项卡下上传此前下载的示例文件：850.edi。

查看 JSON 结果

X12 端口发出后，导航到端口 ID 为 Target_850_JSON 的 JSON 端口中，在 输出 选项卡下可以看到刚刚接收的850文件的状态为 Success ，这时就可以下载JSON查看订单数据了。

如下所示，此为接收到的一条来自Target的采购订单的JSON。

 {
    "po_header": {
        "poType": "Dropship",
        "poNumber": "1000873599",
        "releaseNumber": "",
        "poDate": "20200429",
        "contractNumber": "9859",
        "orderNumber": "123456",
        "coverageCode": "36",
        "warehouseNumber": "M46D",
        "vendorNumber": "123456",
        "deliveryDateCode": "Non - Upgradeable",
        "estimatedShipDate": "20171219",
        "guestOrderDate": "20171231",
        "estimatedDeliveryDate": "20171222",
        "scacCode": "UPSN",
        "routingDescription": "NS",
        "serviceLevelCode": "G2",
        "orderDescription": "Thank you for your purchase. If you ordered additional items they will arrive separately.",
        "soldToName": "EDI Helpdesk",
        "additionalSoldToName": "",
        "soldToAddress": "7000 Target Parkway ",
        "soldToCityName": "Brooklyn Park",
        "soldToStateOrProvinceCode": "MN",
        "soldToPostalCode": "55445",
        "soldToCountryCode": "US",
        "soldToContactName": "",
        "soldToElectronicMailNumber": "",
        "soldToTelephoneNumber": "",
        "billToName": "Target.com Accounts Payable",
        "additionalBillToName": "",
        "billToAddress": "TNC 3110 PO Box 1296",
        "billToCityName": "Minneapolis",
        "billToStateOrProvinceCode": "MN",
        "billToPostalCode": "55440",
        "billToCountryCode": "US",
        "billToContactName": "",
        "billToElectronicMailNumber": "",
        "billToTelephoneNumber": "",
        "shipToName": "EDI Helpdesk",
        "additionalShipToName": "",
        "shipToAddress": "7000 Target Parkway ",
        "shipToCityName": "Brooklyn Park",
        "shipToStateOrProvinceCode": "MN",
        "shipToPostalCode": "55445",
        "shipToCountryCode": "US",
        "shipToContactName": "EDI Help Desk",
        "shipToElectronicMailNumber": "",
        "shipToTelephoneNumber": "612-304-3310",
        "po_detail": [
            {
                "lineNumber": "1",
                "quantityOrdered": "3",
                "measurementUnit": "Each",
                "unitPrice": "12.3",
                "unitPriceMeasurement": "Price per Each",
                "buyerCatalogNumber": "790-01-2022",
                "europeanArticleNumber": "",
                "eanNumber": "",
                "isbnNumber": "",
                "buyerItemNumber": "15013163",
                "stockKeepingUnit": "7680-02009152",
                "eanCaseCode": "",
                "eanShippingContainerCode": "",
                "upcConsumerPackageCode": "846186077111",
                "productDescription": "WR CARGO SHO 38 BLK SOLID",
                "messageText": "Mail In or Store",
                "wrappingMaterialDescription": "",
                "packingSlipDescription": "This item must be returned within 90 days of the ship date."
            },
            {
                "lineNumber": "2",
                "quantityOrdered": "1",
                "measurementUnit": "Each",
                "unitPrice": "4.33",
                "unitPriceMeasurement": "Price per Each",
                "buyerCatalogNumber": "390-32-0999",
                "europeanArticleNumber": "",
                "eanNumber": "",
                "isbnNumber": "",
                "buyerItemNumber": "13498855",
                "stockKeepingUnit": "783323323",
                "eanCaseCode": "",
                "eanShippingContainerCode": "",
                "upcConsumerPackageCode": "394949039444",
                "productDescription": "WR CARGO SHO 39 BLK SOLID",
                "messageText": "Mail In or Store",
                "wrappingMaterialDescription": "",
                "packingSlipDescription": "This item must be returned within 90 days of the ship date."
            }
        ]
    }}

你启动并运行了吗？

如果答案是肯定的，那么恭喜你成功地配置了 Target DVS EDI 示例工作流！

阅读原文