【2.0 教程】第 6 章：工作流，让系统自动干活

🎉NocoBase V2 系列教程已在官网-教程专栏发布，点击链接前往查看。
https://docs.nocobase.com/cn/tutorials/v2/

已发布教程速览：

NocoBase 2.0 入门教程 —— IT 工单系统

第一章：认识 NocoBase — 5 分钟跑起来

第二章：数据建模 — 给工单系统搭骨架

第三章：搭建页面 — 让数据看得见

第四章：表单与详情 — 让数据填得进

第五章：用户与权限 — 谁能看什么

第六章：工作流 — 让系统自己动起来

第七章：仪表盘 — 一眼看全局

本文为NocoBase V2 系列教程第 6 章：工作流 — 让系统自动干活

在这个系列里，我们会从零开始，用 NocoBase 搭建一个极简的工单系统（HelpDesk）。整个系统只需要 2 张数据表，不写一行代码，即可实现工单提交、分类管理、变更追踪、权限控制和数据仪表盘。

上一章我们给系统加上了权限，不同角色看到不同的内容。但所有操作还是靠人手动完成——新工单来了要自己去看，状态改了没人知道。

这一章，我们用 NocoBase 的工作流让系统自动干活——配置条件判断和自动更新节点，实现工单状态自动流转和创建时间自动记录。

6.1 什么是工作流（Workflow）

工作流就是一套自动化的"如果……那么……"规则。

打个比方：你手机上设了个闹钟，每天早上 8 点响。闹钟就是最简单的工作流——条件满足（到了 8 点），就自动执行（响铃）。

NocoBase 的工作流也是同样的思路：

触发器：工作流的入口。比如"有人创建了一条新工单"或"某条数据被更新了"
条件判断：可选的过滤步骤。比如"只有处理人不为空时才继续"
执行动作：真正干活的步骤。比如"发送通知"或"更新某个字段"

工作流的执行动作可以串联多个节点，常用的节点类型有：

流程控制：条件判断、并行分支、循环、延时
数据操作：新增数据、更新数据、查询数据、删除数据
通知与外部：通知、HTTP 请求、运算

本教程只用到其中最常见的几个，学会组合后就能应对大多数场景。

触发器类型一览

NocoBase 提供了多种触发器类型，在创建工作流时选择：

触发器	说明	典型场景
数据表事件	数据新增、更新或删除时触发	新工单通知、状态变更记录
定时任务	按 Cron 表达式或固定时间触发	每天生成日报、定期清理过期数据
操作后事件	用户在界面执行操作后触发	表单提交后发送通知、记录操作日志
审批	发起审批流程，支持多级审批	请假审批、采购审批
自定义操作	绑定到自定义按钮，点击触发	一键归档、批量操作
操作前事件	拦截用户操作，同步执行后再放行	提交前校验、自动补全字段
AI 员工	将工作流作为工具提供给 AI 员工调用	AI 自动执行业务操作

本教程会用到 数据表事件 和 自定义操作事件 两种触发器，其他类型的用法类似，学会后就能举一反三。

NocoBase 的工作流是内置插件，不需要额外安装，开箱即用。

6.2 场景一：新工单自动通知处理人

需求：当有人创建了一条新工单，并且指定了处理人，系统自动给处理人发一条站内消息，让他知道"有活儿来了"。

第一步：创建工作流

打开右上角插件配置菜单，进入 工作流管理。

点击新建，在弹出的对话框中：

名称：填写"新工单通知处理人"
触发器类型：选择 数据表事件

提交后，点击列表中的配置链接，进入流程编辑界面。

第二步：配置触发器

点击顶部的触发器卡片，打开配置抽屉：

数据表：选择主数据源 / 「工单」
触发时机：选择「新增或更新数据后」
发生变动的字段：勾选「处理人（Assignee）」——只有处理人字段变了才触发，避免其他字段的修改产生不必要的通知（新增数据时，所有字段都被视为发生变动，所以新建工单也会触发）
满足以下条件才触发：模式选「满足组内任意条件」，添加两个条件：
- assignee_id 不为空
- Assignee / ID 不为空
为什么要配两个条件？因为触发时表单里可能只有外键（assignee_id）而没有查出关联对象，也可能有了关联对象但外键字段为空。两个条件用 OR 关系，确保只要指定了处理人就一定触发。
预加载关联数据：勾选「Assignee」——后续通知节点需要用到处理人的信息，必须在触发器里提前加载

点击保存。这样，触发器本身就完成了条件判断——只有处理人不为空时才触发，不需要额外添加条件判断节点。

第三步：添加通知节点

点击触发器下方的 +，选择通知节点。

打开通知节点的配置，第一项就是选择 通知渠道——但我们还没有创建过渠道，下拉列表是空的。先去创建一个。

第四步：创建通知渠道

NocoBase 支持多种通知渠道类型：

渠道类型	说明
站内信	浏览器内通知，实时推送到用户的通知中心
邮件	通过 SMTP 发送邮件，需要配置邮件服务器

本教程使用最简单的 站内信 渠道：

打开右上角插件设置，进入 通知管理
点击 新建渠道

渠道类型选择 站内信，填写渠道名称（如"系统站内信"）
保存

第五步：配置通知节点

回到工作流编辑页面，打开通知节点的配置。

通知节点有以下配置项：

通知渠道：选择刚才创建的「系统站内信」
接收人：点击选择查询用户 → 「id = 触发器变量/触发数据/责任人/ID」
标题：填写通知标题，如"你有一条新工单待处理"。支持插入变量，比如加上工单标题：新工单：{{触发数据 / 标题}}
内容：填写通知正文，同样可以插入变量引用工单的优先级、描述等字段

(下一步我们去找工单地址，退出弹窗之前，记得先保存！)

桌面端详情页：填写工单详情页的 URL 路径。获取方式：在前端打开任意一条工单的详情弹窗，复制浏览器地址栏中的路径，格式类似 /admin/camcwbox2uc/view/d8f8e122d37/filterbytk/353072988225540。将路径粘贴到配置框中，其中 filterbytk/ 后面的数字就是工单 ID——把这部分替换为触发数据的 ID 变量即可（点击变量选择器 → 触发数据 → ID）。配置后，用户在通知列表中点击该通知就能直接跳转到对应工单的详情页，同时自动标记为已读