AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

36activiti - 用户任务（组任务）

2023-10-31 57
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 36activiti - 用户任务（组任务）
1.流程图

2.分配组任务方式一（直接指定办理人）

1：流程图中任务节点的配置

2：测试代码：

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
  //部署流程定义，启动流程实例
  @Test
  public void testTask() throws Exception {
    // 1 发布流程
    InputStream inputStreamBpmn = this.getClass().getResourceAsStream("taskProcess.bpmn");
    InputStream inputStreamPng = this.getClass().getResourceAsStream("taskProcess.png");
    processEngine.getRepositoryService()//
            .createDeployment()//
            .addInputStream("userTask.bpmn", inputStreamBpmn)//
            .addInputStream("userTask.png", inputStreamPng)//
            .deploy();
    // 2 启动流程
    ProcessInstance pi = processEngine.getRuntimeService()//
              .startProcessInstanceByKey("taskProcess");
    System.out.println("pid:" + pi.getId());
  }
  //3 查询我的个人任务列表
  @Test
  public void findMyTaskList(){
    String userId = "小A";
    List<Task> list = processEngine.getTaskService()//
                    .createTaskQuery()//
                    .taskAssignee(userId)//指定个人任务查询
                    .list();
    for(Task task:list ){
      System.out.println("id="+task.getId());
      System.out.println("name="+task.getName());
      System.out.println("assinee="+task.getAssignee());
      System.out.println("createTime="+task.getCreateTime());
      System.out.println("executionId="+task.getExecutionId());
    }
  }
  //4 查询组任务列表
  @Test
  public void findGroupList(){
    String userId = "小A";
    List<Task> list = processEngine.getTaskService()//
                    .createTaskQuery()//
                    .taskCandidateUser(userId)//指定组任务查询
                    .list();
    for(Task task:list ){
      System.out.println("id="+task.getId());
      System.out.println("name="+task.getName());
      System.out.println("assinee="+task.getAssignee());
      System.out.println("createTime ="+task.getCreateTime());
      System.out.println("executionId="+task.getExecutionId());
      System.out.println("##################################");
    }
  }
  //5 查询组任务成员列表
  @Test
  public void findGroupUser(){
    String taskId = "3709";
    List<IdentityLink> list = processEngine.getTaskService()//
                    .getIdentityLinksForTask(taskId);
         //List<IdentityLink> list = processEngine.getRuntimeService()//
    //        .getIdentityLinksForProcessInstance(instanceId);
    for(IdentityLink identityLink:list ){
      System.out.println("userId="+identityLink.getUserId());
      System.out.println("taskId="+identityLink.getTaskId());
      System.out.println("piId="+identityLink.getProcessInstanceId());
      System.out.println("######################");
    }
  }
  //6 查询组任务成员历史列表
  @Test
  public void findGroupHisUser(){
    String taskId = "3709";
    List<HistoricIdentityLink> list = processEngine.getHistoryService()//
            .getHistoricIdentityLinksForTask(taskId);
        // List<HistoricIdentityLink> list = processEngine.getHistoryService()//
          // .getHistoricIdentityLinksForProcessInstance(processInstanceId);
    for(HistoricIdentityLink identityLink:list ){
      System.out.println("userId="+identityLink.getUserId());
      System.out.println("taskId="+identityLink.getTaskId());
      System.out.println("piId="+identityLink.getProcessInstanceId());
      System.out.println("######################");
    }
  }
  //完成任务
  @Test
  public void completeTask(){
    String taskId = "3709";
    processEngine.getTaskService()//
          .complete(taskId);//
    System.out.println("完成任务");
  }
     /**将组任务分配给个人任务，拾取任务*/
  //由1个人去完成任务
  @Test
  public void claim(){
    //任务ID
    String taskId = "5908";
    //分配的办理人
    String userId = "小B";
    processEngine.getTaskService()//
          .claim(taskId, userId);
  }
/**将个人任务回退到组任务（前提：之前组任务）*/
  @Test
  public void assignee(){
    //任务ID
    String taskId = "5508";
    processEngine.getTaskService()//
          .setAssignee(taskId, null);
  }
/**向组任务中添加成员*/
  @Test
  public void addCadidateUser(){
    //任务ID
    String taskId = "5508";
    //添加的成员
    String userId = "小E";
    processEngine.getTaskService()//
          .addCandidateUser(taskId, userId);
  }
/**从组任务中删除成员*/
  @Test
  public void deleteCadidateUser(){
    //任务ID
    String taskId = "5508";
    //添加的成员
    String userId = "小D";
    processEngine.getTaskService()//
          .deleteCandidateUser(taskId, userId);
  }

分析:

  1. 小A，小B，小C，小D是组任务的办理人
  2. 但是这样分配组任务的办理人不够灵活，因为项目开发中任务的办理人不要放置XML文件中。
  3. act_ru_identitylink表存放任务的办理人，包括个人任务和组任务，表示正在执行的任务
  4. act_hi_identitylink表存放任务的办理人，包括个人任务和组任务，表示历史任务区别在于：
    如果是个人任务TYPE的类型表示participant（参与者）
    如果是组任务TYPE的类型表示candidate（候选者）和participant（参与者）
3.分配个人任务方式二（使用流程变量）

1：流程图中任务节点的配置

2：测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
  //部署流程定义，启动流程实例
  @Test
  public void testTask() throws Exception {
    // 1 发布流程
    InputStream inputStreamBpmn = this.getClass().getResourceAsStream("taskProcess.bpmn");
    InputStream inputStreamPng = this.getClass().getResourceAsStream("taskProcess.png");
    processEngine.getRepositoryService()//
            .createDeployment()//
            .addInputStream("userTask.bpmn", inputStreamBpmn)//
            .addInputStream("userTask.png", inputStreamPng)//
            .deploy();
    // 2 启动流程
    //启动流程实例，同时设置流程变量，用来指定组任务的办理人
    Map<String, Object> variables = new HashMap<String, Object>();
    variables.put("userIDs", "大大,小小,中中");
    ProcessInstance pi = processEngine.getRuntimeService()//
            .startProcessInstanceByKey("taskProcess",variables);
    System.out.println("pid:" + pi.getId());
  }
  //查询我的个人任务列表
  @Test
  public void findMyTaskList(){
    String userId = "大大";
    List<Task> list = processEngine.getTaskService()//
                    .createTaskQuery()//
                    .taskAssignee(userId)//指定个人任务查询
                    .list();
    for(Task task:list ){
      System.out.println("id="+task.getId());
      System.out.println("name="+task.getName());
      System.out.println("assinee="+task.getAssignee());
      System.out.println("assinee="+task.getCreateTime());
      System.out.println("executionId="+task.getExecutionId());
    }
  }
  //查询组任务列表
  @Test
  public void findGroupList(){
    String userId = "大大";
    List<Task> list = processEngine.getTaskService()//
                    .createTaskQuery()//
                    .taskCandidateUser(userId)//指定组任务查询
                    .list();
    for(Task task:list ){
      System.out.println("id="+task.getId());
      System.out.println("name="+task.getName());
      System.out.println("assinee="+task.getAssignee());
      System.out.println("assinee="+task.getCreateTime());
      System.out.println("executionId="+task.getExecutionId());
      System.out.println("##################################");
    }
  }
  //查询组任务成员列表
  @Test
  public void findGroupUser(){
    String taskId = "3709";
    List<IdentityLink> list = processEngine.getTaskService()//
                    .getIdentityLinksForTask(taskId);
    for(IdentityLink identityLink:list ){
      System.out.println("userId="+identityLink.getUserId());
      System.out.println("taskId="+identityLink.getTaskId());
      System.out.println("piId="+identityLink.getProcessInstanceId());
      System.out.println("######################");
    }
  }
  //查询组任务成员历史列表
  @Test
  public void findGroupHisUser(){
    String taskId = "3709";
    List<HistoricIdentityLink> list = processEngine.getHistoryService()//
            .getHistoricIdentityLinksForTask(taskId);
    for(HistoricIdentityLink identityLink:list ){
      System.out.println("userId="+identityLink.getUserId());
      System.out.println("taskId="+identityLink.getTaskId());
      System.out.println("piId="+identityLink.getProcessInstanceId());
      System.out.println("######################");
    }
  }
  //完成任务
  @Test
  public void completeTask(){
    String taskId = "3709";
    processEngine.getTaskService()//
          .complete(taskId);//
    System.out.println("完成任务");
  }
     /**将组任务分配给个人任务，拾取任务*/
  //由1个人去完成任务
  @Test
  public void claim(){
    //任务ID
    String taskId = "5908";
    //分配的办理人
    String userId = "小B";
    processEngine.getTaskService()//
          .claim(taskId, userId);
  }

分析：

  1. 大大，中中，小小是组任务的办理人
  2. 在开发中，可以在页面中指定下一个组任务的办理人，通过流程变量设置下一个任务的办理人
4.分配个人任务方式三（使用类）

1：流程图中任务节点的配置

此时流程图的XML文件，如图：

2：TaskListenerImpl类，用来设置任务的办理人

public class TaskListenerImpl implements TaskListener {
  /**指定个人任务和组任务的办理人*/
  @Override
  public void notify(DelegateTask delegateTask) {
    String userId1 = "孙悟空";
    String userId2 = "猪八戒";
    //指定组任务
    delegateTask.addCandidateUser(userId1);
    delegateTask.addCandidateUser(userId2);
  }
}

3：测试代码

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
  //部署流程定义，启动流程实例
  @Test
  public void testTask() throws Exception {
    // 1 发布流程
    InputStream inputStreamBpmn = this.getClass().getResourceAsStream("taskProcess.bpmn");
    InputStream inputStreamPng = this.getClass().getResourceAsStream("taskProcess.png");
    processEngine.getRepositoryService()//
            .createDeployment()//
            .addInputStream("userTask.bpmn", inputStreamBpmn)//
            .addInputStream("userTask.png", inputStreamPng)//
            .deploy();
    // 2 启动流程
    ProcessInstance pi = processEngine.getRuntimeService()//
              .startProcessInstanceByKey("taskProcess");
    System.out.println("pid:" + pi.getId());
  }
  //查询我的个人任务列表
  @Test
  public void findMyTaskList(){
    String userId = "孙悟空";
    List<Task> list = processEngine.getTaskService()//
                    .createTaskQuery()//
                    .taskAssignee(userId)//指定个人任务查询
                    .list();
    for(Task task:list ){
      System.out.println("id="+task.getId());
      System.out.println("name="+task.getName());
      System.out.println("assinee="+task.getAssignee());
      System.out.println("assinee="+task.getCreateTime());
      System.out.println("executionId="+task.getExecutionId());
    }
  }
  //查询组任务列表
  @Test
  public void findGroupList(){
    String userId = "孙悟空";
    List<Task> list = processEngine.getTaskService()//
                    .createTaskQuery()//
                    .taskCandidateUser(userId)//指定组任务查询
                    .list();
    for(Task task:list ){
      System.out.println("id="+task.getId());
      System.out.println("name="+task.getName());
      System.out.println("assinee="+task.getAssignee());
      System.out.println("assinee="+task.getCreateTime());
      System.out.println("executionId="+task.getExecutionId());
      System.out.println("##################################");
    }
  }
  //查询组任务成员列表
  @Test
  public void findGroupUser(){
    String taskId = "4008";
    List<IdentityLink> list = processEngine.getTaskService()//
                    .getIdentityLinksForTask(taskId);
    for(IdentityLink identityLink:list ){
      System.out.println("userId="+identityLink.getUserId());
      System.out.println("taskId="+identityLink.getTaskId());
      System.out.println("piId="+identityLink.getProcessInstanceId());
      System.out.println("######################");
    }
  }
  //查询组任务成员历史列表
  @Test
  public void findGroupHisUser(){
    String taskId = "4008";
    List<HistoricIdentityLink> list = processEngine.getHistoryService()//
            .getHistoricIdentityLinksForTask(taskId);
    for(HistoricIdentityLink identityLink:list ){
      System.out.println("userId="+identityLink.getUserId());
      System.out.println("taskId="+identityLink.getTaskId());
      System.out.println("piId="+identityLink.getProcessInstanceId());
      System.out.println("######################");
    }
  }
  //完成任务
  @Test
  public void completeTask(){
    String taskId = "4008";
    processEngine.getTaskService()//
          .complete(taskId);//
    System.out.println("完成任务");
  }
  //将组任务分配给个人任务（认领任务）
  @Test
  public void claimTask(){
    String taskId = "4008";
    //个人任务的办理人
    String userId = "如来";
    processEngine.getTaskService().claim(taskId, userId);
  }
  //可以分配个人任务回退到组任务，（前提之前是个组任务）
  @Test
  public void setAssigneeTask(){
    //任务ID
    String taskId = "4008";
    processEngine.getTaskService()//
          .setAssignee(taskId, null);
  }
  //向组任务中添加成员
  @Test
  public void addUser(){
    String taskId = "4008";
    String userId = "沙和尚";
    processEngine.getTaskService().addCandidateUser(taskId, userId);
  }
  //向组任务中删除成员
  @Test
  public void removeUser(){
    String taskId = "4008";
    String userId = "沙和尚";
    processEngine.getTaskService().deleteCandidateUser(taskId, userId);
  }

分析:

  1. 在类中使用delegateTask.addCandidateUser (userId);的方式分配组任务的办理人，此时孙悟空和猪八戒是下一个任务的办理人。
  2. 通过processEngine.getTaskService().claim (taskId, userId);将组任务分配给个人任务，也叫认领任务，即指定某个人去办理这个任务，此时由如来去办理任务。
    注意：认领任务的时候，可以是组任务成员中的人，也可以不是组任务成员的人，此时通过Type的类型为participant来指定任务的办理人
  3. addCandidateUser()即向组任务添加成员，deleteCandidateUser()即删除组任务的成员。
  4. 在开发中，可以将每一个任务的办理人规定好，例如张三的领导是李四和王五，这样张三提交任务，由李四或者王五去查询组任务，可以看到对应张三的申请，李四或王五再通过认领任务（claim）的方式，由某个人去完成这个任务。
5.总结

组任务及三种分配方式：

  1. 在taskProcess.bpmn中直接写 candidate-users=“小A,小B,小C,小D"
  2. 在taskProcess.bpmn中写 candidate-users =“#{userIDs}”，变量的值要是String的。
    使用流程变量指定办理人
Map<String, Object> variables = new HashMap<String, Object>();
              variables.put("userIDs", "大大,小小,中中");
  1. 使用TaskListener接口，使用类实现该接口，在类中定义：
//添加组任务的用户
delegateTask.addCandidateUser(userId1);
delegateTask.addCandidateUser(userId2);
组任务分配给个人任务（认领任务）：
 processEngine.getTaskService().claim(taskId, userId);
个人任务分配给组任务：
processEngine.getTaskService(). setAssignee(taskId, null);
向组任务添加人员：  processEngine.getTaskService().addCandidateUser(taskId, userId);
向组任务删除人员：   processEngine.getTaskService().deleteCandidateUser(taskId, userId);

个人任务和组任务存放办理人对应的表：

act_ru_identitylink表存放任务的办理人，包括个人任务和组任务，表示正在执行的任务

act_hi_identitylink表存放任务的办理人，包括个人任务和组任务，表示历史任务

区别在于：

  • 如果是个人任务TYPE的类型表示participant（参与者）
  • 如果是组任务TYPE的类型表示candidate（候选者）和participant（参与者）

注意：

组任务在项目中最好的处理方式是先拾取（claim()）任务，即指定某个人去办理任务。这样就可以在正在执行（历史的）任务表中可以跟着当前任务的办理人，否则该字段(ASSIGNEE)为null，就无法跟踪当前办理人。

  • 第一种方式是固定的组任务的执行人
  • 第二种方式是在代码中通过流程变量的形式给组任务的执行人赋值，这样做的缺点是在进入该节点之前，必须给组任务赋值候选人
  • 第三种方式可以在进入该组任务的时候，执行TaskListener，从而给组任务的候选人赋值。
    缺点1: 如果在TaskListener中操作了数据库，这意味着只要进入该节点就得操作数据库一次。
    缺点2: 这个类不能放入到spring容器中，所以该类中的方法不能使用spring的声明式事务处理
    优点: 可以在方法中引入servletConetxt或者ApplicationContext
文章标签：
Java
Spring
数据格式
数据库
XML
阿甘兄
目录
相关文章
请回答1024
|
4月前
|
XML API 数据格式
工作流JBPM操作API组任务
工作流JBPM操作API组任务
请回答1024
37 1
程序员石磊
activiti 会签多实例任务，设置为候选组或个人任务的总结
activiti 会签多实例任务，设置为候选组或个人任务的总结
程序员石磊
933 0
activiti 会签多实例任务，设置为候选组或个人任务的总结
阿甘兄
|
11月前
37activiti - 用户任务（工作流定义的角色组）
37activiti - 用户任务（工作流定义的角色组）
阿甘兄
105 0
游客kbuanlzoibg3i
|
数据库
Activiti进阶篇-组任务
Activiti进阶篇-组任务
游客kbuanlzoibg3i
276 0
Activiti进阶篇-组任务
游客kbuanlzoibg3i
|
XML 数据可视化 Java
Activiti-ProcessEngine创建方式和Servcie介绍
Activiti-ProcessEngine创建方式和Servcie介绍
游客kbuanlzoibg3i
205 0
Activiti-ProcessEngine创建方式和Servcie介绍
游客kbuanlzoibg3i
|
XML 存储 SQL
Activiti-介绍和使用步骤
Activiti-介绍和使用步骤
游客kbuanlzoibg3i
196 0
Activiti-介绍和使用步骤
游客kbuanlzoibg3i
|
存储 Java API
Activiti-如何创建Activiti项目和数据表介绍
Activiti-如何创建Activiti项目和数据表介绍
游客kbuanlzoibg3i
184 0
Activiti-如何创建Activiti项目和数据表介绍
herozhi0821
|
XML Java 数据库连接
SpringBoot 2.1整合Activiti 6启动后不自动创建表
处理工作流引擎无法自动建表原因
herozhi0821
1176 0
游客aw5q726q25qny
|
XML Java 程序员
关于配置Activiti7出现的一些问题
嘎嘎权威
游客aw5q726q25qny
482 0
关于配置Activiti7出现的一些问题
科技小能手
|
缓存 监控 Java
activiti相关配置
科技小能手
1436 0