工作流初始化

Warm-Flow 官方文档复制标题链接

更多用法与源码细节请参考官方文档：

https://warm-flow.dromara.org/

快速体验流程复制标题链接

1. 导入示例流程复制标题链接

找到项目 script/leave 目录。

2. 上传流程定义复制标题链接

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

3. 查看已导入流程复制标题链接

4. 发布并发起流程复制标题链接

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

新建自己的流程复制标题链接

1. 新增或复制流程复制标题链接

在流程定义页点击“新增”，或对已发布流程先“复制流程”。

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）
• 表单完成后在菜单管理中配置路由地址
• 框架目前仅支持自定义表单，动态表单能力有限

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

后端监听器与 API复制标题链接

后端除业务 CRUD 外，需要实现三个监听器（参考 TestLeaveServiceImpl）。

监听器说明：

• processHandler：流程状态监听（草稿、撤销、退回、作废、终止、完成等）
• processTaskHandler：任务创建监听（上一任务完成事件）
• processDeleteHandler：流程删除监听（同步清理业务数据）

事件注解示例：

@EventListener(condition = "#processEvent.flowCode=='业务code'")

WorkflowService API复制标题链接

通用接口位于 common-core 模块的 WorkflowService，提供发起、审批、变量设置与查询等能力。
用于业务模块与工作流模块交互，避免直接依赖工作流模块。