五、flowable操作、查询相关

1、依赖、配置

<!-- 工作流flowable架包 -->
        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-spring-boot-starter</artifactId>
            <version>6.4.0</version>
        </dependency>

flowable:
  # 自动生成表
  database-schema-update: true

 

// 数据库连接后面加上这个参数
&nullCatalogMeansCurrent=true

 

2、流程部署相关 

 如下建立对应文件和文件夹

 2.1 流程部署

    /**
     * 部署流程
     * @param name
     */
    @GetMapping("/deployPc")
    public CommonResult<String> deployPc(@NotBlank(message = "流程部署文件不能为空") String name) {
        String id = myProcessService.deployPc(name);
        // String id = myProcessService.deployPc("process/mjAddi.bpmn20.xml");
        return CommonResult.success(id);
    }

2.2 部署流程列表查询

    // 根据名字查流程定义列表，不传则查所有
public List<MyProcessDefinitionVo> processDefList(String procName) {
        ProcessDefinitionQuery pdq = repositoryService.createProcessDefinitionQuery();
        if(StringUtils.isNotBlank(procName)) {
            pdq.processDefinitionName(procName);
        }
        List<ProcessDefinition> pdList = pdq.active().latestVersion().list();
        return beanUtils.copyList(pdList, MyProcessDefinitionVo.class);
    }

3、流程实例

3.1 发起流程

要点一个是可以指定发起人，二是将processId和自定义表单绑定

    @Transactional(rollbackFor = Exception.class)
    public String startMjProc(PoliceAddiscoreFlowVo policeAddiscoreFlowVo) {
        // 发起流程
        // 指定发起人
        identityService.setAuthenticatedUserId(policeAddiscoreFlowVo.getPoliceNum());
        Map<String, Object> var = new HashMap<>();
        var.put("mjNum", policeAddiscoreFlowVo.getPoliceNum());
        String procInsId  = runtimeService.startProcessInstanceById(policeAddiscoreFlowVo.getProcessId(), var).getId();
        policeAddiscoreFlowVo.setProcessId(procInsId);

        // 保存表单
        policeAddiscoreFlowVo.setId(IdUtil.fastUUID());
        policeAddiscoreFlowVo.setState(ApproveStateEnum.APVING.getValue());
        policeAddiscoreFlowVo.setCreateTime(new Date());
        TPoliceAddiscoreFlow addiscoreFlow = new TPoliceAddiscoreFlow();
        BeanUtils.copyProperties(policeAddiscoreFlowVo, addiscoreFlow);
        addiscoreFlow.setId(IdUtil.fastUUID());
        tPoliceAddiscoreFlowMapper.insert(addiscoreFlow);

    }

3.2 审批 

可以有参数一起传入，也可以没有，具体看API就行

taskService.complete(task.getId(), variables);

 3.3 候选人认领

// 认领任务
taskService.claim(approveVo.getTaskId(), approveVo.getPoliceNum());

 3.4 删除/撤销任务

需要添加删除原因，在查询时可以查到

runtimeService.deleteProcessInstance(processId, deleteReason);

3.5回退

回退操作需要用到activityId，所以回退前要先查询这个id

    @Transactional(rollbackFor = Exception.class)
    public void backProc(PoliceAddiscoreFlowVo policeAddiscoreFlowVo) {
        String processId = policeAddiscoreFlowVo.getProcessId();
        Execution actExecution = runtimeService.createExecutionQuery()
                .processInstanceId(processId)
                .list()
                .get(0);
        HistoricActivityInstance hisActIns = historyService.createHistoricActivityInstanceQuery()
                .processInstanceId(processId)
                .taskAssignee(policeAddiscoreFlowVo.getPoliceNum())
                .orderByHistoricActivityInstanceStartTime()
                .desc()
                .list()
                .get(0);

        runtimeService.createChangeActivityStateBuilder()
                .processInstanceId(processId)
                .moveActivityIdTo(actExecution.getActivityId(), hisActIns.getActivityId())
                .changeState();
    }

 回退相对比较复杂，重点记录一下

1.串行路线上的退回：流程中没有任何网关（排他网关/并行网关）和会签多实例。

2.退回到并行网关分支中的某一个节点上：

3.并行网关中的某一个分支节点上发起退回，退回到并行网关前面的某一个节点上

4.子流程中退回到主干流程中某一个节点/主干流程退回到子流程中某一个节点。

如下图：

1.普通串行路线上的退回（此流程中没有并行网关的退回时），此方法支持普通串行节点/会签多实例节点/排他网关节点：

runtimeService.createChangeActivityStateBuilder()
.processInstanceId(proInstanceId)
.moveActivityIdsToSingleActivityId(curTaskKeys, targetTaskKey)
.changeState();

或者

moveActivityIdTo(String currentActivityId,String newActivityId)；

2.并行网关中发起退回（即撤销当前的网关）,这个地方不能用
​​​moveActivityIdTo(String currentActivityId,String newActivityId)；​​是因为当某一个分支完成，它的is_active为0，另一条分支没有完成时。这时候这个方法是取不到所的分支的key的，它只有is_active为1的key能取到，不然就会造成多一条垃圾数据，同时再走并行时，任何一个分支不会等另一个分支就完走到分支的合并节点上，这就是bug，所以要改为以下方法：

// 并行网关的退回

List currentExecutionIds = new ArrayList<>();
List executions = runtimeService.createExecutionQuery().parentId(proInstanceId).list();
for (Execution execution : executions) {
System.out.println("并行网关节点数："+execution.getActivityId());
currentExecutionIds.add(execution.getId());
}
runtimeService.createChangeActivityStateBuilder()
.moveExecutionsToSingleActivityId(currentExecutionIds, targetTaskKey)
.changeState();

3.退回到并行网关中的某一个节点：经试验退回时必须同时退回并行网关中的所有分支。

List targetTaskKeys = new ArrayList<>();
targetTaskKeys.add("sid-CA74ADED-7E70-451D-951C-95988BFC3F07");
targetTaskKeys.add("sid-7922C598-74FD-4848-95AC-D9790AF68432");

runtimeService.createChangeActivityStateBuilder()
.processInstanceId(proInstanceId)
.moveSingleActivityIdToActivityIds("sid-CAD50E6F-7E0C-437D-816B-DDBA1A976A79", targetTaskKeys)
.changeState();

4.主干流程和子流程的退回（没有试验过），官方提供了以下方法：

moveActivityIdToParentActivityId(String currentActivityId, String newActivityId)

moveActivityIdToSubProcessInstanceActivityId(String currentActivityId, String newActivityId, String callActivityId)

3.6 根据流程id查询所有节点

List<HistoricTaskInstance> res = historyService.createHistoricTaskInstanceQuery()
                .processInstanceId(processInsId)
                .includeProcessVariables()
                .orderByHistoricTaskInstanceStartTime().asc()
                .list();

3.7 查询我申请的列表

List<HistoricProcessInstance> res = historyService.createHistoricProcessInstanceQuery()
                .startedBy(userId)
                .orderByProcessInstanceStartTime()
                .desc()
                .list();

3.8 查询我的待办

List<Task> tasks = taskService.createTaskQuery()
                .active()
                .taskCandidateOrAssigned(searchForm.getUserId())
                .orderByTaskCreateTime().desc()
                .list();

3.9 查询我的已办

List<HistoricTaskInstance> res = historyService.createHistoricTaskInstanceQuery()
                .taskAssignee(searchForm.getUserId())
                .finished()
                .orderByHistoricTaskInstanceEndTime().desc()
                .list();