工作流相关API实例

相关api 实例

基础部分

1.创建一个流程实例

@Override    public Result createProcessInstance(Paramenter paramenter) {        Result result = new Result();        String processInstanceByKey=paramenter.getProcessInstanceByKey();        try {            String processInstanceId=ProcessUtils.createProcessInstance(processEngine,processInstanceByKey);            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);            result.setData(processInstanceId);        } catch (Exception e) {            logger.error("业务流程实例化失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("业务流程实例化失败！");            result.setError(e.getMessage());        }        return result;    }

2.查找任务

@Override    public Result createProcessInstance(Paramenter paramenter) {        Result result = new Result();        String processInstanceByKey=paramenter.getProcessInstanceByKey();        try {            String processInstanceId=ProcessUtils.createProcessInstance(processEngine,processInstanceByKey);            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);            result.setData(processInstanceId);        } catch (Exception e) {            logger.error("业务流程实例化失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("业务流程实例化失败！");            result.setError(e.getMessage());        }        return result;    }

3.执行处理任务

@Override    public Result completeTask(Paramenter paramenter) {        Result result = new Result();        String taskId=paramenter.getTaskId();        Object signal=paramenter.getSignal();        try {            ProcessUtils.completeTask(processEngine, taskId, signal);            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);        } catch (Exception e) {            logger.error("用户作业处理失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("用户作业处理失败！");            result.setError(e.getMessage());        }        return result;    }

4.查找历史任务

@Override    public Result historyTaskList(Paramenter paramenter) {        Result result = new Result();        String processInstanceId=paramenter.getProcessInstanceId();        List<TaskDto> taskDtoList=null;        TaskDto taskDto=null;        try {            List<HistoricTaskInstance> list=ProcessUtils.historyTaskList(processEngine, processInstanceId);            if(list!=null){                taskDtoList=new ArrayList<TaskDto>();                for (HistoricTaskInstance historicTaskInstance : list) {                    taskDto=new TaskDto();                    taskDto.setId(historicTaskInstance.getId());                    taskDto.setExecutionId(historicTaskInstance.getExecutionId());                    taskDto.setName(historicTaskInstance.getName());                    taskDto.setProcessInstanceId(historicTaskInstance.getProcessInstanceId());                    taskDto.setStartTime(historicTaskInstance.getStartTime());                    taskDto.setEndTime(historicTaskInstance.getEndTime());                    taskDtoList.add(taskDto);                }            }            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);            result.setListData(taskDtoList);        } catch (Exception e) {            logger.error("查看流转日志失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("查看流转日志失败！");            result.setError(e.getMessage());        }        return result;    }

5查找历史Activity任务

    @Override    public Result historyActivityList(Paramenter paramenter) {        Result result = new Result();        String processInstanceId=paramenter.getProcessInstanceId();        List<ActivityDto> activityDtoList=null;        ActivityDto activityDto=null;        try {            List<HistoricActivityInstance> list=ProcessUtils.historyActivityList(processEngine, processInstanceId);            if(list!=null){                activityDtoList=new ArrayList<ActivityDto>();                for (HistoricActivityInstance historicActivityInstance : list) {                    activityDto=new ActivityDto();                    activityDto.setActivitiId(historicActivityInstance.getActivityId());                    activityDto.setActivityName(historicActivityInstance.getActivityName());                    activityDto.setActivityType(historicActivityInstance.getActivityType());                    activityDto.setDuration(historicActivityInstance.getDurationInMillis());                    activityDto.setProcessInstanceId(historicActivityInstance.getProcessInstanceId());                    activityDto.setTaskId(historicActivityInstance.getTaskId());                    activityDto.setStartTime(historicActivityInstance.getStartTime());                    activityDto.setEndTime(historicActivityInstance.getEndTime());                    activityDtoList.add(activityDto);                }            }            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);            result.setListData(activityDtoList);        } catch (Exception e) {            logger.error("查看流转日志失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("查看流转日志失败！");            result.setError(e.getMessage());        }        return result;    }

特殊部分

1.删除任务

@Override    public Result deleteProcessInstance(Paramenter paramenter) {        Result result = new Result();        String processInstanceId=paramenter.getProcessInstanceId();        String deleteReason=paramenter.getDeleteReason();        try {            ProcessUtils.deleteProcessInstance(processEngine, processInstanceId, deleteReason);            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);        } catch (Exception e) {            logger.error("删除业务流程实例失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("删除业务流程实例失败！");            result.setError(e.getMessage());        }        return result;    }

2.挂机和重启任务

@Override    public Result suspendAndActivateProcessInstance(Paramenter paramenter) {        Result result = new Result();        String processInstanceId=paramenter.getProcessInstanceId();        Boolean suspendOrActivate=paramenter.getSuspendOrActivate();        try {            ProcessUtils.suspendOrActivateProcessInstance(processEngine, processInstanceId, suspendOrActivate);            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);        } catch (Exception e) {            logger.error("流程的挂起或激活失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("流程的挂起或激活失败！");            result.setError(e.getMessage());        }        return result;    }

3.执行任务带审批内容

@Override    public Result completeTaskDetail(Paramenter paramenter) {        Result result = new Result();        String taskId=paramenter.getTaskId();        Object signal=paramenter.getSignal();        String context=paramenter.getContext();        try {            ProcessUtils.completeTaskDetail(processEngine, taskId, signal,context);            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);        } catch (Exception e) {            logger.error("用户作业处理失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("用户作业处理失败！");            result.setError(e.getMessage());        }        return result;    }

4.查找历史流程实例带审批

@Override    public Result historyTaskListDetail(Paramenter paramenter) {        Result result = new Result();        String processInstanceId=paramenter.getProcessInstanceId();        String taskId=paramenter.getTaskId();        List<TaskDto> taskDtoList=null;        TaskDto taskDto=null;        try {            List<HistoricTaskInstance> list=ProcessUtils.historyTaskList(processEngine, processInstanceId);            if(list!=null){                taskDtoList=new ArrayList<TaskDto>();                for (HistoricTaskInstance historicTaskInstance : list) {                    taskDto=new TaskDto();                    taskDto.setId(historicTaskInstance.getId());                    taskDto.setExecutionId(historicTaskInstance.getExecutionId());                    taskDto.setName(historicTaskInstance.getName());                    taskDto.setProcessInstanceId(historicTaskInstance.getProcessInstanceId());                    taskDto.setStartTime(historicTaskInstance.getStartTime());                    taskDto.setEndTime(historicTaskInstance.getEndTime());                    String executionId=taskDto.getExecutionId();                    List<HistoricVariableInstance> lists = processEngine.getHistoryService()                              .createHistoricVariableInstanceQuery()//创建一个历史的流程变量查询                              .processInstanceId(processInstanceId)                            .executionId(executionId)                            .variableName("context")                             //.taskId(taskDto.getId())                            .list();                          for(HistoricVariableInstance hiv : lists){                             String context=(String) hiv.getValue();                            taskDto.setContext(context);                        }                      taskDtoList.add(taskDto);                }              }            result.setResult(true);            result.setCode(ConstCode.OPERAT_SUCCESS);            result.setListData(taskDtoList);        } catch (Exception e) {            logger.error("查看流转日志失败！");            logger.error(e.getMessage());            result.setResult(false);            result.setCode(ConstCode.OPERAT_FAILURE);            result.setMessage("查看流转日志失败！");            result.setError(e.getMessage());        }        return result;    }

定义工具类ProcessUtils

public class ProcessUtils {    /**     * 流程操作     *      * @param taskId     *            作业Id     * @param content     *            审批内容     */    public static void completeTask(ProcessEngine processEngine,String taskId, Object signal) {        Map<String, Object> variables = new HashMap();        variables.put("signal", signal);        processEngine.getTaskService().complete(taskId, variables);    }    /**     * 查看流转日志(某一次流程的执行经历的任务)     *      * @param processInstanceId     */    public static List<HistoricTaskInstance> historyTaskList(ProcessEngine processEngine,String processInstanceId) {        List<HistoricTaskInstance> list = processEngine.getHistoryService().createHistoricTaskInstanceQuery()                .processInstanceId(processInstanceId)                // .finished()                .list();        return list;    }    /**     * 查看流转日志(某一次流程的执行经历的活动)     *      * @param processInstanceId     */    public static List<HistoricActivityInstance> historyActivityList(ProcessEngine processEngine,String processInstanceId) {        List<HistoricActivityInstance> list = processEngine.getHistoryService().createHistoricActivityInstanceQuery()                .processInstanceId(processInstanceId)                // .finished()                .list();        return list;    }    /**     * 判断当前流程是否执行完 0是，1否     */    public static String processState(ProcessEngine processEngine,String processInstanceId) {        ProcessInstance pi = processEngine.getRuntimeService().createProcessInstanceQuery().processInstanceId(processInstanceId)                .singleResult();        String flag="1";        if (pi == null) {            flag="0";        }         return flag;    }    /**     * 删除当前流程实例      */    public static void deleteProcessInstance(ProcessEngine processEngine,String processInstanceId,String deleteReason) {          processEngine.getRuntimeService().deleteProcessInstance(processInstanceId, deleteReason);    }    /**挂起或激活当前流程实例      *      * @param processEngine     * @param processInstanceId     * @param suspendOrActivate ture:挂起，false:激活     * @return     */    public static Boolean suspendOrActivateProcessInstance(ProcessEngine processEngine,String processInstanceId,Boolean suspendOrActivate) {        RuntimeService ru=processEngine.getRuntimeService();        if(suspendOrActivate){            //挂起流程实例            ru.suspendProcessInstanceById(processInstanceId);             //验证是否挂起            return ru.createProcessInstanceQuery().processInstanceId(processInstanceId).singleResult().isSuspended();        }if(!suspendOrActivate){             //激活流程实例            ru.activateProcessInstanceById(processInstanceId);            //验证是否激活            return !ru.createProcessInstanceQuery().processInstanceId(processInstanceId).singleResult().isSuspended();        }       return false;    }    /**     * 返回用户流程作业     *      * @param candidateUser     * @return     */    public static List<Task> findTask(ProcessEngine processEngine,String candidateUser) {        List<Task> taskList = processEngine.getTaskService().createTaskQuery().taskCandidateUser(candidateUser).list();        return taskList;    }    /** 查询 历史任务的用户列表 */    public static List<HistoricIdentityLink> findHistoryGroupCandidate(ProcessEngine processEngine,String processInstanceId) {        // 流程实例ID        List<HistoricIdentityLink> list = processEngine.getHistoryService()                .getHistoricIdentityLinksForProcessInstance(processInstanceId);        if (list != null && list.size() > 0) {            for (HistoricIdentityLink identityLink : list) {                System.out.println("任务ID：" + identityLink.getTaskId());                System.out.println("用户ID：" + identityLink.getUserId());                System.out.println("工作流角色ID：" + identityLink.getGroupId());            }        }        return list;    }    /**     * 创建一个流程实例task(流程作业)     *      * @throws Exception     */    public static String createProcessInstance(ProcessEngine processEngine,String processInstanceByKey) throws Exception {        ProcessInstance processInstance = processEngine.getRuntimeService().startProcessInstanceByKey(processInstanceByKey);        return processInstance.getId();    }    /**     * 创建一个流程实例task(流程作业带业务主键)     *      * @param businessKey业务主键     * @return     * @throws Exception     */    public static String createProcessInstance(ProcessEngine processEngine,String processInstanceByKey,String businessKey) throws Exception {        ProcessInstance processInstance = processEngine.getRuntimeService().startProcessInstanceByKey(processInstanceByKey,                businessKey);        return processInstance.getId();    }    public static void deploy(ProcessEngine processEngine,String name,String bpmn,String png) throws Exception {        // 获取仓库服务        RepositoryService repositoryService = processEngine.getRepositoryService();        // 创建发布配置对象        DeploymentBuilder builder = repositoryService.createDeployment();        // 设置发布信息        builder.name(name)// 添加部署规则的显示别名                .addClasspathResource(bpmn)// 添加规则文件                .addClasspathResource(png);// 添加规则图片        // 不添加会自动产生一个图片不推荐        // 完成发布        builder.deploy();    }    public void deployZIP(ProcessEngine processEngine,String name,String zip) throws Exception {        // 获取仓库服务        RepositoryService repositoryService = processEngine.getRepositoryService();        // 创建发布配置对象        DeploymentBuilder builder = repositoryService.createDeployment();        // 获得上传文件的输入流程        InputStream in = this.getClass().getClassLoader().getResourceAsStream(zip);        ZipInputStream zipInputStream = new ZipInputStream(in);        // 设置发布信息        builder.name(name)// 添加部署规则的显示别名                .addZipInputStream(zipInputStream);        // 完成发布        builder.deploy();    }    /**     * 流程操作     *      * @param taskId     *            作业Id     * @param content     *            审批内容     */    public static void completeTaskDetail(ProcessEngine processEngine,String taskId, Object signal,String context) {        Map<String, Object> variables = new HashMap();        variables.put("context", context);        variables.put("signal", signal);        processEngine.getTaskService().complete(taskId, variables);    }    public static void main(String[] args) throws Exception {        // 部署        // deploy();        // 流程实例化        // String proc_inst_id=createProcessInstance();        // 当前用户作业        // findTask("aa");        // 处理        // completeTask("c8452602-08e4-11e7-8486-dc536091e18b","11");        //historyTaskList("c4c5bfff-08e0-11e7-a7bc-dc536091e18b");    }/*  public void setVariableValues() throws Exception {        TaskService taskService = processEngine.getTaskService();        String taskId = "";        String variableName = "";        taskService.setVariable("", "", "");    }    public void getVariableValues() throws Exception {        TaskService taskService = processEngine.getTaskService();        String taskId = "";        String variableName = "";        taskService.getVariable(taskId, variableName);    }    public void setRuVariableValues() throws Exception {        RuntimeService runtimeService = processEngine.getRuntimeService();        runtimeService.setVariable("", "", "");        String taskId = "";        String variableName = "";    }    public void setPVariableValues() throws Exception {        String processDefinitionKey = "varTest";        // 创建流程变量        Map<String, Object> variables = new HashMap<String, Object>();        variables.put("请假人", "冯小刚");        // 在启动时设置流程变量        ProcessInstance pi = processEngine.getRuntimeService().startProcessInstanceByKey(processDefinitionKey,                variables);        System.out.println("pid:" + pi.getId());    }*/}