产品功能详解 · 流程设计开发 ⑥

外部事件，怎样触发内部流程
EasyLink 路由（Endpoint）功能详解

路由（Endpoint）用于将适配器服务（HTTP、SFTP、JMS、文件等）与具体的执行流程相关联。系统监听特定入口请求或事件，并触发相应的流程处理逻辑。

📌 来源：聚信万通市场部 · 易连EDI

🗓 发布：2026-09-16

⏱ 阅读时长：约 4 分钟

一、路由是什么：连接外部与内部的“接线端子”

路由（Endpoint）是 EasyLink 平台中的核心功能，主要用于将适配器服务（如 HTTP、SFTP、JMS、文件等）与具体的执行流程进行关联。通过配置路由，系统能够监听特定的入口请求或事件，并触发相应的流程处理逻辑。

图 1  新增路由入口

二、两种触发机制

机制	说明	典型场景
被动接收	等待外部系统调用本平台暴露的接口	伙伴通过 HTTP 接口推送报文
主动监听	平台主动监听队列、轮询目录或按时间触发	MQ 监听、文件目录轮询、定时任务

三、路由类型速查

点击“新增路由”或在列表中点击“编辑”，在弹出的对话框中选择路由类型。

图 2  路由类型选择

路由类型	说明	适用场景
HTTP 路由	用于暴露 RESTful API 接口	同步请求响应场景
IBM MQ 静态路由	连接 IBM MQ 队列管理器，监听指定的固定队列	传统企业级消息集成
IBM MQ 动态路由	支持动态指定队列名称或路由逻辑	多租户或动态队列场景
JMS 路由	基于 Java 消息服务标准的通用消息路由	符合 JMS 规范的消息中间件
File 路由	监听本地文件系统的指定目录，目录中出现新文件时触发	落地文件自动处理
定时任务	周期性触发器	无需外部触发的定期数据处理或报表生成

四、通用配置参数

无论选择哪种路由类型，通常都需要配置以下基础信息。

参数名称	说明
名称	路由的唯一标识名称，建议具有业务含义（如 edi_endpoints）
类型	选择上述列表中的具体路由协议
高级参数	针对特定协议绑定适配器、匹配规则及执行流程

⚠ 保存后记得检查状态 配置完成后，请确保点击“确认”保存，并检查路由状态是否已启动，以便正常接收请求。

五、实操：以 File 路由为例

图 3  File 路由配置界面

基础信息

•  名称

输入路由的唯一标识名称。建议采用具有业务含义的命名规范（如 oftp_out_endpoints），以便于后续维护和检索。

•  类型

选择路由的协议类型为 File 路由。

适配器配置

适配器用于从指定物理资源（如文件目录、数据库、消息队列）收取文件。

•  高级参数

开启此开关后，将显示适配器的详细配置项，通常用于复杂的连接设置。

•  适配器名称

从下拉列表中选择已配置好的适配器实例。对于 File 路由，此处应选择指向特定本地目录的文件适配器；如果列表为空，请前往“适配器”模块先行创建。右侧的蓝色刷新按钮用于同步最新的适配器列表。

路由规则与流程绑定

这一部分定义了“什么条件下触发”以及“触发后做什么”。

图 4  匹配规则、路径参数与执行流程绑定

配置项	说明	示例
匹配规则	用于过滤触发条件，文件路由下通常填写文件名的正则表达式，只有符合规则的文件才会触发后续流程	.*\.csv、.*\.edi
路径参数	若匹配规则中包含动态变量，可在此定义这些变量以便在流程中引用	(?<from>.*)\\(?<to>.*)\\(?<filename>.*)
执行流程	选择当路由被触发后需要执行的处理流程；路由接收到的数据将作为输入参数传递给该流程	oftp_send

💡 路径参数是文件路由的隐藏利器 用命名捕获组把目录结构里的业务信息（如发送方、接收方、文件名）提取成变量，流程里就能直接引用，不必再在脚本里拆解路径字符串。目录规划得好，流程处理逻辑会简单很多。

六、两个配置提醒

•  匹配规则要足够精确

过于宽松的规则可能把临时文件、隐藏文件一并纳入触发范围，造成重复处理。

•  先有服务，再配路由

路由里的“适配器名称”来自服务模块。如果下拉列表为空，需要先到服务模块创建适配器。

七、小结

路由回答的是“什么事件、触发哪条流程”。它把外部世界的请求与内部流程接在一起，并通过匹配规则与路径参数把触发条件描述得足够精确。下一篇讲服务（适配器）——路由所依赖的通信能力由它提供。

📌 想进一步了解 EasyLink 的产品能力，或获取本文对应模块的配置支持，欢迎访问 www.sinowintop.com 与我们联系。