Skip to content

入门指南

如何创建项目

初次启动畅链数据集成平台 (CLIP) 会进入到系统首页,点击“创建新项目”来为新的项目命名并创建到本地,也可以用“使用向导”中我们为您提供的不同种类的现有项目更快上手操作。

快速进入项目

创建完成之后所有的项目都会在项目列表处可见,单击项目名即可进入项目查看项目内具体内容。

仪表盘展示

仪表盘界面涵盖了 EDI 传输数据的统计:

  • EDI 传输数据统计

提供发送、接收、成功和失败文件的数量统计。利用柱状图按小时、日、月等维度展示各状态数据,直观呈现不同时间段之间的对比。

  • 文件日志

显示所有 EDI 传输记录明细。通过点击列表中的展开按钮,用户可以查看接收和发送 EDI 报文后的处理流程记录。文件名可点击以打开接收和发送的数据。列表最后一列的操作按钮可以查看发送/接收是否成功的状态,这一设计提供了全面而直观的 EDI 传输数据概览。

基础参数设置

主要设置

在主要设置里除了配置目录用户不能自行设置,线程数、服务自启相关信息用户均可自行设置。

设置邮件通知

邮件通知中间可以设置邮件通知,用于我们后续的全自动化管理,可以在发送 EDI 消息成功或失败时给用户邮件提醒,在这里我们需要配置发件箱和收件箱,然后设置邮件相关内容,分别设置标题模板、内容模板。

在工作流的 email 设置中,您同样可以配置SMTP服务器、端口、邮箱、密码、SSL使用等选项以启用邮件发送功能,邮箱配置不支持附件功能,因此我们可以在工作流的 email 流程中进行详细配置。

在工作流程编辑中,Email 模块也提供了发送邮件的功能。除了填写与邮箱设置相关的必选项外,用户还能够在自定义邮件的标题模板、内容模板,以及选择是否携带附件等操作后进行发送。相对于设置界面的邮箱设置,Email 模块在编辑流程时提供了更多的功能选项,能够更灵活地配置邮件发送的细节。

数据库设置

配置数据库,只需要配置地址(用于配置 Web 服务请求 API 地址)和间隔时间(用于请求发送之间的间隔时间)即可。

服务配置

配置 AS2/OFTP2 连接

AS2(Applicability Statement 2)和 OFTP2(Odette File Transfer Protocol 2)是两种不同的协议,用于实现安全、可靠的数据交换。它们通常用于业务伙伴之间的 B2B(Business-to-Business)通信,特别是在供应链管理和电子数据交换(EDI)方面。

在配置 AS2/OFTP2 连接时,必须确保通信双方之间的参数一致,以及正确配置数字证书和安全机制,以确保数据的安全传输。这通常需要合作双方的技术团队密切合作,以确保整个过程的顺利进行,下面我们以 AS2 为例进行说明。

在服务界面进行 AS2/OFTP2 服务配置是确保双方系统进行安全、可靠通信的关键步骤。主要配置项包括AS2ID/OFTP2 ID、地址、端口、TLS使用、个人证书的证书名(包含私钥,通常会事先与合作伙伴交换数字证书的公钥)、别名以及密码。

这些配置项涵盖了身份标识、通信细节和安全设置。配置完成后,即可进一步进行合作伙伴的信息的添加/修改,确保整个 AS2/OFTP2 连接的稳定运行。

在合作伙伴的添加/修改界面可以对已有的合作伙伴进行编辑,也可以添加新的合作伙伴,配置了合作伙伴的ID、URL以及包含了合作伙伴公钥的数字证书(如果有密码的话需要输入密码)后就可以进行后续的新建工作组/流程,搭建完工作流之后就可以与合作伙伴通过事先约定好的连接方式进行数据传输了。

工作流搭建

添加工作组/流程

添加完新的合作伙伴后我们就可以在编辑流程出添加对应名字的工作组,在工作组下根据合作伙伴对应的业务流程去创建对应服务,每个服务里可以有对应的功能,这里我们创建一个简单的发送 AS2 报文测试工作组示例:

  1. 创建工作组:点击左上角工作组,在弹窗中创建一个新的工作组,确认即可创建。

  1. 创建流程:创建选择刚刚创建的工作组,创建一个流程,可以是发送,也可以是接收。

  1. 编辑工作流:这里以发送 AS2 报文为例,将 AS2 发送流程拖至工作流中,在其属性中添加要发送的 EDI 文件和接收此报文的合作伙伴即可。

搭建工作流程

搭建工作流程是根据合作伙伴需求进行定制化处理的一个过程,因为不同的合作伙伴在处理不同的报文时需求不同,所以流程也不会完全相同,下面我们以一个简单的发送 856 报文为例进行说明:

这里我们发送一个 856 的报文,发送的报文信息会发送至我们的 ${EDI_HOME}/inbox 文件夹内,拿到文件后我们对其进行解析,在数据库中对其解析出来的 status 进行判断,如果不是 DELIVERED 或者 PRINTED 状态就发送警告邮件,说明状态错误,不应该走这个流程;反之则收集我们需要的订单信息生成对应的出货消息 XML,再转换为我们需要的 EDI 文件进行发送,发送完成之后去更新的数据库状态并向用户发送邮件通知。

服务启动和运行

服务启动运行,请参考“安装与启动”。