设计工作流

本文介绍如何在可视化画布上创建和编辑工作流模型。

创建新工作流

说明：工作流结构（节点与连线）的创建、加载、编辑与回写，主要都在 设计工作流模型 页面完成。设计页通过右侧抽屉中的 工作流模型 → 下载 / 上传 与模型数据交互；已发布版本也可以通过 已发布工作流模型 → 下载 加载到画布中查看或复用。

主要步骤：

1. 在主菜单中打开 工作流 → 设计工作流模型，进入可视化设计画布。

2. 如果要编辑已有草稿模型，打开右侧抽屉，在 工作流模型 下点击 下载，选择一个已有模型加载到当前画布；如果是新建流程，也可以直接在空白画布上开始设计。

3. 编辑模型结构的推荐流程（设计页面为主）：

   • 在 设计工作流模型 页面直接添加、删除和调整节点与连线。
   • 需要复用已有草稿时，使用右侧抽屉中的 工作流模型 → 下载 将模型结构加载到画布。
   • 需要参考已发布版本时，使用右侧抽屉中的 已发布工作流模型 → 下载 将发布快照加载到画布。
   • 完成编辑后，使用右侧抽屉中的 工作流模型 → 上传，将当前画布结构回写为工作流模型；此时会进入模型保存流程，用于填写或确认名称、描述、类型、状态、版本、负责人等元数据。

4. 发布（可选）：发布流程实现与表单模块一致。通常在 工作流 → 发布工作流模型 页面中选中草稿模型并点击 立即发版：

   • 系统对模型元数据与结构进行校验（使用与表单发布相同的校验逻辑），并在校验失败时返回详细错误信息供修正。
   • 校验通过后，系统生成发布快照（Release）并返回发布结果（含发布 ID/版本信息）。
   • 若发布失败，请返回 设计工作流模型 页面修正节点、连线或属性，然后重新上传并再次发版。

提示：

• 设计工作流模型 页面是结构编辑、加载与上传的主入口；发布工作流模型 页面负责对草稿模型执行发版。
• 发布交互与表单模块的实现模式（校验、错误展示、确认发布）一致，建议参照表单模块的实现以保证前后端契合与一致的用户体验。

设计界面

设计界面分为三个区域：

区域	说明
工具栏（顶部）	添加节点、连线、撤销、保存等操作按钮
画布（中部）	拖拽和编辑节点与连线的主区域
属性面板（右侧）	显示和编辑选中元素的属性

添加节点

1. 在工具栏中选择要添加的节点类型：
   • 开始事件：流程起点（必须有且仅有一个）
   • 结束事件：流程终点（至少一个）
   • 活动：中间的任务节点
   • 网关：分支判断节点
2. 点击工具栏按钮后，在画布上点击放置节点。

创建连线

1. 将鼠标移到节点边缘，会出现连接 锚点。
2. 从一个节点的锚点拖拽到另一个节点的锚点，即可创建连线。
3. 连线的方向表示流程的流转方向。

提示

您可以通过选中连线后在属性面板中设置 分支标识 (branch_key)，用于网关节点的条件路由。

编辑节点属性

选中一个节点后，右侧属性面板会显示：

• ID：节点唯一标识（自动生成）。
• 层级 (Z-Index)：控件叠放顺序。
• 关联数据实体：将节点绑定到数据实体（如表单）。

活动节点

活动节点可以设置：

• 任务类型：用户任务（需要人工处理）/ 服务任务（自动执行）/ 子流程
• 关联表单：当任务类型为"用户任务"时，可绑定表单让执行人填写

网关节点

网关节点可以设置：

• 关联数据实体：绑定用于判断条件的数据来源
• 出口连线的 分支标识：每条出口连线设置不同的 branch_key

保存设计

完成设计后，点击工具栏的 保存 按钮保存。保存后的流程处于 草稿 状态。

注意

请确保流程结构完整（有开始事件、结束事件、所有节点都有入边和出边），否则发布时将会校验失败。