com.seeyon.apps.taskmanage.api

接口 TaskmanageApi

所有已知实现类:

AbstractTaskmanageApi

public interface TaskmanageApi

任务接口

方法概要

限定符和类型	方法和说明
Boolean	canViewTask(Long taskId) 判断是否有查看任务权限 正常： 1、输入任务taskId，人员Id（有查看权限人员id），返回true。
int	countTaskSource(int sourceType, Long sourceId, Long sourceRecordId, Integer status) 用于计算指定任务来源的数量 用于计划、流程表单触发、无流程表单联动、会议 正常： 1、传入正确的来源sourceType（有流程表单）、sourceId（协同ID）、sourceRecordId（重复表ID），返回该重复行对应生成的1条任务 2、传入正确的来源sourceType（无流程表单）、sourceId（表单数据ID）、status（未完成）（有未完成状态的任务），返回该表单数据生成的所有未完成状态的任务集合 3、传入正确的来源sourceType（计划），有任务数据，返回所有由计划产生的任务数据集合 4、传入正确的来源sourceType（如会议），无任务数据，返回为空 异常： 1、来源sourceType传入null，抛异常；
Map<Long,Long>	countTaskSources(int sourceType, List<Long> sourceIds, Integer status) 用于计算一组指定任务来源的数量 主要用于会议列表上显示任务数量 正常： 1、传入正确的来源sourceType（会议），sourceIds（会议列表ID），有任务数据，返回会议ID，及会议对应的任务数 2、传入正确的来源sourceType（会议），无任务数据，返回为空 异常： 1、来源sourceType为null，抛出异常
boolean	deleteTaskInfoBySourceRecordId(Long recordId) 根据任务的来源ID删除任务 主要用在删除表单无流程数据时，删除对应的任务。
List<Map<String,Object>>	findArrangeTaskByMembers(Date startDate, Date endDate, List<Long> memberIds, List<TaskStatus> states) 安排给他人的任务(当前登录人员创建的任务) 正常: 1、传入正确的人员id、状态、开始时间小于结束时间且时间段内有任务，返回会议列表 2、传入正确的人员id、状态、开始时间小于结束时间且时间段内无任务，返回空会议列表（返回size=0的list实体） 异常: 3、所有参数传入null，抛异常
List<Map<String,Object>>	findOtherTaskByMembers(List<Long> memberIds, Date startDate, Date endDate, List<TaskStatus> states) 获取当前登录人员参与的他人任务(负责人是memberIds的人员,当前登录人员是4个角色中任意一个) 正常: 1、传入正确的人员id、状态、开始时间小于结束时间且时间段内有任务，返回会议列表 2、传入正确的人员id、状态、开始时间小于结束时间且时间段内无任务，返回空会议列表（返回size=0的list实体） 异常: 3、所有参数传入null，抛异常
List<Map<String,Object>>	findTaskByMembers(List<Long> memberId, Date beginDate, Date endDate, List<TaskStatus> status) 获取人员参与的任务(负责人,参与人,告知人任意一种角色) 正常: 1、传入正确的人员id、开始结束时间（时间段内有任务），返回事件段内的任务列表 2、传入正确的人员id、开始结束时间（时间段内没有任务），返回空 异常: 3、所有参数传入null，抛异常
List<TaskInfoBO>	findTaskInfos(Long memberId, Date beginDate, Date endDate, List<TaskStatus> status) 获取人员在某个时间段的任务 正常: 1、传入正确的人员id、开始结束时间（时间段内有任务），返回事件段内的任务列表 2、传入正确的人员id、开始结束时间（时间段内没有任务），返回空 异常: 3、所有参数传入null，抛异常
List<TaskInfo4SourceBO>	findTaskInfosBySourceId(Long sourceId) 根据来源ID获取来源转的任务(来源包括计划) 正常: 1、传入正确的计划id（计划转了任务），返回任务列表 2、传入正确的计划id（计划没有转任务），返回空
int	getChildTaskCount(List<Long> ids) 根据当前任务的id查询其子任务条数 正常: 1、传入正确的任务id，返回子任务条数 2、传入正确的任务id（没有子任务），返回子任务条数为零
TaskInfoBO	getTaskInfo(Long id) 获取任务 正常: 1、传入正确的任务id，能获取到任务的实体
com.seeyon.ctp.util.FlipInfo	getTaskListByListType(Map<String,Object> reqParams, String listType) 根据列表类型获取列表展示数据 正常: 1、传入正确的查询条件参数和列表类型，返回列表数据 异常: 2、所有参数传入null，抛异常

方法详细资料

getTaskInfo

TaskInfoBO getTaskInfo(Long id)
                throws com.seeyon.ctp.common.exceptions.BusinessException

获取任务
正常:
1、传入正确的任务id，能获取到任务的实体

参数:

id - 需要获取任务的id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTaskInfosBySourceId

List<TaskInfo4SourceBO> findTaskInfosBySourceId(Long sourceId)
                                         throws com.seeyon.ctp.common.exceptions.BusinessException

根据来源ID获取来源转的任务(来源包括计划)
正常:
1、传入正确的计划id（计划转了任务），返回任务列表
2、传入正确的计划id（计划没有转任务），返回空

参数:

sourceId - 源id，如：计划id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTaskInfos

List<TaskInfoBO> findTaskInfos(Long memberId,
                               Date beginDate,
                               Date endDate,
                               List<TaskStatus> status)
                        throws com.seeyon.ctp.common.exceptions.BusinessException

获取人员在某个时间段的任务
正常:
1、传入正确的人员id、开始结束时间（时间段内有任务），返回事件段内的任务列表
2、传入正确的人员id、开始结束时间（时间段内没有任务），返回空
异常:
3、所有参数传入null，抛异常

参数:

memberId - 人员id

beginDate - 开始时间

endDate - 结束时间

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTaskByMembers

List<Map<String,Object>> findTaskByMembers(List<Long> memberId,
                                           Date beginDate,
                                           Date endDate,
                                           List<TaskStatus> status)
                                    throws com.seeyon.ctp.common.exceptions.BusinessException

获取人员参与的任务(负责人,参与人,告知人任意一种角色)
正常:
1、传入正确的人员id、开始结束时间（时间段内有任务），返回事件段内的任务列表
2、传入正确的人员id、开始结束时间（时间段内没有任务），返回空
异常:
3、所有参数传入null，抛异常

参数:

memberId - 人员id

beginDate - 开始时间

endDate - 结束时间

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getChildTaskCount

int getChildTaskCount(List<Long> ids)
               throws com.seeyon.ctp.common.exceptions.BusinessException

根据当前任务的id查询其子任务条数 正常:
1、传入正确的任务id，返回子任务条数
2、传入正确的任务id（没有子任务），返回子任务条数为零

参数:

ids - 当前任务的id集合

返回:

子任务条数

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getTaskListByListType

com.seeyon.ctp.util.FlipInfo getTaskListByListType(Map<String,Object> reqParams,
                                                   String listType)
                                            throws com.seeyon.ctp.common.exceptions.BusinessException

根据列表类型获取列表展示数据 正常:
1、传入正确的查询条件参数和列表类型，返回列表数据
异常:
2、所有参数传入null，抛异常

参数:

reqParams - 条件参数

listType - 列表类型(目前只支持：Personal/Sent)

返回:

列表数据

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

canViewTask

Boolean canViewTask(Long taskId)
             throws com.seeyon.ctp.common.exceptions.BusinessException

判断是否有查看任务权限 正常：
1、输入任务taskId，人员Id（有查看权限人员id），返回true。
2、输入任务taskId，人员Id（无查看权限人员id），返回false。

参数:

taskId -

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

countTaskSource

int countTaskSource(int sourceType,
                    Long sourceId,
                    Long sourceRecordId,
                    Integer status)
             throws com.seeyon.ctp.common.exceptions.BusinessException

用于计算指定任务来源的数量
用于计划、流程表单触发、无流程表单联动、会议
正常：
1、传入正确的来源sourceType（有流程表单）、sourceId（协同ID）、sourceRecordId（重复表ID），返回该重复行对应生成的1条任务
2、传入正确的来源sourceType（无流程表单）、sourceId（表单数据ID）、status（未完成）（有未完成状态的任务），返回该表单数据生成的所有未完成状态的任务集合
3、传入正确的来源sourceType（计划），有任务数据，返回所有由计划产生的任务数据集合
4、传入正确的来源sourceType（如会议），无任务数据，返回为空
异常：
1、来源sourceType传入null，抛异常；

参数:

sourceType - 对应ApplicationCategoryEnum 不能为空

sourceId - 对应模块的实例对象（比如会议的ID） 可以为空

sourceRecordId - 对应模块的二级实例对象（比如表单计划下的表单重复表ID） 可以为空

status - 任务状态枚举 为空则取全部 详见TaskConstants.TaskStatusCondition(全部=-1,未完成=-2,进行中=2,未开始=1,已超期=6,已完成=4,已取消=5) example: 需求一,获取会议下的任务总数： countTaskSource(ApplicationCategoryEnum.meeting.getkey,会议ID,null,null); 需求二,获取会议下的超期任务数： countTaskSource(ApplicationCategoryEnum.meeting.getkey,会议ID,null,6);

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

从以下版本开始:

6.1

countTaskSources

Map<Long,Long> countTaskSources(int sourceType,
                                List<Long> sourceIds,
                                Integer status)
                         throws com.seeyon.ctp.common.exceptions.BusinessException

用于计算一组指定任务来源的数量
主要用于会议列表上显示任务数量
正常：
1、传入正确的来源sourceType（会议），sourceIds（会议列表ID），有任务数据，返回会议ID，及会议对应的任务数
2、传入正确的来源sourceType（会议），无任务数据，返回为空
异常：
1、来源sourceType为null，抛出异常

参数:

sourceType - 对应ApplicationCategoryEnum 不能为空

sourceIds - 对应模块的实例对象集合（比如会议列表的ID） 可以为空

status - 任务状态枚举 为空则取全部 详见TaskConstants.TaskStatusCondition(全部=-1,未完成=-2,进行中=2,未开始=1,已超期=6,已完成=4,已取消=5) example: 需求一,获取第一页20条会议下每个会议的对应任务总数： countTaskSource(ApplicationCategoryEnum.meeting.getkey,会议ID集合,null,null);

返回:

<会议ID,会议对应任务的数量>

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

从以下版本开始:

6.1

deleteTaskInfoBySourceRecordId

boolean deleteTaskInfoBySourceRecordId(Long recordId)
                                throws com.seeyon.ctp.common.exceptions.BusinessException

根据任务的来源ID删除任务 主要用在删除表单无流程数据时，删除对应的任务。这里提供给关联任务删除表单是删除联动创建的任务。不需要判断是否有删除任务权限。
正常：
1、传入正确的表单数据id，成功删除对应任务成功

参数:

recordId - 表单数据id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findArrangeTaskByMembers

List<Map<String,Object>> findArrangeTaskByMembers(Date startDate,
                                                  Date endDate,
                                                  List<Long> memberIds,
                                                  List<TaskStatus> states)

安排给他人的任务(当前登录人员创建的任务)
正常:
1、传入正确的人员id、状态、开始时间小于结束时间且时间段内有任务，返回会议列表
2、传入正确的人员id、状态、开始时间小于结束时间且时间段内无任务，返回空会议列表（返回size=0的list实体）
异常:
3、所有参数传入null，抛异常

参数:

memberIds - 人员id集合

beginDate - 开始时间

endDate - 结束时间

states - 状态 (TaskStatus)

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findOtherTaskByMembers

List<Map<String,Object>> findOtherTaskByMembers(List<Long> memberIds,
                                                Date startDate,
                                                Date endDate,
                                                List<TaskStatus> states)

获取当前登录人员参与的他人任务(负责人是memberIds的人员,当前登录人员是4个角色中任意一个)
正常:
1、传入正确的人员id、状态、开始时间小于结束时间且时间段内有任务，返回会议列表
2、传入正确的人员id、状态、开始时间小于结束时间且时间段内无任务，返回空会议列表（返回size=0的list实体）
异常:
3、所有参数传入null，抛异常

参数:

memberIds - 人员id集合

beginDate - 开始时间

endDate - 结束时间

states - 状态 (TaskStatus)

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException