疯狂的狮子Li
2024-05-20 69e3afc7707d467b758858b52d3784947f7a502b
ruoyi-modules/ruoyi-workflow/src/main/java/org/dromara/workflow/service/IActProcessInstanceService.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,118 @@
package org.dromara.workflow.service;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.workflow.domain.bo.ProcessInstanceBo;
import org.dromara.workflow.domain.bo.ProcessInvalidBo;
import org.dromara.workflow.domain.bo.TaskUrgingBo;
import org.dromara.workflow.domain.vo.ActHistoryInfoVo;
import org.dromara.workflow.domain.vo.ProcessInstanceVo;
import java.util.List;
import java.util.Map;
/**
 * æµç¨‹å®žä¾‹ æœåС层
 *
 * @author may
 */
public interface IActProcessInstanceService {
    /**
     * é€šè¿‡æµç¨‹å®žä¾‹id获取历史流程图
     *
     * @param processInstanceId æµç¨‹å®žä¾‹id
     * @return ç»“æžœ
     */
    String getHistoryImage(String processInstanceId);
    /**
     * é€šè¿‡æµç¨‹å®žä¾‹id获取历史流程图运行中,历史等节点
     *
     * @param processInstanceId æµç¨‹å®žä¾‹id
     * @return ç»“æžœ
     */
    Map<String, Object> getHistoryList(String processInstanceId);
    /**
     * åˆ†é¡µæŸ¥è¯¢æ­£åœ¨è¿è¡Œçš„æµç¨‹å®žä¾‹
     *
     * @param processInstanceBo å‚æ•°
     * @param pageQuery         åˆ†é¡µ
     * @return ç»“æžœ
     */
    TableDataInfo<ProcessInstanceVo> getPageByRunning(ProcessInstanceBo processInstanceBo, PageQuery pageQuery);
    /**
     * åˆ†é¡µæŸ¥è¯¢å·²ç»“束的流程实例
     *
     * @param processInstanceBo å‚æ•°
     * @param pageQuery         åˆ†é¡µ
     * @return ç»“æžœ
     */
    TableDataInfo<ProcessInstanceVo> getPageByFinish(ProcessInstanceBo processInstanceBo, PageQuery pageQuery);
    /**
     * èŽ·å–å®¡æ‰¹è®°å½•
     *
     * @param processInstanceId æµç¨‹å®žä¾‹id
     * @return ç»“æžœ
     */
    List<ActHistoryInfoVo> getHistoryRecord(String processInstanceId);
    /**
     * ä½œåºŸæµç¨‹å®žä¾‹ï¼Œä¸ä¼šåˆ é™¤åŽ†å²è®°å½•(删除运行中的实例)
     *
     * @param processInvalidBo å‚æ•°
     * @return ç»“æžœ
     */
    boolean deleteRunInstance(ProcessInvalidBo processInvalidBo);
    /**
     * è¿è¡Œä¸­çš„实例 åˆ é™¤ç¨‹å®žä¾‹ï¼Œåˆ é™¤åŽ†å²è®°å½•ï¼Œåˆ é™¤ä¸šåŠ¡ä¸Žæµç¨‹å…³è”ä¿¡æ¯
     *
     * @param processInstanceIds æµç¨‹å®žä¾‹id
     * @return ç»“æžœ
     */
    boolean deleteRunAndHisInstance(List<String> processInstanceIds);
    /**
     * æŒ‰ç…§ä¸šåŠ¡id删除 è¿è¡Œä¸­çš„实例 åˆ é™¤ç¨‹å®žä¾‹ï¼Œåˆ é™¤åŽ†å²è®°å½•ï¼Œåˆ é™¤ä¸šåŠ¡ä¸Žæµç¨‹å…³è”ä¿¡æ¯
     *
     * @param businessKeys ä¸šåŠ¡id
     * @return ç»“æžœ
     */
    boolean deleteRunAndHisInstanceByBusinessKeys(List<String> businessKeys);
    /**
     * å·²å®Œæˆçš„实例 åˆ é™¤ç¨‹å®žä¾‹ï¼Œåˆ é™¤åŽ†å²è®°å½•ï¼Œåˆ é™¤ä¸šåŠ¡ä¸Žæµç¨‹å…³è”ä¿¡æ¯
     *
     * @param processInstanceIds æµç¨‹å®žä¾‹id
     * @return ç»“æžœ
     */
    boolean deleteFinishAndHisInstance(List<String> processInstanceIds);
    /**
     * æ’¤é”€æµç¨‹ç”³è¯·
     *
     * @param processInstanceId æµç¨‹å®žä¾‹id
     * @return ç»“æžœ
     */
    boolean cancelProcessApply(String processInstanceId);
    /**
     * åˆ†é¡µæŸ¥è¯¢å½“前登录人单据
     *
     * @param processInstanceBo å‚æ•°
     * @param pageQuery         åˆ†é¡µ
     * @return ç»“æžœ
     */
    TableDataInfo<ProcessInstanceVo> getPageByCurrent(ProcessInstanceBo processInstanceBo, PageQuery pageQuery);
    /**
     * ä»»åŠ¡å‚¬åŠž(给当前任务办理人发送站内信,邮件,短信等)
     *
     * @param taskUrgingBo ä»»åŠ¡å‚¬åŠž
     * @return ç»“æžœ
     */
    boolean taskUrging(TaskUrgingBo taskUrgingBo);
}