工作流初始化(版本 >= 2.3.0)
前置要求
- 在
application-common.yml中配置消息队列(默认 RabbitMQ) - 可替换为 Kafka、RocketMQ 等(详见
ruoyi-common-bus模块) - 业务服务需引入
ruoyi-common-bus模块,用于同步流程与业务状态

Warm-Flow 官方文档
更多用法与源码细节请参考官方文档:
https://warm-flow.dromara.org/
快速体验流程
1. 导入示例流程
找到项目 script/leave 目录。

2. 上传流程定义
进入流程定义页面,使用“部署流程文件”上传 leave 目录下的 JSON 文件。


3. 查看已导入流程

4. 发布并发起流程
发布流程后,新建请假申请并提交,可查看审批流转信息。





新建自己的流程
1. 新增或复制流程
点击流程定义页面新增按钮 这里我们查看已经写好的leave1点击编辑按钮


新增流程后会跳转到未发布的流程页面 如果需要改动已发布的流程需要先复制流程

复制完成后会跳转到未发布页面与新增逻辑一致

2. 进入流程设计器


3. 编辑并保存流程
重点注意: 流程开始节点后必须跟着申请人节点 因为需要做申请人的业务处理比如驳回到申请人 申请人重新填表 申请人按钮权限等操作 申请人节点不需要填写具体的处理人

4. 节点参数与表达式
设计器节点参数支持 SpEL 表达式,可调用 Bean 方法或使用变量占位符:
#{@deptService.getLeader()}${办理人变量}
更多用法参考: https://warm-flow.dromara.org/master/advanced/variableStategy.html
// 简单案例参考 请按实际业务为准
// #{@deptService.getLeader()}
// #{@deptService.getLeader1(#handler1)}
@Service
// @Service("ssssss") // 重命名成自己喜欢的名字 方便书写查找 #{@ssssss.getLeader()}
public class DeptService {
// 获取部门领导
public String getLeader() {
return "1";
}
// 获取其他流程变量当参数
public String getLeader1(String handler1) {
return "1";
}
}

5. 发布流程
保存后点击“发布流程”。

点击 发布流程 发布修改完成的流程

发布完成后 会跳转到 已发布 页面 流程版本号已经变成新的版本号了

开发接入要点
- 前端需编写业务表单与节点表单(可参考
leaveEdit.vue) - 表单完成后在菜单管理中配置路由地址
- 框架目前仅支持自定义表单,动态表单能力有限





最后将写好的表单加入到菜单管理内 流程定义页面直接填表单的路由地址即可

这里说明 框架目前只支持自定义编写表单使用 因为自定义编写业务表单可以最大程度的适配各种复杂的业务
动态表单 适用于简单业务(warm-flow官方后续会增加此功能) 表单能力与数据交互能力均有限 目前不支持
画流程图注意事项
所有的流程开始都必须有一个申请人节点 注意是必须的 办理人内容不需要填
为什么需要他 因为我们需要一个节点来承托申请人的各种事件 比如驳回到申请人 退回到申请人 流程草稿化 等等 申请人的各种功能都需要这个节点来承接

后端除业务 CRUD 外,需要实现三个监听器(参考 TestLeaveServiceImpl)。



监听器说明:
processHandler:流程状态监听(草稿、撤销、退回、作废、终止、完成等)processTaskHandler:任务创建监听(上一任务完成事件)processDeleteHandler:流程删除监听(同步清理业务数据)
事件注解示例:
@EventListener(condition = "#processEvent.flowCode=='业务code'")
WorkflowService API
通用接口位于 common-core 模块的 WorkflowService,提供发起、审批、变量设置与查询等能力。
用于业务模块与工作流模块交互,避免直接依赖工作流模块。
