BPM接口使用说明.docx

BPM使用说明 在开发业务模块过程中如果需要使用BPM接口，可以通过IProcInstSrv进行接口调用。提供的具体接口如下：1.启动流程实例/* * 启动流程实例 * param procEName 流程英文标识 * param procVersion 流程版本号 * param vars 流程实例变量 * param userId 发起流程人员Id * param username 发起流程人员名称 * param ccUsers 抄送人员Id * return */public ProcInstEntity startProc(String procEName, String procVersion,List vars, String userId, String userName,String ccUsers);代码示例：/从前台得到需要的参数String procEName=reqDTO.getValue(procEName);String procVersion=reqDTO.getValue(procVersion);String ccUsers=reqDTO.getValue(ccUsers);WFUtils utils=new WFUtils();/通过WFUtils.getProcVariable（）得到流程实例变量List variables=utils.getProcVariable(reqDTO);/得到IProcInstSrv流程调用接口IProcInstSrv procInstSrv=MemberCache.getInstance().getProcInstSrv(); /调用启动流程实例接口procInstSrv.startProc(procEName,procVersion, variables, userToken.getUserId(),userToken.getUserName(),ccUsers);2.得到待审批列表 /* * 根据当前用户和模板类型得到待审批列表 * param userId 用户ID * param procType 流程类型 * examineinstId 审批实例Id 一般设为空字符串即可 * examineRoleId 角色Id * return */public List getExamineInstListByUserID(String userId, String procType,String examineinstId, String examineRoleId);代码示例： /列表分页显示代码部分String currentPage = msg.getValue(currentPage);if(currentPage=null | currentPage.trim().equals()currentPage = 1;String pageSize = msg.getValue(pageSize);if(pageSize=null | pageSize.trim().equals()ConfigHandler cfgHd = ConfigFactory.getCfgHandler();pageSize = cfgHd.getSingleNodeValue(/pagination/pageSize);UserToken userToken = reqDTO.getUserToken();/从前台页面得到参数String procType=;String userId=userToken.getUserId();String orgId=userToken.getOrgId();String examineRoleId=userToken.getRoleIds();/得到调用接口IProcInstSrv procInstSrv=MemberCache.getInstance().getProcInstSrv();/通过接口得到待审批列表List list=procInstSrv.getExamineInstListByUserID(userId,procType,examineRoleId);msg.setValue(datas, list);msg.setValue(totalRows, list.size();3.得到审批页面显示信息/* * 点击审批时得到审批实例的所有信息和所有下级节点 * param procinstId 流程实例Id * param examineinstId 审批实例Id * param procType 流程类型，一般为空字符串 * param userId 当前用户Id * return */public Map getExamineInfo(String procinstId, String examineinstId,String procType, String userId);代码示例：/从前台得到需要参数UserToken userToken = reqDTO.getUserToken();String procType=;String userId=userToken.getUserId();String procinstId=reqDTO.getValue(procinstID);String examineinstId=reqDTO.getValue(examineinstID); /得到流程IProcInstSrv调用接口IProcInstSrv procInstSrv=MemberCache.getInstance().getProcInstSrv();/得到流程详细信息显示页面接口Map map=procInstSrv.getExamineInfo(procinstId, examineinstId, procType, userId);/返回前台页面显示List list=new ArrayList();list.add(map.get(examineinInfo);/是否是第一级审批节点-用户能否回退msg.setValue(isFirstApplyNode, map.get(isFirstApplyNode);/审批信息显示msg.setValue(examineinInfo, list );/下级节点-用户SELECT选择使用msg.setValue(nodeList, map.get(nodeList);/是否能够直接通过msg.setValue(isCanPass, map.get(isCanPass);msg.setValue(startNode, map.get(startNode);4.审批流程实例节点/* * 审批节点 * param nextNodeId 下级节点Id * param examineInfo 本级节点审批信息 * param isPass 是否通过 * param examineinstId 审批实例Id * param procinstId 流程实例Id * param examineUserName 审批用户名称 * param taskInstId 审批taskInstId * return */public Map examineNode(String nextNodeId, String examineInfo,String isPass, String examineinstId, String procinstId,String examineUserName, String taskInstId);代码示例：/从前台得到需要参数String nextNodeId = reqDTO.getValue(nextNodeID);String examineInfo = reqDTO.getValue(examineInfo);String isPassstr = reqDTO.getValue(isPass);String examineinstId = reqDTO.getValue(examineinstID);String procinstId = reqDTO.getValue(procinstID);String taskinstId = reqDTO.getValue(taskinstId); /得到流程IProcInstSrv接口IProcInstSrv procInstSrv = MemberCache.getInstance().getProcInstSrv(); /调用审批接口 procInstSrv.examineNode(nextNodeId, examineInfo, isPassstr,examineinstId, procinstId, userToken.getUserName(), taskinstId);5.得到当前用户发起的流程实例列表/* * 根据当前用户启动的流程实例 * param userId 当前用户Id * param procType 流程类型 * return */public List getStartProcInstByCurUser (String userId,String procType);代码示例：/得到相应参数String userId=userToken.getUserId();String procType=;if(reqDTO.getValue(procType)!=null&!reqDTO.getValue(procType).equals()procType=reqDTO.getValue(procType);/得到流程调用接口IProcInstSrv procInstSrv=MemberCache.getInstance().getProcInstSrv(); /得到当前用户发起的流程列表List list=procInstSrv.getStartProcInstByCurUser(userId, procType);6. 查询当前用户的抄送列表/* * 根据userid查询抄送的流程列表 * param userId 当前用户Id * return */public List queryPorcInstCCByUserId(String userId);代码示例：UserToken userToken