Branch端口操作指南

近期的版本升级中，我们的开发团队对 Branch 端口进行了优化改进。本文将使用最新的知行之桥 2023-23.2.8605.0 版本，为大家展开介绍。

Branch 端口概览

使用场景：多种业务类型文件分类时，级联使用。

端口功能：配置确定要查找的值以及要比较的目标值。如果传入值与目标值匹配，则消息将沿着蓝色虚线流路径传递。可以有多个目标值，每个目标值沿着不同的流路径发送消息。如果这些值与任何条件都不匹配，则消息将沿着虚线灰色路径传递。

如上图所示，在工作流界面的右侧找到Branch端口，拖拽至右侧的空白工作区中，即可在工作流中创建一个Branch端口。在右侧的Branch设置中，可以进行如下设置：

1.匹配类型

使用下拉列表指定接收消息时要比较的属性：消息头部，文件名称，Xpath（必须是XML文件，支持所有匹配的XPath、第一个XPath以及一个或多个XPath）

可以点击下图中的蓝色字体：文件名称，进行选择。

2.数据类型

目标值是字符串、数值还是日期时间，如果数据类型选择 字符串，请使用 修剪字符串 和 忽略大小写 复选框来进一步细化比较。如果数据类型选择 DateTime，请使用右侧的字段来指定 DateTime 值的结构。

3.匹配条件

支持的匹配条件包括：全局匹配、等于、不等于、包含、前缀为、后缀为、为空、不为空、属于、不属于、全局匹配以及正则表达式匹配。

Branch 端口的使用场景

在旧版本中，如果需要实现文件分流，则需要多个Branch端口方可实现。例如，我们现需要接收来自交易伙伴的三种业务报文：EDI 830、EDI 862以及EDI 824。需要将这三种文件分为三个分支进行更进一步的处理。在知行之桥 EDI 系统中，搭建如下所示的工作流即可实现：

上图红色方框中的几个端口即为Branch端口，工作流实现的功能为：

命名为 CompanyE_AS2 的AS2端口：接收交易伙伴发来的文件
命名为 CompanyE_X12ToXML 的X12端口：将接收到的EDI 报文转换为XML
命名为 CompanyE_Match_830 的Branch 端口：匹配包含830数据的XML，并发送至下一端口进一步处理。（CompanyE_Match_862以及CompanyE_Match_824同理）
命名为 CompanyE_830_In 的XMLMap端口：将包含830数据的XML通过数据映射，转换为数据库XML。（CompanyE_862_In以及CompanyE_824_In同理）
命名为 CompanyE_DB_830_IN 的MySQL端口：从数据库XML中提取数据，写入数据库表中。（CompanyE_DB_862_IN以及CompanyE_DB_824_IN同理）

在知行之桥 2023-23.2.8605.0 版本中，仅需一个Branch端口即可实现文件分流。如下图所示：

在工作流中可以很直观地看到我们利用Branch端口做了三个全局匹配，并且将符合不同匹配的文件分流至不同的分支中。要想实现以上操作，Branch端口中应该如何设置呢？

进入 Branch 端口的设置页面，按照上图进行配置。如果文件名称中包含我们设置的全局匹配值，则将进入下一个分支。值得注意的是，Branch端口支持设置多个匹配条件，在如下图所示的位置点击添加条件即可。

由于接收到的文件类型有三种，因此我们在这里需要设置三条匹配条件，分别用于匹配文件名中包括：830、862以及824的文件。设置完成后，在Branch端口下方可以看到我们刚刚做的配置信息。

其中三条全局匹配右侧会有三个蓝色箭头，用于连接分支工作流。可以看到 否则 部分右侧有一个灰色箭头。如果传入值与目标值匹配，则消息将沿着蓝色虚线流路径传递。 可以有多个目标值，每个目标值沿着不同的流路径发送消息。 如果这些值与任何条件都不匹配，则消息将沿着虚线灰色路径传递。

通常灰色路径后会连接一个Notify端口，在 设置 选项卡下可以配置通知设置。如果当前文件不符合我们设置的匹配值，文件会传输到Notify端口，此端口会向我们配置好的邮箱中自动发送邮件以作提醒。

点击上图红色方框中的 配置通知设置 即可配置邮箱信息。配置界面如下：

知行之桥 EDI 系统功能概述

借助知行之桥 EDI 系统的工作流设计器，通过简单拖拽、配置，快速搭建从外部通信，EDI 标准报文转换，到与内部系统集成的工作流，实现业务流程完全自动化；同时，针对业务数据量大的情况，知行之桥 EDI 系统也支持部署 HA（高可用集群）方案，实现负载均衡和故障转移，此外系统还支持跨平台部署、审计、多用户权限管理、报表等辅助功能，提高了用户的使用体验。

了解更多 EDI 信息，请参阅: EDI 是什么？

阅读原文