activiti学习之多个候选人

我不是女神ヾ 2022-09-15 11:51 360阅读 0赞

## 写在前面 ##

这种方式是在设计流程时指定候选人，在xml中的任务节点对应的属性是`activiti:candidateUsers`(不同于办理人，办理人是activiti:assignee),如`activiti:candidateUsers="admin1,admin2,admin3"`，  
下面我们来看下这种方式如何获取指定的候选人并指定一个作为任务的办理人。

## 1：测试 ##

### 1.1：设计流程 ###

*  效果

![在这里插入图片描述][d805895976fc4894a924b0c079917124.png]

*  xml

<?xml version="1.0" encoding="UTF-8"?>
    <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/test">
        <process id="csdnCandidateUserAssign" name="候选人任务分配" isExecutable="true">
            <startEvent id="startevent1" name="Start"></startEvent>
            <endEvent id="endevent1" name="End"></endEvent>
            <userTask id="usertask1" name="指定候选人" activiti:candidateUsers="admin1,admin2,admin3">
                <extensionElements>
                    <modeler:initiator-can-complete xmlns:modeler="http://activiti.com/modeler">false</modeler:initiator-can-complete>
                </extensionElements>
            </userTask>
            <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1"></sequenceFlow>
            <sequenceFlow id="flow2" sourceRef="usertask1" targetRef="endevent1"></sequenceFlow>
        </process>
        <bpmndi:BPMNDiagram id="BPMNDiagram_csdnCandidateUserAssign">
            <bpmndi:BPMNPlane bpmnElement="csdnCandidateUserAssign" id="BPMNPlane_csdnCandidateUserAssign">
                <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
                    <omgdc:Bounds height="35.0" width="35.0" x="370.0" y="90.0"></omgdc:Bounds>
                </bpmndi:BPMNShape>
                <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
                    <omgdc:Bounds height="35.0" width="35.0" x="370.0" y="320.0"></omgdc:Bounds>
                </bpmndi:BPMNShape>
                <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
                    <omgdc:Bounds height="55.0" width="105.0" x="335.0" y="200.0"></omgdc:Bounds>
                </bpmndi:BPMNShape>
                <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
                    <omgdi:waypoint x="387.0" y="125.0"></omgdi:waypoint>
                    <omgdi:waypoint x="387.0" y="200.0"></omgdi:waypoint>
                </bpmndi:BPMNEdge>
                <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
                    <omgdi:waypoint x="387.0" y="255.0"></omgdi:waypoint>
                    <omgdi:waypoint x="387.0" y="320.0"></omgdi:waypoint>
                </bpmndi:BPMNEdge>
            </bpmndi:BPMNPlane>
        </bpmndi:BPMNDiagram>
    </definitions>

### 1.2：部署 ###

/** * 部署流程定义 */
    @Test
    public void deploy() { 
    /* Deployment deployment = repositoryService.createDeployment() // 创建部署 .addClasspathResource("com/jh/activiti/candidaaUser.bpmn20.xml") // 加载流程资源文件 .name("多个候选人流程") // 流程名称 .deploy(); // 部署 System.out.println("流程部署ID:" + deployment.getId()); System.out.println("流程部署Name:" + deployment.getName()); */
        Deployment deployment = repositoryService.createDeployment() // 创建部署
                .addClasspathResource("com/jh/activiti/csdnCandidataUser.bpmn20.xml") // 加载流程资源文件
                .name("csdn多个候选人流程") // 流程名称
                .deploy(); // 部署
        System.out.println("流程部署ID:" + deployment.getId());
        System.out.println("流程部署Name:" + deployment.getName());
    }

![在这里插入图片描述][2906ade7160f4d1686874097d9170500.png]

![在这里插入图片描述][2fe9ef98e47e41989a3bdfdd8d24b09e.png]

### 1.3：启动流程实例 ###

/** * 启动流程实例 */
    // 启动流程实例后，因为第一个任务节点“指定候选人”指定了候选人"admin1,admin2,admin3"，这些候选人信息会存在在act_ru_identitylink中
    // 在流程运转的过程中动态的选择任务的执行人（在上一个节点，包括开始节点，来从这些候选人中选择一个）
    @Test
    public void start() { 
        ProcessInstance pi = runtimeService.startProcessInstanceByKey("csdnCandidateUserAssign"); // 流程定义表的KEY字段值
        System.out.println("流程实例ID:" + pi.getId());
        System.out.println("流程定义ID:" + pi.getProcessDefinitionId());
    }

*  候选人

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16]

*  生成的任务assignee并没有值

![在这里插入图片描述][c323414f84204cd78b81d20a5893dc08.png]

### 1.4：获取任务候选人并声明一个作为处理人 ###

*  程序

@Test
    public void queryTaskByProcessInstanceId() { 
        // 启动实例后，直接查询“指定候选人”节点的任务信息（此时还没有指定任务的参与者，因此是null）
        List<Task> taskList = taskService.createTaskQuery() // 创建任务查询
                .processInstanceId("800002") // 流程实例ID
                .list();
        /** * 任务ID:127504 * 任务名称:指定候选人 * 任务创建时间:Mon Sep 13 12:31:44 CST 2021 * 任务委派人:null * 流程实例ID:127501 */
        for (Task task : taskList) { 
            System.out.println("任务ID:" + task.getId());
            System.out.println("任务名称:" + task.getName());
            System.out.println("任务创建时间:" + task.getCreateTime());
            System.out.println("任务委派人:" + task.getAssignee());
            System.out.println("流程实例ID:" + task.getProcessInstanceId());
            // 获取任务的候选人列表
            List<IdentityLink> identityLinksForTask = taskService.getIdentityLinksForTask(task.getId());
            identityLinksForTask.stream().forEach((identityLink) -> { 
                System.out.println(identityLink.getUserId());
            });
            // 这里作为测试直接选择第一个作为任务处理人
            String chooseCandidateUserId = identityLinksForTask.get(0).getUserId();
            System.out.println("选择的候选人是：" + chooseCandidateUserId);
            // claim：该方法只有在没有办理人时才会成功，否则抛出办理人已经设置的相关异常，这和setAssignee方法是不同的，setAssignee方法会直接覆盖当前办理人
            taskService.claim(task.getId(), chooseCandidateUserId);
        }
    }

任务ID:800007
    任务名称:指定候选人
    任务创建时间:Mon Oct 11 11:49:23 CST 2021
    任务委派人:null
    流程实例ID:800002
    admin1
    admin2
    admin3
    选择的候选人是：admin1

执行后查看任务的办理人：

![在这里插入图片描述][055972cc82d74fe1bb27c488375e1eb0.png]

[d805895976fc4894a924b0c079917124.png]: /images/20220828/a39ce951a78142f69ed4710e9ea54161.png
[2906ade7160f4d1686874097d9170500.png]: /images/20220828/08d4df57ead943bda0b1913fc133651a.png
[2fe9ef98e47e41989a3bdfdd8d24b09e.png]: /images/20220828/ba17ad20ac7e493fb7ff7041995183a7.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAd2FuZzA5MDc_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/2e3e8601d5a44b7c8888cf143c2eeb1f.png
[c323414f84204cd78b81d20a5893dc08.png]: /images/20220828/b8ac89532a1f40a280c9c739ed75b01d.png
[055972cc82d74fe1bb27c488375e1eb0.png]: /images/20220828/dbb64083e9bf405bbd863721f9a91b6e.png