You need to enable JavaScript to run this app. Camunda/Zeebe用户任务处理咨询:Spring Boot集成、API调用及Camunda服务适配
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.12 11:54:01