Package net.risesoft.api

Class TaskApiImpl

java.lang.Object

net.risesoft.api.TaskApiImpl

All Implemented Interfaces:

TaskApi

@RestController
@RequestMapping(value="/services/rest/task",
                produces="application/json")
public class TaskApiImpl
extends Object
implements TaskApi

正在运行任务相关接口

Author:

qinman, zhangchongjie

Date:

2022/12/30

Constructor Summary

Constructors

Constructor	Description
TaskApiImpl()

Method Summary

Modifier and Type	Method	Description
net.risesoft.pojo.Y9Result<Object>	claim(String tenantId, String userId, String taskId)	签收任务
net.risesoft.pojo.Y9Result<Object>	complete(String tenantId, String taskId)	完成任务（不设置流程变量）
net.risesoft.pojo.Y9Result<Object>	completeTask(String tenantId, String taskId)	完成按钮的任务完结
net.risesoft.pojo.Y9Result<Object>	completeTaskWithoutAssignee(String tenantId, String orgUnitId, String processInstanceId)	完成按钮的任务完结（相关参与人员的人任务办结）
net.risesoft.pojo.Y9Result<Object>	completeWithVariables(String tenantId, String taskId, String orgUnitId, Map<String,Object> vars)	完成任务（设置流程变量）
net.risesoft.pojo.Y9Result<Object>	createWithVariables(String tenantId, String orgUnitId, String routeToTaskId, Map<String,Object> vars, List<String> orgUnitIdList)	创建变量
net.risesoft.pojo.Y9Result<Object>	delegateTask(String tenantId, String taskId, String assignee)	设置任务代理
net.risesoft.pojo.Y9Result<Object>	deleteCandidateUser(String tenantId, String taskId, String assignee)	删除任务的候选人
net.risesoft.pojo.Y9Result<List<TaskModel>>	findAll(String tenantId)	查找所有的任务实例
net.risesoft.pojo.Y9Result<TaskModel>	findById(String tenantId, String taskId)	根据任务id查找任务
net.risesoft.pojo.Y9Result<List<TaskModel>>	findByProcessInstanceId(String tenantId, String processInstanceId)	根据流程实例Id查找任务
net.risesoft.pojo.Y9Result<List<TaskModel>>	findByProcessInstanceId(String tenantId, String processInstanceId, boolean active)	根据流程实例Id和是否激活状态查找任务
net.risesoft.pojo.Y9Page<TaskModel>	findListByProcessInstanceId(String tenantId, String processInstanceId, Integer page, Integer rows)	根据流程实例id获取用户的待办任务(分页)
net.risesoft.pojo.Y9Result<Object>	saveTask(String tenantId, TaskModel taskModel)	保存任务
net.risesoft.pojo.Y9Result<Object>	setAssignee(String tenantId, String taskId, String assignee)	设置任务委托人
net.risesoft.pojo.Y9Result<Object>	setDueDate(String tenantId, String taskId, Date date)	设置任务的过期时间
net.risesoft.pojo.Y9Result<Object>	setPriority(String tenantId, String taskId, Integer priority)	设置任务的优先级
net.risesoft.pojo.Y9Result<Object>	unClaim(String tenantId, String taskId)	撤销签收任务

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TaskApiImpl

public TaskApiImpl()

Method Detail

claim

public net.risesoft.pojo.Y9Result<Object> claim(@RequestParam
                                                String tenantId,
                                                @RequestParam
                                                String userId,
                                                @RequestParam
                                                String taskId)

签收任务

Specified by:

claim in interface TaskApi

Parameters:

tenantId - 租户id

userId - 人员、岗位id

taskId - 任务id

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

complete

public net.risesoft.pojo.Y9Result<Object> complete(@RequestParam
                                                   String tenantId,
                                                   @RequestParam
                                                   String taskId)

完成任务（不设置流程变量）

Specified by:

complete in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

completeTask

public net.risesoft.pojo.Y9Result<Object> completeTask(@RequestParam
                                                       String tenantId,
                                                       @RequestParam
                                                       String taskId)

完成按钮的任务完结

Specified by:

completeTask in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

completeTaskWithoutAssignee

public net.risesoft.pojo.Y9Result<Object> completeTaskWithoutAssignee(@RequestParam
                                                                      String tenantId,
                                                                      @RequestParam
                                                                      String orgUnitId,
                                                                      @RequestParam
                                                                      String processInstanceId)

完成按钮的任务完结（相关参与人员的人任务办结）

Specified by:

completeTaskWithoutAssignee in interface TaskApi

Parameters:

tenantId - 租户id

orgUnitId - 人员、岗位Id

processInstanceId - 流程实例id

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

completeWithVariables

public net.risesoft.pojo.Y9Result<Object> completeWithVariables(@RequestParam
                                                                String tenantId,
                                                                @RequestParam
                                                                String taskId,
                                                                @RequestParam
                                                                String orgUnitId,
                                                                @RequestBody
                                                                Map<String,Object> vars)

完成任务（设置流程变量）

Specified by:

completeWithVariables in interface TaskApi

Parameters:

tenantId - 租户id

orgUnitId - 人员、岗位Id

taskId - 任务id

vars - 变量map

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

createWithVariables

public net.risesoft.pojo.Y9Result<Object> createWithVariables(@RequestParam
                                                              String tenantId,
                                                              @RequestParam
                                                              String orgUnitId,
                                                              @RequestParam
                                                              String routeToTaskId,
                                                              Map<String,Object> vars,
                                                              @RequestBody
                                                              List<String> orgUnitIdList)

创建变量

Specified by:

createWithVariables in interface TaskApi

Parameters:

tenantId - 租户id

orgUnitId - 人员、岗位Id

routeToTaskId - 任务id

vars - 变量map

orgUnitIdList - 人员、岗位ids

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

delegateTask

public net.risesoft.pojo.Y9Result<Object> delegateTask(@RequestParam
                                                       String tenantId,
                                                       @RequestParam
                                                       String taskId,
                                                       @RequestParam
                                                       String assignee)

设置任务代理

Specified by:

delegateTask in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

assignee - 受让人

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

deleteCandidateUser

public net.risesoft.pojo.Y9Result<Object> deleteCandidateUser(@RequestParam
                                                              String tenantId,
                                                              @RequestParam
                                                              String taskId,
                                                              @RequestParam
                                                              String assignee)

删除任务的候选人

Specified by:

deleteCandidateUser in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

assignee - 受让人

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

findAll

public net.risesoft.pojo.Y9Result<List<TaskModel>> findAll(@RequestParam
                                                           String tenantId)

查找所有的任务实例

Specified by:

findAll in interface TaskApi

Parameters:

tenantId - 租户id

Returns:

Y9Result<List<TaskModel>> 通用请求返回对象 - data 任务列表

Since:

9.6.6

findById

public net.risesoft.pojo.Y9Result<TaskModel> findById(@RequestParam
                                                      String tenantId,
                                                      @RequestParam
                                                      String taskId)

根据任务id查找任务

Specified by:

findById in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

Returns:

Y9Result<TaskModel> 通用请求返回对象 - data 任务信息

Since:

9.6.6

findByProcessInstanceId

public net.risesoft.pojo.Y9Result<List<TaskModel>> findByProcessInstanceId(@RequestParam
                                                                           String tenantId,
                                                                           @RequestParam
                                                                           String processInstanceId)

根据流程实例Id查找任务

Specified by:

findByProcessInstanceId in interface TaskApi

Parameters:

tenantId - 租户id

processInstanceId - 流程实例id

Returns:

Y9Result<List<TaskModel>> 通用请求返回对象 - data 任务列表

Since:

9.6.6

findByProcessInstanceId

public net.risesoft.pojo.Y9Result<List<TaskModel>> findByProcessInstanceId(@RequestParam
                                                                           String tenantId,
                                                                           @RequestParam
                                                                           String processInstanceId,
                                                                           @RequestParam
                                                                           boolean active)

根据流程实例Id和是否激活状态查找任务

Specified by:

findByProcessInstanceId in interface TaskApi

Parameters:

tenantId - 租户id

processInstanceId - 流程实例Id

active - 是否存活

Returns:

Y9Result<List<TaskModel>> 通用请求返回对象 - data 任务列表

Since:

9.6.6

findListByProcessInstanceId

public net.risesoft.pojo.Y9Page<TaskModel> findListByProcessInstanceId(@RequestParam
                                                                       String tenantId,
                                                                       @RequestParam
                                                                       String processInstanceId,
                                                                       @RequestParam
                                                                       Integer page,
                                                                       @RequestParam
                                                                       Integer rows)

根据流程实例id获取用户的待办任务(分页)

Specified by:

findListByProcessInstanceId in interface TaskApi

Parameters:

tenantId - 租户Id

processInstanceId - 流程实例Id

page - 页码

rows - 行数

Returns:

Y9Page<TaskModel> 通用分页请求返回对象 - rows 是待办任务

Since:

9.6.6

saveTask

public net.risesoft.pojo.Y9Result<Object> saveTask(@RequestParam
                                                   String tenantId,
                                                   @RequestBody
                                                   TaskModel taskModel)

保存任务

Specified by:

saveTask in interface TaskApi

Parameters:

tenantId - 租户id

taskModel - 任务实体

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

setAssignee

public net.risesoft.pojo.Y9Result<Object> setAssignee(@RequestParam
                                                      String tenantId,
                                                      @RequestParam
                                                      String taskId,
                                                      @RequestParam
                                                      String assignee)

设置任务委托人

Specified by:

setAssignee in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

assignee - 受让人

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

setDueDate

public net.risesoft.pojo.Y9Result<Object> setDueDate(@RequestParam
                                                     String tenantId,
                                                     @RequestParam
                                                     String taskId,
                                                     @RequestParam
                                                     Date date)

设置任务的过期时间

Specified by:

setDueDate in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

date - 日期

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

setPriority

public net.risesoft.pojo.Y9Result<Object> setPriority(@RequestParam
                                                      String tenantId,
                                                      @RequestParam
                                                      String taskId,
                                                      @RequestParam
                                                      Integer priority)

设置任务的优先级

Specified by:

setPriority in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

priority - 优先级

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6

unClaim

public net.risesoft.pojo.Y9Result<Object> unClaim(@RequestParam
                                                  String tenantId,
                                                  @RequestParam
                                                  String taskId)

撤销签收任务

Specified by:

unClaim in interface TaskApi

Parameters:

tenantId - 租户id

taskId - 任务id

Returns:

Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功

Since:

9.6.6