Flowable中使用Java API动态创建ProcessDefinition的方法咨询
Flowable动态创建ProcessDefinition落地指南(含DynamicUserTaskBuilder用法)
核心认知校准
你检索到的DynamicUserTaskBuilder并非用于从零创建完整ProcessDefinition的API,它是Flowable 6.6+版本配套的运行时动态节点调整工具,设计目标是在不重新部署流程定义的前提下,给已运行的流程实例插入、修改用户任务节点。如果要完全替代Flowable Modeler UI的流程搭建能力,需要结合BpmnModel构建API + RepositoryService部署逻辑实现。
全量动态构建ProcessDefinition实现(替代Modeler UI模式)
这种方式生成的ProcessDefinition和通过Modeler画完导出部署的流程完全等价,无功能差异,核心实现步骤:
- 引入flowable-engine核心依赖(无需额外集成Modeler UI模块)
- 通过BpmnModel API逐节点搭建流程结构
- 调用RepositoryService完成部署生成可发起的ProcessDefinition
核心代码示例:
// 1. 初始化BPMN模型根对象 BpmnModel bpmnModel = new BpmnModel(); Process mainProcess = new Process(); mainProcess.setId("dynamicProcess_001"); mainProcess.setName("动态搭建的差旅审批流程"); bpmnModel.addProcess(mainProcess); // 2. 构建各流程节点 // 开始节点 StartEvent startEvent = new StartEvent(); startEvent.setId("start_01"); startEvent.setName("员工发起差旅申请"); mainProcess.addFlowElement(startEvent); // 一级审批用户任务 UserTask deptApprove = new UserTask(); deptApprove.setId("task_deptApprove"); deptApprove.setName("部门经理审批"); deptApprove.setAssignee("${deptManager}"); mainProcess.addFlowElement(deptApprove); // 结束节点 EndEvent endEvent = new EndEvent(); endEvent.setId("end_01"); endEvent.setName("流程归档"); mainProcess.addFlowElement(endEvent); // 3. 配置节点间连线关系 mainProcess.addFlowElement(new SequenceFlow("start_01", "task_deptApprove")); mainProcess.addFlowElement(new SequenceFlow("task_deptApprove", "end_01")); // 4. 部署生成正式ProcessDefinition RepositoryService repositoryService = processEngine.getRepositoryService(); Deployment deployResult = repositoryService.createDeployment() .name("差旅审批流程部署包") .addBpmnModel("travel_approval.bpmn", bpmnModel) .deploy();
如果需要复用之前Modeler创建的流程逻辑,可以直接把原有导出的bpmn xml反序列化为BpmnModel对象,在其基础上做节点修改后再部署,无需从零搭建所有结构。
DynamicUserTaskBuilder 实际使用方法
该能力需要额外引入flowable-dynamic-bpmn模块依赖,典型使用场景是流程上线后,临时调整节点逻辑、给运行中的流程实例插入额外审批节点,核心代码示例:
- 常用可配置项说明
id/name:设置动态任务的唯一标识和展示名称assignee/candidateUsers/candidateGroups:配置任务办理人、候选办理人、候选办理组formKey:绑定任务对应的前端表单地址taskListener:为动态任务绑定自定义的创建、完成、超时监听器
- 核心实现逻辑
// 获取动态BPMN服务实例 DynamicBpmnService dynamicBpmnService = processEngine.getDynamicBpmnService(); // 构建动态用户任务 DynamicUserTaskBuilder dynamicTaskBuilder = dynamicBpmnService.createUserTaskBuilder() .id("task_financeApprove") .name("临时新增的财务复核节点") .assignee("${financeAuditor}") .formKey("auditForm"); // 将动态任务插入到已运行流程实例的指定节点之后,无需重新部署流程 dynamicBpmnService.changeExecutionStateBuilder() .moveActivityIdTo("task_deptApprove", "task_financeApprove") .userTaskBuilder(dynamicTaskBuilder) .processInstanceId(targetProcessInstanceId) .changeState();
常见踩坑提示
- 不要混淆两类API的定位:从零搭建完整流程用BpmnModel+部署接口,运行时动态插节点用DynamicUserTaskBuilder
- 动态构建生成的ProcessDefinition,后续的流程发起、任务办理、历史数据查询逻辑和UI生成的流程完全一致,不需要做额外适配
- 动态插入的用户任务会自动纳入Flowable的任务生命周期管理,支持认领、完成、转办等标准任务操作
内容的提问来源于stack exchange,提问作者M.Ahsen Taqi
相关产品推荐
相关产品推荐

