org.dromara.warm.flow.core.service

Interface TaskService

All Superinterfaces:

IWarmService<Task>

All Known Implementing Classes:

TaskServiceImpl

public interface TaskService
extends IWarmService<Task>

待办任务Service接口

Since:

2023-03-29

Author:

warm

Method Summary

Modifier and Type	Method and Description
boolean	addSignature(Long taskId, FlowParams flowParams) 加签，增加办理人
boolean	addSignature(Long taskId, String curUser, List<String> permissionFlag, List<String> addHandlers, String message) Deprecated. 1.3.3版本弃用
Task	addTask(Node node, Instance instance, Definition definition, FlowParams flowParams) 设置流程待办任务对象
boolean	deleteByInsIds(List<Long> instanceIds) 根据instanceIds删除
boolean	depute(Long taskId, FlowParams flowParams) 委派, 默认删除当然办理用户权限，委派后，当前办理不可办理
boolean	depute(Long taskId, String curUser, List<String> permissionFlag, List<String> addHandlers, String message) Deprecated. 1.3.3版本弃用
Task	getNextTask(List<Task> tasks) 并行网关，取结束节点类型，否则随便取id最大的
boolean	reductionSignature(Long taskId, FlowParams flowParams) 减签，减少办理人
boolean	reductionSignature(Long taskId, String curUser, List<String> permissionFlag, List<String> reductionHandlers, String message) Deprecated. 1.3.3版本弃用
Instance	retrieve(Long instanceId, FlowParams flowParams) 取回
String	setFlowStatus(Integer nodeType, String skipType) 设置流程实例和代码任务流程状态
Instance	skip(FlowParams flowParams, Task task) 流程跳转
Instance	skip(Long taskId, FlowParams flowParams) 根据任务id，流程跳转
Instance	termination(Long taskId, FlowParams flowParams) 终止流程，提前结束流程，将所有待办任务转历史
Instance	termination(Task task, FlowParams flowParams) 终止流程，提前结束流程，将所有待办任务转历史
boolean	transfer(Long taskId, FlowParams flowParams) 转办, 默认删除当然办理用户权限，转办后，当前办理不可办理
boolean	transfer(Long taskId, String curUser, List<String> permissionFlag, List<String> addHandlers, String message) Deprecated. 1.3.3版本弃用
boolean	updateHandler(Long taskId, FlowParams flowParams) 修改办理人
boolean	updateHandler(ModifyHandler modifyHandler) Deprecated. 1.3.3版本弃用

Methods inherited from interface org.dromara.warm.flow.core.orm.service.IWarmService

exists, getById, getByIds, getDao, getOne, list, list, orderBy, orderByAsc, orderByCreateTime, orderByDesc, orderById, orderByUpdateTime, page, remove, removeById, removeByIds, save, saveBatch, saveBatch, selectCount, updateBatch, updateById

Method Detail

skip

Instance skip(Long taskId,
              FlowParams flowParams)

根据任务id，流程跳转

Parameters:

taskId:流程任务id[必传] -

flowParams:包含流程相关参数的对象 - - skipType: 跳转类型(PASS审批通过 REJECT退回) [必传] - nodeCode: 如果指定节点,可任意跳转到对应节点 [按需传输] - permissionFlag: 办理人权限标识，比如用户，角色，部门等,未设置办理人或者ignore为true可不传 [按需传输] - message: 审批意见 [按需传输] - handler: 办理人唯一标识 [建议传] - variable: 流程变量 [按需传输,跳转条件放入流程变量<互斥网关必传>] - flowStatus: 流程状态，自定义流程状态 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

skip

Instance skip(FlowParams flowParams,
              Task task)

流程跳转

Parameters:

flowParams:包含流程相关参数的对象 - - skipType: 跳转类型(PASS审批通过 REJECT退回) [必传] - nodeCode: 如果指定节点,可任意跳转到对应节点 [按需传输] - permissionFlag: 办理人权限标识，比如用户，角色，部门等,未设置办理人或者ignore为true可不传 [按需传输] - message: 审批意见 [按需传输] - handler: 办理人唯一标识 [建议传] - variable: 流程变量 [按需传输,跳转条件放入流程变量<互斥网关必传>] - flowStatus: 流程状态，自定义流程状态 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

task:流程任务[必传] -

termination

Instance termination(Long taskId,
                     FlowParams flowParams)

终止流程，提前结束流程，将所有待办任务转历史

Parameters:

taskId: - 流程任务id [必传]

flowParams:包含流程相关参数的对象 - - message: 审批意见 [按需传输] - handler: 办理人唯一标识 [建议传] - flowStatus: 流程状态，自定义流程状态 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

termination

Instance termination(Task task,
                     FlowParams flowParams)

终止流程，提前结束流程，将所有待办任务转历史

Parameters:

task:流程任务 -

flowParams:包含流程相关参数的对象 - - message: 审批意见 [按需传输] - handler: 办理人唯一标识 [建议传] - flowStatus: 流程状态，自定义流程状态 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

deleteByInsIds

boolean deleteByInsIds(List<Long> instanceIds)

根据instanceIds删除

Parameters:

instanceIds - 流程实例id集合

Returns:

boolean

transfer

boolean transfer(Long taskId,
                 FlowParams flowParams)

转办, 默认删除当然办理用户权限，转办后，当前办理不可办理

Parameters:

taskId - 修改的任务id [必传]

flowParams:包含流程相关参数的对象 - - handler 当前办理人唯一标识，代替老版本的curUser [必传] - permissionFlag 用户权限标识集合 [必传] - addHandlers 转办对象 [必传] - message 审批意见 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

transfer

@Deprecated
boolean transfer(Long taskId,
                             String curUser,
                             List<String> permissionFlag,
                             List<String> addHandlers,
                             String message)

Deprecated. 1.3.3版本弃用

转办, 默认删除当然办理用户权限，转办后，当前办理不可办理

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

addHandlers - 增加办理人：加签，转办，委托

message - 审批意见

depute

boolean depute(Long taskId,
               FlowParams flowParams)

委派, 默认删除当然办理用户权限，委派后，当前办理不可办理

Parameters:

taskId - 修改的任务id [必传]

flowParams:包含流程相关参数的对象 - - handler 当前办理人唯一标识，代替老版本的curUser [必传] - permissionFlag 用户权限标识集合 [必传] - addHandlers 委托对象 [必传] - message 审批意见 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

depute

@Deprecated
boolean depute(Long taskId,
                           String curUser,
                           List<String> permissionFlag,
                           List<String> addHandlers,
                           String message)

Deprecated. 1.3.3版本弃用

委派, 默认删除当然办理用户权限，委派后，当前办理不可办理

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

addHandlers - 增加办理人：加签，转办，委托

message - 审批意见

addSignature

boolean addSignature(Long taskId,
                     FlowParams flowParams)

加签，增加办理人

Parameters:

taskId - 修改的任务id [必传]

flowParams:包含流程相关参数的对象 - - handler 当前办理人唯一标识，代替老版本的curUser [必传] - permissionFlag 用户权限标识集合 [必传] - addHandlers 加签对象 [必传] - message 审批意见 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

addSignature

@Deprecated
boolean addSignature(Long taskId,
                                 String curUser,
                                 List<String> permissionFlag,
                                 List<String> addHandlers,
                                 String message)

Deprecated. 1.3.3版本弃用

加签，增加办理人

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

addHandlers - 增加办理人：加签，转办，委托

message - 审批意见

reductionSignature

boolean reductionSignature(Long taskId,
                           FlowParams flowParams)

减签，减少办理人

Parameters:

taskId - 修改的任务id [必传]

flowParams:包含流程相关参数的对象 - - handler 当前办理人唯一标识，代替老版本的curUser [必传] - permissionFlag 用户权限标识集合 [必传] - reductionHandlers 减少办理人 [必传] - message 审批意见 [按需传输] - ignore 转办忽略权限校验，默认不忽略（true：忽略，false：不忽略）[按需传输]

reductionSignature

@Deprecated
boolean reductionSignature(Long taskId,
                                       String curUser,
                                       List<String> permissionFlag,
                                       List<String> reductionHandlers,
                                       String message)

Deprecated. 1.3.3版本弃用

减签，减少办理人

Parameters:

taskId - 修改的任务id

curUser - 当前办理人唯一标识

permissionFlag - 用户权限标识集合

reductionHandlers - 减少办理人

message - 审批意见

updateHandler

boolean updateHandler(Long taskId,
                      FlowParams flowParams)

修改办理人

Parameters:

taskId - 修改的任务id [必传]

flowParams:包含流程相关参数的对象 - - handler 当前办理人唯一标识，代替老版本的curUser [必传] - permissionFlag: 用户所拥有的权限标识[按需传输，ignore为false，则必传] - addHandlers: 增加办理人：加签，转办，委托[按需传输] - reductionHandlers: 减少办理人：减签，委托[按需传输] - message: 审批意见[按需传输] - cooperateType: 协作方式(2转办 3委派 6加签 7减签）[按需传输] - ignore: 转办忽略权限校验,默认忽略（true：忽略，false：不忽略）[按需传输]

updateHandler

@Deprecated
boolean updateHandler(ModifyHandler modifyHandler)

Deprecated. 1.3.3版本弃用

修改办理人

Parameters:

modifyHandler: - 修改办理人参数的对象 - taskId:修改的任务id[必传] - curUser:办理人唯一标识[按需传输] - ignore: 转办忽略权限校验（true：忽略，false：不忽略）[按需传输] - permissionFlag: 用户所拥有的权限标识[按需传输，ignore为false，则必传] - addHandlers: 增加办理人：加签，转办，委托[按需传输] - reductionHandlers: 减少办理人：减签，委托[按需传输] - message: 审批意见[按需传输] - cooperateType: 协作方式(1审批 2转办 3委派 4会签 5票签 6加签 7减签）[按需传输]

retrieve

Instance retrieve(Long instanceId,
                  FlowParams flowParams)

取回

Parameters:

instanceId - 实例id [必传]

flowParams - handler: 当前处理人 [必传] nodeCode: 取回到的节点编码，如果为空，则默认取回到开始节点 [按需传输] flowStatus: 自定义流程状态 [按需传输] hisStatus: 自定义历史任务状态 [按需传输] hisTaskExt: 业务详情扩展字段 [按需传输] message: 审批意见 [按需传输]

Returns:

Instance 流程实例

Since:

2024/9/22 13:59

addTask

Task addTask(Node node,
             Instance instance,
             Definition definition,
             FlowParams flowParams)

设置流程待办任务对象

Parameters:

node - 节点

instance - 流程实例

flowParams - 流程参数

Returns:

Task

setFlowStatus

String setFlowStatus(Integer nodeType,
                     String skipType)

设置流程实例和代码任务流程状态

Parameters:

nodeType - 节点类型（开始节点、中间节点、结束节点）

skipType - 流程条件

getNextTask

Task getNextTask(List<Task> tasks)

并行网关，取结束节点类型，否则随便取id最大的

Parameters:

tasks - 任务列表

Returns:

Task