Camunda/Zeebe用户任务处理咨询:Spring Boot集成、API调用及Camunda服务适配
Zeebe 环境实现方案
1. Spring Boot 应用向用户任务传递变量输入
分两种场景实现:
- 启动流程时同步传入变量:直接通过注入的
ZeebeClient调用创建流程实例接口,在variables参数中传入用户任务需要的所有变量即可,示例代码:
@Autowired private ZeebeClient zeebeClient; public String startProcessWithCustomVariables(String emailContent, String recipient) { ProcessInstanceEvent instanceEvent = zeebeClient.newCreateInstanceCommand() .bpmnProcessId("send-email-process") // 替换为你的流程ID .latestVersion() .variables(Map.of( "emailContent", emailContent, "recipient", recipient )) .send() .join(); return String.valueOf(instanceEvent.getProcessInstanceKey()); }
- 流程已启动后传入变量:先查询到对应用户任务的key,调用
newCompleteCommand()完成任务时传入变量,也可以单独调用newSetVariablesCommand()指定流程实例/任务的key主动更新变量。
注意:Zeebe的流程实例key、任务key均为Long类型,传参时不要用字符串格式否则会触发参数校验错误
2. 查询指定实例ID下的活跃任务列表
Zeebe 核心Gateway API没有提供原生的任务查询能力,需要配合官方配套的Tasklist组件实现:
- 你可以直接调用Tasklist的REST接口,过滤参数指定
processInstanceKey为你的实例ID、state为CREATED即可返回所有活跃人工任务 - Spring Boot 项目也可以引入Tasklist Java客户端,直接调用客户端的任务查询方法实现过滤
如果是轻量使用场景,也可以在项目中监听Zeebe的USER_TASK_CREATED事件,把任务信息存入本地数据库自行实现查询逻辑。
3. 借助实例ID直接调用REST API为人工任务传输入
Zeebe Gateway 原生REST API不支持直接通过流程实例ID给任务传参,你需要先通过Tasklist API查询到该实例下的活跃用户任务的taskKey,再调用Tasklist的任务完成接口传入变量即可。你也可以在自定义Spring Boot接口中封装这个逻辑:先根据实例ID查任务key,再调用Zeebe客户端完成任务并传入变量,对外只暴露实例ID和变量参数即可。
Camunda 7(独立服务器)环境实现方案
1. Spring Boot 应用向用户任务传递变量输入
两种常用实现方式:
- 启动流程时同步传参:通过
RuntimeService启动流程时直接传入变量Map即可:
@Autowired private RuntimeService runtimeService; public String startProcessWithVars(String emailContent, String recipient) { ProcessInstance instance = runtimeService.startProcessInstanceByKey( "send-email-process", // 替换为你的流程ID Map.of( "emailContent", emailContent, "recipient", recipient ) ); return instance.getId(); }
- 流程运行中传参:通过
TaskService的setVariable()方法指定流程实例ID/任务ID直接更新变量,或者完成任务时同步传入变量。
2. 查询指定实例ID下的活跃任务列表
Camunda 7 原生提供了完善的任务查询API:
- 集成场景直接用
TaskService查询即可,示例代码:
@Autowired private TaskService taskService; public List<Task> listActiveTasksByInstanceId(String processInstanceId) { return taskService.createTaskQuery() .processInstanceId(processInstanceId) .active() .list(); }
- 调用独立服务器REST API的话,直接发送
GET /task?processInstanceId={你的实例ID}&active=true请求即可得到返回结果。
3. 借助实例ID直接调用REST API为人工任务传输入
先调用上面的任务查询接口拿到对应任务的ID,再调用POST /task/{任务ID}/complete接口,请求体中携带变量参数即可,示例请求体:
{ "variables": { "emailContent": { "value": "自定义的邮件内容", "type": "String" }, "recipient": { "value": "test@example.com", "type": "String" } } }
如果是Spring Boot集成Camunda的场景,直接调用taskService.complete(任务ID, 变量Map)方法即可实现。
内容的提问来源于stack exchange,提问作者Manoj K J
相关产品推荐
相关产品推荐

