Skip to content

工作流初始化(版本 >= 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

java
// 简单案例参考 请按实际业务为准
// #{@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,提供发起、审批、变量设置与查询等能力。
用于业务模块与工作流模块交互,避免直接依赖工作流模块。

输入图片说明

砚考 · 让每一次考试都经得起检验