4、高级-BusinessKey,流程挂起和激活,任务提交添加备注

1、BusinessKey

启动流程时，传入BusinessKey，与业务关联。最大255长度大小。字符串存储，可以存储JSON字符串，注意长度问题。一般是存储审批主表ID，比如请假表单ID。

/**
     * 启动流程时，添加BusinessKey和业务进行关联。
     * BusinessKey就是Activiti 中的一个扩展字段信息
     */
    @Test
    public  void addBusinessKey(){
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RuntimeService runtimeService = processEngine.getRuntimeService();

        //启动流程时，写入Business Key，后续流程都可以从这个流程实例中获取
        //Business Key 一般都是业务的主键：订单ID、审核报告ID等等
        //Business Key 在数据库里面存储的最大长度是255，超过时，会报异常。有时会存储小JSON数据
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("myLeave", "my business Key");
        //启动流程时，也可以传递一个Map 变量信息。流程中可以通过变量判断条件是否成立。
//        runtimeService.startProcessInstanceByKey("myLeave",Map);
        log.info(processInstance.getBusinessKey());

        log.info(processInstance.getProcessDefinitionId());
        log.info(processInstance.getDeploymentId());
        log.info(processInstance.getId());
        log.info(processInstance.getActivityId());
    }

2、流程定义-挂起和激活

有时由于业务需要，需要把一些流程进行挂起，比如工作日某些任务不知执行；流程定义需要调整，没执行完的流程需要挂起。
注意：流程定义挂起后，所有流程实例都不能继续执行
挂起的流程不能够继续向下执行，报异常Cannot complete a suspended task。

2.1、流程定义-挂起或激活

/**
     * 挂起或激活流程
     */
    @Test
    public void suspendProcessDefinition(){
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RepositoryService repositoryService = processEngine.getRepositoryService();

        //获取流程定义
        ProcessDefinition myLeave = repositoryService.createProcessDefinitionQuery()
                .processDefinitionKey("myLeave")
                .singleResult();
        boolean suspended = myLeave.isSuspended();
        String definitionId = myLeave.getId();

        if(suspended){
            //如果挂起，则可以激活：流程定义ID，是否激活，激活时间
            repositoryService.activateProcessDefinitionById(definitionId,true,null);
            log.info("流程 {} 已激活",definitionId);
        }else{
            repositoryService.suspendProcessDefinitionById(definitionId,true,null);
            log.info("流程 {} 已挂起",definitionId);
        }
    }

2.2、挂起的流程继续下一节点人执行任务时，报异常

Cannot complete a suspended task

@Test
    public void completeTask(){
        String assignee="jake";
        String processKey="myLeave";
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = processEngine.getTaskService();

        //完成当前节点任务
        Task task = taskService.createTaskQuery()
                .processDefinitionKey(processKey)
                .taskAssignee(assignee)
                .list().get(0);
        //完成任务.流程挂起时，报异常：Cannot complete a suspended task
        taskService.complete(task.getId());
    }

2.3、某个流程实例-挂起和激活

有时只需要挂起某个流程实例，其他流程实例可以继续执行时，此时需要挂起流程实例。

/**
     * 挂起流程实例 激活
     */
    @Test
    public void suspendProcessInstance(){
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RuntimeService runtimeService = processEngine.getRuntimeService();

        //查询具体流程实例
        ProcessInstance processInstance = runtimeService.createProcessInstanceQuery()
                .processInstanceId("20001")
                .singleResult();
        String instanceId = processInstance.getId();
        boolean suspended = processInstance.isSuspended();
        if(suspended){
            runtimeService.activateProcessInstanceById(instanceId);
            log.info("流程实例ID：{},已经激活",instanceId);
        }else{
            runtimeService.suspendProcessInstanceById(instanceId);
            log.info("流程实例ID：{},已经挂起",instanceId);
        }
    }

3、任务提交时，可添加备注信息、附件等信息

Task 任务信息不可挂起或激活。任务提交时可上传附件、备注等信息。

/**
     * 任务负责人提交任务时，可添加备注信息、附件信息
     */
    @Test
    public void completeTask(){
        String assignee="manager";
        String processKey="myLeave";
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = processEngine.getTaskService();

        //完成当前节点任务
        Task task = taskService.createTaskQuery()
                .processDefinitionKey(processKey)
                .taskAssignee(assignee)
                .list().get(0);

        //执行任务时，可以添加一下备注、claim,附件等信息
//        taskService.addComment("","","");
//        taskService.claim("","");
//        taskService.createAttachment("","");


        //完成任务.流程挂起时，报异常： Cannot complete a suspended task
        taskService.complete(task.getId());
    }