You need to enable JavaScript to run this app. Flowable中使用Java API动态创建ProcessDefinition的方法咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 21:45:08