集成流配置
集成流定义 Soln 本地表单与外部表单之间的数据流转方式。它归属于选中的 OpenLink：先打开 OpenLink，选择目标 OpenLink，再从详情操作进入 集成流配置。
配置分成三层，各管一段：
| 层级 | 位置 | 负责 |
|---|---|---|
| 流程列表 | 集成流配置页面 | 创建流程、搜索、启停、立即执行、删除流程 |
| 流程详情 | 列表右侧面板 | 查看基础信息、描述、子表配对和审计信息 |
| 设计画布 | 打开流程设计画布 | 配置流程节点、字段映射和数据转换，保存并发布版本 |
一、流程类型
新建外部集成流时先选流程类型，它决定流程做什么、能选哪些触发方式，以及是否需要绑定表单。
| 流程类型 | 作用 | 表单绑定 |
|---|---|---|
| 入站 | 把外部表单数据同步到 Soln 本地表单 | 需要；入站 + Webhook 时可以选择不绑定 |
| 出站 | 把 Soln 本地记录发送到外部表单或外部系统 | 需要 |
| 查询数据 | 供外部调用方读取 Soln 本地表单记录，只返回数据、不写入数据 | 只选本地主表单，不配对外部表单 |
| 消息推送 | 由外部系统调用 Webhook 触发的通知流程，不绑定表单、不写入表单数据 | 不需要 |
二、触发方式
触发方式决定流程怎么启动，可选范围由流程类型决定。
| 流程类型 | 可选触发方式 |
|---|---|
| 入站 | Webhook、轮询、服务调用 |
| 出站 | 推送、定时、服务调用 |
| 查询数据 | Webhook |
| 消息推送 | Webhook |
| 触发方式 | 说明 |
|---|---|
| 服务调用 | 由审批或自动化节点携带业务上下文调用，不作为用户手动触发入口 |
| Webhook | 外部系统向生成的地址发送 POST JSON 请求触发流程；入站流程使用入站 Webhook 地址，查询数据使用查询接口，消息推送使用推送接口 |
| 轮询 | Soln 按 Cron 表达式运行源 Studio 脚本，分页拉取外部数据，并在成功后推进 Cursor |
| 定时 | 出站流程专用的轮询：按 Cron 表达式启动出站流程，不轮询外部系统，复用同一套调度链路 |
| 推送 | 本地记录发生新增、更新或删除时，Soln 主动推送数据 |
触发方式相关配置
| 配置 | 适用触发方式 | 说明 |
|---|---|---|
| Cron 表达式 | 轮询、定时 | 新建时必填，例如 0 */5 * * *；后续可在编辑窗口中修改 |
| Webhook URL | Webhook | 创建并启用后，外部系统向该地址发送 POST JSON 触发流程；地址在流程编辑窗口中查看 |
| 推送时机 | 推送 | 新增、更新、删除，至少选择一种 |
| 执行重叠策略 | 推送 | 同一条来源记录发生执行重叠时顺序执行还是并行执行 |
推送执行重叠策略
只用于 出站 + 推送 流程，作用范围是当前租户、当前流程和同一条来源记录；它不会让整个流程串行，不同来源记录始终可以并行。
| 策略 | 行为 | 适用场景 |
|---|---|---|
| 同记录顺序执行 | 同一条来源记录上一次执行未完成时再次触发，后一次执行排队等待；默认策略 | 同一记录的事件必须保持顺序，或外部目标不支持对同一记录并发写入 |
| 允许并行执行 | 每次事件在运行资源允许时立即开始，同一记录的重叠事件也可以同时执行 | 外部操作并发安全，且事件先后顺序不影响结果 |
例如采购订单 PO-100 的第一次出站调用还在运行，它又更新了一次：使用 同记录顺序执行 时，第二次执行保持排队，直到第一次执行成功、失败、取消或重试耗尽后再开始；使用 允许并行执行 时两次调用同时运行。无论选择哪种策略，PO-101 都可以与 PO-100 并行。
如果一次业务变化涉及 10,000 条不同记录，系统不会把它们放进一个全局串行队列；该策略只决定同一条记录与自身重叠时如何处理，不同记录的实际并发量仍由运行资源和任务调度决定。
三、列表、详情与状态
列表页面
| 区域 | 说明 |
|---|---|
| 返回 | 返回 OpenLink 页面 |
| 搜索外部集成流 | 按关键字筛选流程列表 |
| 新建外部集成流 | 打开新建窗口 |
| 摘要卡片 | 展示入站流程、出站流程、查询数据、消息推送、启用流程和停用流程的数量 |
| 流程列表 | 展示流程名称、编码、表单绑定、本地/外部表单、触发方式、状态、版本状态和审计信息 |
| 列表操作 | 查看流程详情、打开流程设计画布、查看执行日志、立即执行一次、启用流程、停用流程、删除流程 |
| 配置入站保护 | 设置当前租户的入站保护：每分钟请求数和最大并发请求数 |
流程状态与版本
| 状态 | 说明 |
|---|---|
| 草稿 | 新建流程的初始状态；可以编辑，但不会运行 |
| 已发布 | 存在已发布版本，可以启用运行 |
| 已归档 | 流程已归档，不再作为常规流程使用 |
列表还会展示版本状态：没有可用版本时显示 无，存在已配置版本时显示 已配置。启用流程时会发布当前最新可用版本。
四、新建外部集成流
- 从选中的 OpenLink 进入 集成流配置
- 点击 新建外部集成流
- 填写 流程名称
- 选择 流程类型
- 选择 触发方式
- 按触发方式填写 Cron 表达式，或推送时机与执行重叠策略
- 按需填写 描述
- 选择 本地主表单；入站 + Webhook 或消息推送可以跳过表单绑定
- 选择 外部主表单
- 需要映射明细记录时添加子表配对
- 点击 创建
| 字段 | 必填 | 说明 |
|---|---|---|
| 流程名称 | 是 | 显示在流程列表和执行日志中的名称 |
| 流程类型 | 是 | 入站、出站、查询数据或消息推送 |
| 触发方式 | 是 | 可选范围由流程类型决定 |
| Cron 表达式 | 轮询、定时时必填 | 例如 0 */5 * * * |
| 推送时机 | 推送时必填 | 新增、更新、删除，至少选择一种 |
| 执行重叠策略 | 推送时必填 | 默认 同记录顺序执行 |
| 描述 | 否 | 说明这条同步链路 |
| 是否绑定表单 | 入站 + Webhook 时可选 | 消息推送流程不绑定表单 |
| 本地主表单 | 绑定表单时必填 | 与外部主表单配对的 Soln 表单 |
| 外部主表单 | 绑定表单且不是查询流程时必填 | 与本地主表单配对的外部表单 |
| 子表配对 | 否 | 本地子表与外部子表的配对 |
流程编码由流程名称自动生成，不需要单独填写。如果当前的流程类型、触发方式和主表配对能复用已有表单绑定，Soln 会直接复用，否则为该流程创建新的绑定。
新建的流程先以草稿创建。启用前需要进入设计画布完成映射和节点配置。
主表与子表配对
| 配对 | 说明 |
|---|---|
| 本地主表单 | 流程使用的主要 Soln 表单 |
| 外部主表单 | 流程使用的主要外部表单 |
| 本地子表 | 本地主表单下的子表或明细表 |
| 外部子表 | 与外部主表单相关的外部子表 |
外部子表候选包括外部主表单的直接子对象，以及通过已启用外键字段引用外部主表单的外部对象。同一个本地子表或外部子表只能出现在一组配对中，每行都必须同时选择本地和外部两侧才能保存。
已经添加子表配对后，再切换主表配对会清空已有的子表草稿。
流程创建后，可以在设计画布中选择开始节点，在 子表配对 下点击 编辑配对，继续添加、替换或删除配对。如果删除或替换的配对已经存在转换映射，Soln 会要求确认；继续后会删除属于失效配对的映射，未修改配对的映射会保留。完成后需要保存或发布画布，变更才会持久化为流程版本。
五、设计画布与版本
在流程列表点击 打开流程设计画布，即可配置流程节点、字段映射、数据转换和目标执行行为。
画布顶部提供 返回、保存、发布、保存并发布、复制 和 请求示例。启用流程前，至少需要一个可用版本。
复制流程
- 打开来源流程的设计画布
- 点击 复制
- 填写新流程名称和可选描述
- 点击 复制 确认
复制前 Soln 会校验当前画布，新流程使用当前通过校验的画布和映射快照，因此也可能包含来源流程尚未保存、但已通过校验的修改。Soln 会自动生成新的流程编码，创建一个独立草稿流程并打开它的画布。
复制结果不会继承来源流程的启用或发布状态、执行日志和已激活的调度计划；轮询或定时流程的调度计划也不会一起复制，需要重新设置 Cron 后再发布。部分流程类型与触发方式不支持复制。
六、运行与调度
启用或停用流程
使用列表操作启用或停用流程。
| 状态 | 影响 |
|---|---|
| 启用流程 | 发布当前最新可用版本，流程可以运行；轮询或定时流程同步启用调度计划 |
| 停用流程 | 流程回到草稿状态；轮询或定时流程同步暂停调度计划 |
流程必须存在可发布版本才能启用，没有版本时会提示先完成画布配置。
立即执行一次
已启用的轮询或定时流程会在列表中显示 立即执行一次：系统通过该流程现有的调度计划立即发起一次执行，入站轮询沿用计划的 Cursor。
调度计划处于暂停状态时也可以立即执行一次，单次执行不会恢复后续定时调度。Webhook 需要真实请求体、推送需要本地记录上下文，因此列表不提供无参数执行按钮。提交后进入执行日志查看结果。
执行日志
使用 查看执行日志 检查流程运行记录，日志会展示触发方式、状态、耗时、业务数据、转换结果、目标执行结果、回调状态和错误信息。
七、编辑与删除
编辑流程
- 选择一个流程
- 打开编辑操作
- 更新流程名称或描述
- 轮询或定时流程按需更新 Cron 表达式
- 推送流程按需更新推送时机和执行重叠策略
- 点击 保存
流程类型、触发方式和主表配对在创建时确定；字段映射和节点行为在设计画布中配置，Webhook 请求地址在编辑窗口中查看。
删除流程
- 选择一个流程
- 点击 删除流程
- 确认删除
删除会永久移除流程定义，只有在该流程及其执行记录不再需要用于配置追踪时才删除。
八、推荐配置顺序
- 准备 OpenLink
- 创建所需的外部表单和外部字段
- 进入 集成流配置，创建草稿流程，选择流程类型、触发方式和表单配对
- 打开设计画布
- 配置映射、转换、来源、目标和其他流程节点
- 保存并发布版本
- 从流程列表启用流程
- 使用立即执行一次、Webhook、调度计划或推送事件测试
- 查看执行日志，并按结果调整流程