Activiti7 任务办理人、委派、转办、持有人、候选人、候选人组、审批意见【十三】

比眉伴天荒 2024-03-22 22:06 99阅读 0赞

### Activiti 7系列文章目录 ###

[文章代码下载][Link 1]

[Activiti7 工作流设计器【一】][Activiti7]  
[Activiti7 创建表【二】][Activiti7 1]  
[Activiti7 表结构介绍 【三】][Activiti7 _]  
[Activiti7 设计器创建流程 【四】][Activiti7 _ 1]  
[Activiti7 部署流程【五】][Activiti7 2]  
[Activiti7 查询流程【六】][Activiti7 3]  
[Activiti7 删除流程【七】][Activiti7 4]  
[Activiti7 生成SVG图片【八】][Activiti7 _SVG]  
[Activiti7 发起任务【九】][Activiti7 5]  
[Activiti7 查询任务执行流程图【十】][Activiti7 6]  
[Activiti7 完成任务【十一】][Activiti7 7]  
[Activiti7 历史数据【十二】][Activiti7 8]  
[Activiti7 任务办理人、委派、转办、持有人、候选人、候选人组、审批意见【十三】][Activiti7 9]  
[Activiti7 监听器【十四】][Activiti7 10]  
[Activiti7 流程变量【十五】][Activiti7 11]  
[Activiti7 网关Gateway【十六】][Activiti7 _Gateway]  
[Activiti7 整合SpringBoot【十七】][Activiti7 _SpringBoot]  
[Activiti7 多种任务类型【十八】][Activiti7 12]  
[Activiti7 子流程【十九】][Activiti7 13]  
[Activiti7 流程回退、流程拒绝【二十】][Activiti7 14]

#### **设置任务办理人** ####

![image.png][]

#### 说明 ####

Assignee指定办理人模式：即设置办理人，就是设置Assignee。Assignee 受让人; 受托人，代理人; 被指定人;办理人只能指定一个人，不能使用逗号分隔。默认执行签收操作taskService.claim(taskId, currentUserId);在ACT\_HI\_TASKINST和ACT\_RU\_TASK会产生数据，这两个表里面的Assignee\_字段就是设置的办理人姓名或者对象的ID

#### 涉及API ####

//根据用户来查询任务（待办任务）
    taskService.createTaskQuery().taskAssignee(param);
    
    //设置办理人
    TaskService().setAssignee(taskId,userId);

#### 任务委派 ####

**任务委派只是任务人将当前的任务交给接收人进行审批，完成任务后又重新回到任务人身上。委派人查询任务与完成任务与正常的有区别。**

/**
     * 指定代办人
     */
    @Test
    public void delegateTask() {
        
        List<Task> list = taskService.createTaskQuery().list();
        String taskId = list.get(0).getId();
        String loginName = "李四";
        taskService.delegateTask(taskId, loginName);
    }

插入数据表

==>  Preparing: insert into ACT_HI_IDENTITYLINK (ID_, TYPE_, USER_ID_, GROUP_ID_, TASK_ID_, PROC_INST_ID_) values (?, ?, ?, ?, ?, ?)
    ==> Parameters: 2501(String), participant(String), 李四(String), null, null, 4(String)
    <==    Updates: 1
    ==>  Preparing: insert into ACT_RU_IDENTITYLINK (ID_, REV_, TYPE_, USER_ID_, GROUP_ID_, TASK_ID_, PROC_INST_ID_, PROC_DEF_ID_) values (?, 1, ?, ?, ?, ?, ?, ?)
    ==> Parameters: 2501(String), participant(String), 李四(String), null, null, 4(String), null
    <==    Updates: 1

修改的数据表

==>  Preparing: update ACT_RU_TASK SET REV_ = ?, NAME_ = ?, PARENT_TASK_ID_ = ?, PRIORITY_ = ?, CREATE_TIME_ = ?, OWNER_ = ?, ASSIGNEE_ = ?, DELEGATION_ = ?, EXECUTION_ID_ = ?, PROC_DEF_ID_ = ?, DESCRIPTION_ = ?, DUE_DATE_ = ?, CATEGORY_ = ?, SUSPENSION_STATE_ = ?, FORM_KEY_ = ?, CLAIM_TIME_ = ? where ID_= ? and REV_ = ?
    ==> Parameters: 2(Integer), 经理审批(String), null, 50(Integer), 2023-07-28 11:00:14.096(Timestamp), null, 李四(String), PENDING(String), 5(String), test03:1:3(String), null, null, null, 1(Integer), null, null, 8(String), 1(Integer)
    <==    Updates: 1
    ==>  Preparing: update ACT_HI_TASKINST set PROC_DEF_ID_ = ?, EXECUTION_ID_ = ?, NAME_ = ?, PARENT_TASK_ID_ = ?, DESCRIPTION_ = ?, OWNER_ = ?, ASSIGNEE_ = ?, CLAIM_TIME_ = ?, END_TIME_ = ?, DURATION_ = ?, DELETE_REASON_ = ?, TASK_DEF_KEY_ = ?, FORM_KEY_ = ?, PRIORITY_ = ?, DUE_DATE_ = ?, CATEGORY_ = ? where ID_ = ?
    ==> Parameters: test03:1:3(String), 5(String), 经理审批(String), null, null, null, 李四(String), null, null, null, null, sid-BD4D49BD-E99D-4D9A-9688-7778F37E3180(String), null, 50(Integer), null, null, 8(String)
    <==    Updates: 1
    ==>  Preparing: update ACT_HI_ACTINST set EXECUTION_ID_ = ?, ASSIGNEE_ = ?, END_TIME_ = ?, DURATION_ = ?, DELETE_REASON_ = ? where ID_ = ?
    ==> Parameters: 5(String), 李四(String), null, null, null, 7(String)

这里关键是将ACT\_RU\_TASK的ASSIGNEE\_设置为新待办人

#### 被委派人处理任务 ####

/**
     * 正在运行的任务表中被委派人办理任务后任务会回到委派人 ，历史任务表中也一样,只是多了一个人进行审批
     */
    @Test
    public void resolveTask() {
        
        List<Task> list = taskService.createTaskQuery().list();
        String taskId = list.get(0).getId();
    
        taskService.resolveTask(taskId);
    }

执行的SQL语句

==>  Preparing: update ACT_RU_TASK SET REV_ = ?, NAME_ = ?, PARENT_TASK_ID_ = ?, PRIORITY_ = ?, CREATE_TIME_ = ?, OWNER_ = ?, ASSIGNEE_ = ?, DELEGATION_ = ?, EXECUTION_ID_ = ?, PROC_DEF_ID_ = ?, DESCRIPTION_ = ?, DUE_DATE_ = ?, CATEGORY_ = ?, SUSPENSION_STATE_ = ?, FORM_KEY_ = ?, CLAIM_TIME_ = ? where ID_= ? and REV_ = ?
    ==> Parameters: 3(Integer), 经理审批(String), null, 50(Integer), 2023-07-28 11:00:14.096(Timestamp), null, null, RESOLVED(String), 5(String), test03:1:3(String), null, null, null, 1(Integer), null, null, 8(String), 2(Integer)
    <==    Updates: 1
    ==>  Preparing: update ACT_HI_ACTINST set EXECUTION_ID_ = ?, ASSIGNEE_ = ?, END_TIME_ = ?, DURATION_ = ?, DELETE_REASON_ = ? where ID_ = ?
    ==> Parameters: 5(String), null, null, null, null, 7(String)
    <==    Updates: 1
    ==>  Preparing: update ACT_HI_TASKINST set PROC_DEF_ID_ = ?, EXECUTION_ID_ = ?, NAME_ = ?, PARENT_TASK_ID_ = ?, DESCRIPTION_ = ?, OWNER_ = ?, ASSIGNEE_ = ?, CLAIM_TIME_ = ?, END_TIME_ = ?, DURATION_ = ?, DELETE_REASON_ = ?, TASK_DEF_KEY_ = ?, FORM_KEY_ = ?, PRIORITY_ = ?, DUE_DATE_ = ?, CATEGORY_ = ? where ID_ = ?
    ==> Parameters: test03:1:3(String), 5(String), 经理审批(String), null, null, null, null, null, null, null, null, sid-BD4D49BD-E99D-4D9A-9688-7778F37E3180(String), null, 50(Integer), null, null, 8(String)
    <==    Updates: 1

![image.png][image.png 1]

/**
     * 任务转办,将任务交给其他人处理
     */
    @Test
    public void turnTask() {
        
        String taskId =  "7511";
        String assignee = "李四";
        trunTask(taskId,assignee);
    }
    
    public boolean trunTask(String taskId, String assignee) {
        
        taskService.setAssignee(taskId, assignee);
        return true;
    }

#### 任务持有人 ####

**持有人**：指当前任务的执行人，他此时持有该任务。  
设置任务持有人

@Test
        public void setOwner(){
        
            List<Task> list = taskService.createTaskQuery().list();
            String taskId = list.get(0).getId();
            String loginName = "王五";
            taskService.setOwner(taskId, loginName);
        }

执行的SQL

==>  Preparing: insert into ACT_HI_IDENTITYLINK (ID_, TYPE_, USER_ID_, GROUP_ID_, TASK_ID_, PROC_INST_ID_) values (?, ?, ?, ?, ?, ?)
    ==> Parameters: 5001(String), participant(String), 王五(String), null, null, 4(String)
    <==    Updates: 1
    ==>  Preparing: insert into ACT_RU_IDENTITYLINK (ID_, REV_, TYPE_, USER_ID_, GROUP_ID_, TASK_ID_, PROC_INST_ID_, PROC_DEF_ID_) values (?, 1, ?, ?, ?, ?, ?, ?)
    ==> Parameters: 5001(String), participant(String), 王五(String), null, null, 4(String), null
    <==    Updates: 1
    ==>  Preparing: insert into ACT_HI_COMMENT (ID_, TYPE_, TIME_, USER_ID_, TASK_ID_, PROC_INST_ID_, ACTION_, MESSAGE_, FULL_MSG_) values (?, ?, ?, ?, ?, ?, ?, ?, ?)
    ==> Parameters: 5002(String), event(String), 2023-07-28 11:27:01.561(Timestamp), null, 8(String), null, AddUserLink(String), 王五_|_owner(String), null
    <==    Updates: 1

更新ACT\_RU\_TASK是关键

==>  Preparing: update ACT_HI_TASKINST set PROC_DEF_ID_ = ?, EXECUTION_ID_ = ?, NAME_ = ?, PARENT_TASK_ID_ = ?, DESCRIPTION_ = ?, OWNER_ = ?, ASSIGNEE_ = ?, CLAIM_TIME_ = ?, END_TIME_ = ?, DURATION_ = ?, DELETE_REASON_ = ?, TASK_DEF_KEY_ = ?, FORM_KEY_ = ?, PRIORITY_ = ?, DUE_DATE_ = ?, CATEGORY_ = ? where ID_ = ?
    ==> Parameters: test03:1:3(String), 5(String), 经理审批(String), null, null, 王五(String), null, null, null, null, null, sid-BD4D49BD-E99D-4D9A-9688-7778F37E3180(String), null, 50(Integer), null, null, 8(String)
    <==    Updates: 1
    ==>  Preparing: update ACT_RU_TASK SET REV_ = ?, NAME_ = ?, PARENT_TASK_ID_ = ?, PRIORITY_ = ?, CREATE_TIME_ = ?, OWNER_ = ?, ASSIGNEE_ = ?, DELEGATION_ = ?, EXECUTION_ID_ = ?, PROC_DEF_ID_ = ?, DESCRIPTION_ = ?, DUE_DATE_ = ?, CATEGORY_ = ?, SUSPENSION_STATE_ = ?, FORM_KEY_ = ?, CLAIM_TIME_ = ? where ID_= ? and REV_ = ?
    ==> Parameters: 4(Integer), 经理审批(String), null, 50(Integer), 2023-07-28 11:00:14.096(Timestamp), 王五(String), null, RESOLVED(String), 5(String), test03:1:3(String), null, null, null, 1(Integer), null, null, 8(String), 3(Integer)
    <==    Updates: 1

![image.png][image.png 2]

#### 根据持有人查询任务 ####

//反向查询任务：根据持有人查询任务
    @Test
    public void queryByOwner(){
        
        List<Task> list = taskService.createTaskQuery().taskOwner("王五").list();
        for (Task task : list) {
        
            System.out.println("task.getId() = " + task.getId());
            System.out.println("task.getName() = " + task.getName());
            System.out.println("task.getOwner() = " + task.getOwner());
        }
    }

执行的SQL

==>  Preparing: select distinct RES.* from ACT_RU_TASK RES WHERE RES.OWNER_ = ? order by RES.ID_ asc LIMIT ? OFFSET ?
    ==> Parameters: 王五(String), 2147483647(Integer), 0(Integer)
    <==      Total: 1

打印结果

task.getId() = 8
    task.getName() = 经理审批
    task.getOwner() = 王五

#### 候选人CandidateUsers ####

当任务可以被多人处理的时候，可能会发生并发，所以添加候选人，让候选人去获取任务，之后就变成这个候选人的任务了。  
![image.png][image.png 3]

//根据候选人查询任务
    @Test
    public void testQueryTaskByCandidateUser(){
        
        //返回所有的任务
        List<Task> tasks = taskService.createTaskQuery().taskCandidateUser("lisi").list();
        for (Task task : tasks) {
        
            System.out.println("task.getId() = " + task.getId());
            System.out.println("task.getName() = " + task.getName());
        }
    }

这里需要注意：如果是和springboot整合，那么会走到SpringSecurity登录拦截，要么排除SpringSecurity，要么模拟一个登录  
我这里提供模拟账号密码：相当于SpringSecurity登录查询用户，但是我这里给写死了。让他先通过再说。。。。

package com.boot.service;
    
    import org.springframework.security.core.userdetails.User;
    import org.springframework.security.core.userdetails.UserDetails;
    import org.springframework.security.core.userdetails.UserDetailsService;
    import org.springframework.security.core.userdetails.UsernameNotFoundException;
    import org.springframework.security.provisioning.InMemoryUserDetailsManager;
    import org.springframework.stereotype.Service;
    
    @Service
    public class UserService implements UserDetailsService {
        
        @Override
        public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        
    
            InMemoryUserDetailsManager userDetailsService = new InMemoryUserDetailsManager();
            //User类用于创建代表用户的对象的构造器实现，该类由SpringSecurity提供，并非我们自己创建
            UserDetails user = User.withUsername(username)
                    .password("123456")
                    .authorities("admin")
                    .build();
            userDetailsService.createUser(user);
            return user;
        }
    }

当发起人zs完成自己的审批后到底下一个任务节点经理审批时，此时的ASSIGNEE\_字段是空的。

//拾取任务
    @Test
    public void testClaimTask(){
        
        //返回所有的任务
        List<Task> tasks = taskService.createTaskQuery().taskCandidateUser("lisi").list();
        for (Task task : tasks) {
        
            System.out.println("task.getId() = " + task.getId());
            System.out.println("task.getName() = " + task.getName());
            taskService.claim(task.getId(), "lisi");//拾取任务
        }
    }

#### ![image.png][image.png 4] ####

**候选人组**：代表有权限对任务进行操作的人。  
![a15c37e7d81b2d9b34febf5003f2b4f7.png_averageHue_f4f7f9_from_url_height_529_id_Jfgxd_originHeight_529_originWidth_600_originalType_binary_ratio_1_rotation_0_showTitle_false_status_done_style_none_title_width_600][]

@Test
    public void taskCandidateGroup(){
        
        List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup("admin").list();
        for (Task task : tasks) {
        
            System.out.println("task.getId() = " + task.getId());
            System.out.println("task.getName() = " + task.getName());
        }
    }

==>  Preparing: select distinct RES.* from ACT_RU_TASK RES inner join ACT_RU_IDENTITYLINK I on I.TASK_ID_ = RES.ID_ WHERE RES.ASSIGNEE_ is null and I.TYPE_ = 'candidate' and ( I.GROUP_ID_ IN ( ? ) ) order by RES.ID_ asc LIMIT ? OFFSET ?
    ==> Parameters: admin(String), 2147483647(Integer), 0(Integer)
    <==      Total: 1

task.getId() = 7508
    task.getName() = 经理审批

#### 添加审批意见 ####

我们可以通过TaskService的addComment方法来给任务审批意见

Task task = taskService
            .createTaskQuery()
            .singleResult();
    //任务ID、流程实例ID、审批意见
    taskService.addComment(task.getId(),"232504","同意审批");

#### 审批意见存放的表 ####

上述执行后会插入如下的表中

insert into ACT_HI_COMMENT

#### 查询任务审批意见 ####

//select * from ACT_HI_COMMENT where TASK_ID_ = ? and TYPE_ = 'comment' order by TIME_ desc
    List<Comment> taskComments = taskService.getTaskComments(task.getId());
    for (Comment taskComment : taskComments) {
        
        System.out.println("taskComment.getFullMessage() = " + taskComment.getFullMessage());
    }

[Link 1]: https://item.taobao.com/item.htm?ft=t&id=731521858952
[Activiti7]: https://blog.csdn.net/imjcoder/article/details/131960788
[Activiti7 1]: https://blog.csdn.net/imjcoder/article/details/131961178
[Activiti7 _]: https://blog.csdn.net/imjcoder/article/details/131961740
[Activiti7 _ 1]: https://blog.csdn.net/imjcoder/article/details/131961870
[Activiti7 2]: https://blog.csdn.net/imjcoder/article/details/131962201
[Activiti7 3]: https://blog.csdn.net/imjcoder/article/details/131962676
[Activiti7 4]: https://blog.csdn.net/imjcoder/article/details/131962897
[Activiti7 _SVG]: https://blog.csdn.net/imjcoder/article/details/131963020
[Activiti7 5]: https://blog.csdn.net/imjcoder/article/details/131963117
[Activiti7 6]: https://blog.csdn.net/imjcoder/article/details/131963429
[Activiti7 7]: https://blog.csdn.net/imjcoder/article/details/131973436
[Activiti7 8]: https://blog.csdn.net/imjcoder/article/details/131974783
[Activiti7 9]: https://blog.csdn.net/imjcoder/article/details/131980252
[Activiti7 10]: https://blog.csdn.net/imjcoder/article/details/131980411
[Activiti7 11]: https://blog.csdn.net/imjcoder/article/details/131980452
[Activiti7 _Gateway]: https://blog.csdn.net/imjcoder/article/details/131980479
[Activiti7 _SpringBoot]: https://blog.csdn.net/imjcoder/article/details/131980531
[Activiti7 12]: https://blog.csdn.net/imjcoder/article/details/131980636
[Activiti7 13]: https://blog.csdn.net/imjcoder/article/details/131980676
[Activiti7 14]: https://blog.csdn.net/imjcoder/article/details/131980731
[image.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/6af6add1ccd04a7ab627d5509808feb4.png
[image.png 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/d4c4a0dd5ba74a8a82ac1269a33d113d.png
[image.png 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/c2919f26f284418c91c577977a5a73fd.png
[image.png 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/a656c274becf495089e67e4f94ddb130.png
[image.png 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/296020522c704309baad03feb0aa3124.png
[a15c37e7d81b2d9b34febf5003f2b4f7.png_averageHue_f4f7f9_from_url_height_529_id_Jfgxd_originHeight_529_originWidth_600_originalType_binary_ratio_1_rotation_0_showTitle_false_status_done_style_none_title_width_600]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/4a1c337dc57842c3886d6d2d93ccfc4a.png