package com.hotent.runtime.manager; import java.util.List; import java.util.Map; import java.util.concurrent.CompletableFuture; import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.node.ObjectNode; import com.hotent.base.model.CommonResult; import com.hotent.base.query.PageList; import com.hotent.bpm.api.model.process.inst.BpmProcessInstance; import com.hotent.bpm.api.model.process.task.BpmTaskOpinion; import com.hotent.bpm.persistence.model.BpmIdentityResult; import com.hotent.bpm.persistence.model.DefaultBpmProcessInstance; import com.hotent.bpm.persistence.model.DefaultBpmTask; import com.hotent.runtime.params.BpmCheckOpinionVo; import com.hotent.runtime.params.BpmImageParamObject; import com.hotent.runtime.params.BpmNodeDefVo; import com.hotent.runtime.params.BpmTaskResult; import com.hotent.runtime.params.DefOtherParam; import com.hotent.runtime.params.DoEndParamObject; import com.hotent.runtime.params.DoNextParamObject; import com.hotent.runtime.params.StartFlowParamObject; import com.hotent.runtime.params.StartResult; /** * 流程控制接口 * * @company 广州宏天软件股份有限公司 * @author zhangxianwen * @email zhangxw@jee-soft.cn * @date 2018年6月28日 */ public interface IProcessManager { /** * 客户端采用异步线程的方式启动流程 * @param startFlowParamObject * @return * @throws Exception */ CompletableFuture start(StartFlowParamObject startFlowParamObject) throws Exception; /** * 客户端提交数据,执行流程往下跳转 * @param doNextParamObject * @return * @throws Exception */ CommonResult doNext(DoNextParamObject doNextParamObject) throws Exception; /** * 人工终止流程 * 参数格式：{account:"",taskId:"",endReason:"",messageType:""} * account:用户账号 必填 * taskId:任务ID 必填 * endReason:终止原因 必填 * messageType:消息通知类型 非必填，默认邮件 * @param flowParamObject * @return * @throws Exception */ CommonResult doEndProcess(DoEndParamObject doEndParamObject) throws Exception; /** * 人工终止恢复 * @param doEndParamObject * @return * @throws Exception */ CommonResult renewProcess(String instId,String reason) throws Exception; /** * 按流程实例ID或任务实例ID取得某个流程的审批历史 * @param procInstId 实例id * @param taskId 任务id * @return * @throws Exception */ List getHistoryOpinion(String procInstId,String taskId) throws Exception; /** * 按Activiti实例Id取得对应流程的审批历史，act_ru_task表的PROC_INST_ID_值 * @param actTaskId * @return * @throws Exception */ List getProcessOpinionByActInstId(String actTaskId) throws Exception; /** * 根据任务ID获取可驳回的节点 * @param taskId * @param rejectType * @return * @throws Exception */ List getEnableRejectNode(String taskId,String rejectType) throws Exception; /** * 根据任务ID或流程实例ID获取BusinessKey（流程表单为URL表单的情况） * @param procInstanceId 实例id * @param taskId 任务id * @return * @throws NullPointerException */ CommonResult getBusinessKey(String procInstanceId,String taskId) throws NullPointerException; /** * 根据BussinessKey获取流程实例ID * @param businessKey * @return * @throws NullPointerException */ CommonResult getProcInstId(String businessKey) throws NullPointerException; /** * 通过表单保存草稿 * @param flowParamObject * @return * @throws NullPointerException */ StartResult saveDraft(StartFlowParamObject startFlowParamObject) throws Exception; /** * 设置流程的其他参数 * @param defOtherParam * @return * @throws Exception */ CommonResult setDefOtherParam(DefOtherParam defOtherParam) throws Exception; /** * 根据任务id获取预先设置的审批用语列表 * @param taskId * @return * @throws Exception */ List getApprovalItems(String taskId) throws Exception; /** * 根据任务id获取其处理人 * @param taskId * @return * @throws Exception */ List getNodeUsers(String taskId) throws Exception; /** * 根据流程taskId获取对应的流程运行对象 * @param taskId * @return * @throws Exception */ BpmProcessInstance getProcessRunByTaskId(String taskId) throws Exception; /** * 根据instId和nodeId获取节点的状态 * @param runId * @param nodeId * @return * @throws Exception */ String getStatusByRunidNodeId(String instId,String nodeId) throws Exception; /** * 根据任务ID获取流程任务实例 * @param taskId * @return * @throws Exception */ BpmTaskResult getTaskByTaskId(String taskId) throws Exception; /** * 根据taskid获取taskName * @param taskId * @return * @throws Exception */ String getTaskNameByTaskId(String taskId) throws Exception; /** * 通过businessKey获取运行实例 * @param businessKey * @return * @throws Exception */ DefaultBpmProcessInstance getInstancetByBusinessKey(String businessKey) throws Exception; /** * 通过businessKey和sysCode获取运行实例 * @param businessKey * @param sysCode * @return * @throws Exception */ DefaultBpmProcessInstance getInstancetByBizKeySysCode(String businessKey,String sysCode) throws Exception; /** * 根据实例id获取实例对象 * @param instId * @return * @throws Exception */ BpmProcessInstance getInstanceByInstId(String instId) throws Exception; /** * 根据xml获取实例列表 * @param xml * @return * @throws Exception */ PageList getInstanceListByXml(String xml) throws Exception; /** * 取得某个运行流程实例对应的任务列表 * @param instId * @return * @throws Exception */ PageList getTasksByInstId(String instId) throws Exception; /** * 根据任务id获取任务的后续节点 * @param taskId * @return * @throws Exception */ List getTaskOutNodes(String taskId) throws Exception; /** * 根据任务id获取在线表单地址 * @param taskId * @return * @throws Exception */ String getDetailUrl(String taskId) throws Exception; /** * 根据任务taskId,设置流程变量（全局） * @param taskId * @param variables * @return * @throws Exception */ CommonResult setTaskVar(String taskId,Map variables) throws Exception; /** * 设置任务节点本地变量 * @param taskId * @param variables * @return * @throws Exception */ CommonResult setTaskVarLocal(String taskId,Map variables) throws Exception; /** * 通过流程实例id挂起流程 * @param instId * @return * @throws Exception */ CommonResult forbiddenInstance(String instId) throws Exception; /** * 通过流程实例id取消挂起流程实例 * @param instId * @return * @throws Exception */ CommonResult unForbiddenInstance(String instId) throws Exception; /** * 根据父流程实例ID和节点定义ID查子流程实例 * @param parentInstId * @param superNodeId * @return * @throws Exception */ List getBpmProcessByParentIdAndSuperNodeId(String parentInstId,String superNodeId)throws Exception; /** * 通过父流程实例ID和实例的状态获取实例列表 * @param parentInstId * @param status * @return * @throws Exception */ List getInstancesByParentId(String parentInstId,String status) throws Exception; /** * 通过父流程定义ID和实例的状态获取实例列表 * @param defId * @param status * @return * @throws Exception */ List getInstancesByDefId(String defId,String status) throws Exception; /** * 根据流程实例ID查询顶级的流程实例。 * @param instId * @return * @throws Exception */ BpmProcessInstance getTopBpmProcessInstance(String instId) throws Exception; /** * 根据流程定义id或流程实例id或任务id或BPMN实例ID获取流程图。 * @param bpmImageParamObject * @return * @throws Exception */ String getBpmImage(BpmImageParamObject bpmImageParamObject) throws Exception; /** * 沟通反馈 * @param doNextParamObject * @return * @throws Exception */ CommonResult doNextcommu(DoNextParamObject doNextParamObject) throws Exception; Map getUrgentStateConf(ObjectNode obj) throws Exception; /** * 传阅回复 * @param doNextParamObject * @return * @throws Exception */ CommonResult doNextCopyto(DoNextParamObject doNextParamObject) throws Exception; /** * 采用同步线程的方式启动流程，启动前[不校验权限]。办结撤回需要用到。1，通过线程变量控制办结撤回启动的流程不产生堆栈信息。2，通过线程变量把重启产生的任务id返回给前端，方便前端撤回后直接跳转到待办页面。 * @param startFlowParamObject * @return * @throws Exception */ StartResult syncStart(StartFlowParamObject startFlowParamObject) throws Exception; /** * 采用同步线程的方式启动流程，启动前校验权限。 * @param startFlowParamObject 入参，流程key和定义id二选一 * @return 启动结果 * @throws Exception */ StartResult syncStartWithRight(StartFlowParamObject startFlowParamObject) throws Exception; Map> instanceDetails(List ids); /** * 获取我的请求对应实例的任务，如果为null，表示没有可以处理的任务 * 分两种情况： * 1、如果包含退回发起人/驳回发起人，进入我的申请，如果单据退回发起人/驳回发起人状态，直接进入待办 * 2、如果情况1不满足，进入只读状态查看我的审批单，可关闭或撤回（根据按钮权限渲染） * @param instId 实例ID（来自我的请求列表） * @return 任务详情，如果为null，表示没有可以处理的任务 */ DefaultBpmTask getMyRequestTask(String instId); /** * 会议申请绑定流程发起 * @param mappingObject * @param flowKey * @return * @throws Exception */ CommonResult meetingRoomApply(JsonNode mappingObject,String flowKey) throws Exception; }