畅链科技文档

简体中文

English

简体中文

English

外观

业务功能主界面 ​

点击对应的项目名即可进入业务功能主界面。包含左侧导航菜单和右侧内容显示区，默认显示仪表盘。

仪表盘

仪表盘 ​

仪表盘包含 EDI 传输数据的统计。

  • EDI 传输数据的统计：
  1. 统计发送、接收、成功、失败的文件数量。
  2. 通过柱状图按小时、日、月维度展示各状态数据，直观对比不同时间段的数据情况。

仪表盘

设置 ​

设置界面分为五大模块：主要设置、邮箱设置、数据库设置、流程参数设置、全局参数设置。

设置

主要设置 ​

  • 配置目录：显示当前项目配置参数、基础数据和运行服务所在根目录。
  • 工作目录：显示当前项目运行服务的工作目录，服务脚本执行、接收发送、服务运行日志等数据，都存储在该目录。
  • 线程数：服务运行时的并发线程数量，可根据服务器性能进行调整。
  • 服务启动选项：配置服务的启动方式或启动行为。
  • 服务自动启动：开启后，服务重启或服务器重启时系统将自动运行当前项目服务。
  • 输出文件分组方式：设置输出文件的存储目录按年/月进行分组归档，便于文件管理。
  • 日志等级：控制日志输出详细程度，可选：错误 / 警告 / 信息 / 调试 / 跟踪。一般建议在试运行阶段，日志级别设置为“调试”状态，正式上线运行之后，可以设置为“警告”或“错误”状态。

邮箱设置 ​

用于异常场景时的邮件通知，该弹窗用于添加新的邮件服务器配置，以便系统在异常场景时发送邮件通知。

邮件服务器(发件箱/邮件触发器) ​

  • 标题：邮件服务器配置的名称标识，带（*）标识为必填项。
  • 参数 KEY：配置的唯一参数键名，用于系统内部调用。
  • 邮件服务器：SMTP 服务器地址。
  • 端口：SMTP 服务器端口，如 SSL 加密通常使用 465 端口。
  • 邮箱：发件人邮箱地址。
  • 密码：发件箱的密码或授权码。
  • 是否使用 SSL：开启后启用 SSL 加密传输。

邮箱设置

常用邮箱 SMTP 端口参考：

邮箱SMTP 服务器SSL 端口非 SSL 端口
163.comsmtp.163.com46525
188.comsmtp.188.com46525
126.comsmtp.126.com46525
netease.comsmtp.netease.com46525
yeah.netsmtp.yeah.net46525
qq.comsmtp.qq.com46525

收件人 ​

  • 发送给 - 配置收件人电子邮箱地址（配置多个电子邮箱地址，使用英文逗号（，）分割）。
  • 抄送给 - 配置抄送人电子邮箱地址（配置多个电子邮箱地址，使用英文逗号（，）分割）。
  • 密送给 - 配置密送人电子邮箱地址（配置多个电子邮箱地址，使用英文逗号（，）分割）。

收件人

邮件通知 ​

  • 发件箱 - 选择发件箱配置。
  • 收件人 - 选择收件人配置。
  • 标题模板 - 配置邮件标题部分模板内容。
  • 内容模板 - 配置邮件正文部分模板内容。

邮件通知

使用邮箱配置 ​

在工作流 Email 模块中可配置 SMTP 服务器、端口、密码、SSL，并支持自定义标题/内容模板及附件。

工作流邮箱配置

数据库设置 ​

用于添加新的数据库连接配置

  • 标题：数据库配置的名称标识。
  • 参数 KEY：配置的唯一参数键名，用于系统内部调用。
  • JDBC Jar 路径：JDBC 驱动 Jar 包的文件路径，用于加载数据库驱动。
  • Driver Class：JDBC 驱动类名称，如 com.mysql.jdbc.Driver。
  • 连接字符串：数据库连接 URL 地址，如 jdbc:mysql://127.0.0.1:3306/dbname。
  • 用户：数据库登录用户名。
  • 密码：数据库登录密码。

数据库

服务 ​

系统支持多种数据传输协议，以满足不同合作伙伴的对接需求。

支持的协议：

  • AS2：基于 HTTP/HTTPS 协议的安全数据传输标准，广泛用于 B2B 通信。

  • OFTP2：Odette 组织制定的文件传输协议第二版，广泛应用于欧洲汽车行业。

    相比 AS2 增加了密码、过期时间、是否加密认证信息、是否压缩/签名数据、是否要求 EERP、加密/签名类型等配置项

  • SAP：SAP 系统专用接口协议，用于与 SAP ERP 系统进行无缝数据集成。

  • SFTP：SSH 文件传输协议，基于 SSH 安全通道进行文件传输。

  • HTTP：超文本传输协议，通过 RESTful API 或 Web Service 方式进行数据交互。

  • 企业微信：企业微信平台集成接口，支持通过企业微信发送消息通知。

在配置 AS2/OFTP2 连接时，必须确保通信双方之间的参数一致，以及正确配置数字证书和安全机制，下面我们以 AS2 为例进行说明。

AS2 配置项说明 ​

  • 主要
  • AS2 ID：每个 AS2 参与者的唯一身份标识。
  • 地址：AS2 服务的监听地址。
  • 端口：AS2 服务的监听端口。
  • 使用 TLS：开启后启用 TLS 加密传输，地址需以 https:// 开头。
  • 连接超时时间（毫秒）：建立连接的最大等待时间，超过设定值时将中断连接。
  • 读取超时时间（毫秒）：等待服务器响应的最大时间。
  • 重试次数：发送失败时的最大重试次数，确保传输可靠性。

在服务界面进行 AS2 服务配置主要配置项包括AS2ID/OFTP2 ID、地址、端口、TLS使用、个人证书的证书名、别名以及密码。配置完成后，即可进一步进行合作伙伴的信息的添加/修改。

服务配置

  • 个人证书

    个人证书通常是用于标识和验证个人身份的数字证书，包括了个人的公钥、个人身份信息和数字签名。

    证书名称 - 包含个人/组织的数字证书（包含私钥的数字证书）。
    证书别名 - 一个用于标识和引用数字证书的易记名称，通常用来标识证书。
    证书密码 - 包含自己私钥的数字证书的密码。

  • 服务器证书

    服务器证书是一种用于确保网络通信安全性的数字证书，它用于验证服务器的身份，并加密在服务器和客户端之间传输的数据。

    证书名称 - 包含的关于实体（通常是个人、组织或设备）身份信息的字段。
    证书别名 - 通常是在使用数字证书时为方便管理和识别而起的别名。
    证书密码 - 用于保护数字证书私钥的密码或密钥。

  • 其他

    家目录 - 各项目工作组所在目录。 输出目录 - 流程处理文件的输出目录。

伙伴列表 ​

展示所有已配置的合作伙伴信息，可配置多组合作伙伴。

  • 伙伴 ID：合作伙伴的 AS2ID。
  • 伙伴名称：合作伙伴名称。
  • URL：合作伙伴的完整通信地址。
  • 操作：编辑或删除。

添加/修改合作伙伴 ​

配置合作伙伴信息及数字证书（包含合作伙伴公钥，对方也需配置我们的公钥），实现 EDI 数据加密传输，确保通信安全可靠。

伙伴列表

工作流 ​

工作流界面允许用户根据业务需求自定义报文处理流程。

  • 工作组：每个工作组可代表一个合作伙伴。
  • 流程：在每个工作组下可创建多个流程（如接收订单、发送标签、发送通知等）。
  • 功能模块：每个流程可包含多个模块（如 AS2 Sender、Email、XML To X12、X12 To XML、写入文件等）。

功能模块支持编写脚本进行高度定制化数据处理。编辑流程通常由实施人员负责，用户无需过多关注细节。

工作流

添加工作组与流程 ​

1. 创建工作组：点击“工作组”，添加新的工作组，输入信息。弹窗中创建并确认。

工作组创建

2. 创建流程：右上角小加号点击创建。在工作组下创建发送或接收流程，自行设置工作流触发方式。

创建流程

3. 编辑工作流：拖拽所需模块至画布，配置属性。

编辑工作流

示例：发送 856 报文流程 ​

根据合作伙伴需求，不同报文的处理流程有所不同。以下为简化示例：

流程说明：

  1. 发送 856 报文至 ${EDI_HOME}/inbox
  2. 解析报文，查询数据库中的状态
  3. 状态判断：
    • 若不是 DELIVERED 或 PRINTED → 发送警告邮件，终止流程
    • 若是正常状态 → 收集订单信息，生成出货 XML
  4. 将 XML 转为 EDI 文件并发送
  5. 更新数据库状态，发送邮件通知用户

856报文例子

运行 ​

用于启动或停止所有配置的服务。

服务启动与运行的详细步骤，请参见 《安装与启动》。

运行

文件日志 ​

查看发送或接收报文的详细记录。

  • 独立文件夹：每个报文的收发记录存放在独立文件夹中。

  • task.log：详细记录成功/失败日志，失败时会标明具体出错环节。

  • 查看全部 EDI 传输记录或者自行左上角选择需要查看的流程工作组记录日志

  • 右侧展开或折叠可查看报文处理流程

  • 操作状态按钮可筛选执行状态

日志文件

收发文件 ​

收发文件：查看所有发送/接收记录，包含时间、业务流程、业务编号、业务类型、合作伙伴 ID、收发类型、状态等信息。

收发文件

发送文件 ​

发送文件：手动向合作伙伴发送报文，发送后可在界面或仪表盘实时查看状态

发送文件