com.seeyon.apps.taskmanage.api

接口 TaskmanageApi

所有已知实现类:

AbstractTaskmanageApi

public interface TaskmanageApi

任务接口

Plugin:taskmanage

方法概要

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

方法详细资料

getTaskInfo

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

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

参数:

id - 需要获取任务的id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTaskInfosBySourceId

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

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

参数:

sourceId - 源id，如：计划id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTaskBoBySourceId

java.util.List<TaskInfoBO> findTaskBoBySourceId(java.lang.Long sourceId)
                                         throws com.seeyon.ctp.common.exceptions.BusinessException

根据来源id查询任务

参数:

sourceId -

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTaskInfos

java.util.List<TaskInfoBO> findTaskInfos(java.lang.Long memberId,
                                         java.util.Date beginDate,
                                         java.util.Date endDate,
                                         java.util.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

java.util.List<java.util.Map<java.lang.String,java.lang.Object>> findTaskByMembers(java.util.List<java.lang.Long> memberId,
                                                                                   java.util.Date beginDate,
                                                                                   java.util.Date endDate,
                                                                                   java.util.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(java.util.List<java.lang.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(java.util.Map<java.lang.String,java.lang.Object> reqParams,
                                                   java.lang.String listType)
                                            throws com.seeyon.ctp.common.exceptions.BusinessException

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

参数:

reqParams - 条件参数

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

返回:

列表数据

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

canViewTask

java.lang.Boolean canViewTask(java.lang.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

canEditTask

java.lang.Boolean canEditTask(java.lang.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

getPortleTaskDataCount

int getPortleTaskDataCount()
                    throws com.seeyon.ctp.common.exceptions.BusinessException

查询未完成的任务管理的角标数

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

countTaskSource

int countTaskSource(int sourceType,
                    java.lang.Long sourceId,
                    java.lang.Long sourceRecordId,
                    java.lang.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

countTaskSource

java.util.Map<java.lang.String,java.lang.Integer> countTaskSource(int sourceType,
                                                                  java.lang.Long sourceId)

用于计算指定任务来源的数量
正常：
1、传入正确的来源sourceType（有流程表单）、sourceId（协同ID）
2、传入正确的来源sourceType（无流程表单）、sourceId（表单数据ID）
3、传入正确的来源sourceType（计划），有任务数据，返回所有由计划产生的任务数据集合
4、传入正确的来源sourceType（如会议），无任务数据，返回为空
异常：
1、来源sourceType传入null，抛异常；

参数:

sourceType - 对应ApplicationCategoryEnum 不能为空

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

返回:

从以下版本开始:

6.1

countTaskSources

java.util.Map<java.lang.Long,java.lang.Long> countTaskSources(int sourceType,
                                                              java.util.List<java.lang.Long> sourceIds,
                                                              java.lang.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(java.lang.Long recordId)
                                throws com.seeyon.ctp.common.exceptions.BusinessException

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

参数:

recordId - 表单数据id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findArrangeTaskByMembers

java.util.List<java.util.Map<java.lang.String,java.lang.Object>> findArrangeTaskByMembers(java.util.Date startDate,
                                                                                          java.util.Date endDate,
                                                                                          java.util.List<java.lang.Long> memberIds,
                                                                                          java.util.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

java.util.List<java.util.Map<java.lang.String,java.lang.Object>> findOtherTaskByMembers(java.util.List<java.lang.Long> memberIds,
                                                                                        java.util.Date startDate,
                                                                                        java.util.Date endDate,
                                                                                        java.util.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

findTasks4XiaoZhi

java.util.List<TaskInfoBO> findTasks4XiaoZhi(com.seeyon.ctp.util.FlipInfo flipInfo,
                                             java.util.Map<java.lang.String,java.lang.Object> params,
                                             java.util.List<java.lang.Integer> statusList)
                                      throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

hasTasksInProject

java.lang.Boolean hasTasksInProject(java.lang.Long projectId)
                             throws com.seeyon.ctp.common.exceptions.BusinessException

判断项目下是否有任务

参数:

-

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTasks

java.util.Map<java.lang.String,java.lang.Object> findTasks(java.util.Map<java.lang.String,java.lang.Object> params)
                                                    throws com.seeyon.ctp.common.exceptions.BusinessException

获取任务

参数:

params - 参数名 参数类型 是否必填 说明 listType String Y com.seeyon.apps.taskmanage.TaskConstants.TaskListType 枚举 status String Y all（全部）/unfinished（未完成）/overdue（已超期）/weekunfinished（本周未完成） 状态 auditStatus String N all（全部）/0待审核/1审核通过/2审核不通过 审核状态 pageNo int Y 页码 pageSize int Y 每页显示行数 meetingId String N listType为MeetingTask会议任务时,必须传递这个参数 groupId Long N listType为Group群空间任务时,必须传递这个参数 isManager boolean N listType为Group群空间任务时,必须传递这个参数,true-群主或者群管理员,false-普通成员

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

countTasks

java.util.Map<java.lang.String,java.lang.Object> countTasks(java.util.Map<java.lang.String,java.lang.Object> params)
                                                     throws com.seeyon.ctp.common.exceptions.BusinessException

未完成，已超期，任务总数计数

参数:

params - 参数名 参数类型 是否必填 说明 listType String Y com.seeyon.apps.taskmanage.TaskConstants.TaskListType 枚举 groupId Long N listType为Group群空间任务时,必须传递这个参数 isManager boolean N listType为Group群空间任务时,必须传递这个参数,true-群主或者群管理员,false-普通成员

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

createTask

com.seeyon.ctp.common.bo.Result createTask(java.util.Map<java.lang.String,java.lang.Object> map)
                                    throws com.seeyon.ctp.common.exceptions.BusinessException

新建任务

参数:

params - 参数名 参数类型 是否必填 说明 subject String Y 任务标题 content String N 任务描述 fulltime String N 是否为全天任务 1是 0 否 （全天任务计划开始、结束时间会格式格式是：yyyy-MM-dd 否则格式是： yyyy-MM-dd HH:mm） attachments String N 任务的附件格式（attachmentInputs:[Attachment]） plannedStartTime Long Y 计划开始时间 plannedEndTime Long Y 计划结束时间 milestone Integer N 里程碑(默认为否，可选{0:否,1:是}，如果是里程碑任务) remindstarttime int N 任务开始前提醒时间差 com.seeyon.apps.taskmanage.enums.RemindTimeEnums枚举中的分钟数 remindendtime int N 任务结束前提醒时间差 com.seeyon.apps.taskmanage.enums.RemindTimeEnums枚举中的分钟数 managers String Y 负责人 participators String N 参与人 inspectors String N 告知人 importantLevel Integer N 重要程度(默认为普通，可选{1:普通,2:重要,3:非常重要}) projectId Long N 项目id parent_task_id Long N 上级任务ID weight String N 权重（0~100） groupId Long N listType为Group群空间任务时,必须传递这个参数

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

updateTask

com.seeyon.ctp.common.bo.Result updateTask(java.lang.Long taskId,
                                           java.util.Map<java.lang.String,java.lang.Object> map)
                                    throws com.seeyon.ctp.common.exceptions.BusinessException

任务更新

参数:

params - 参数名 参数类型 是否必填 说明 subject String Y 任务标题 content String N 任务描述 fulltime String N 是否为全天任务 1是 0 否 （全天任务计划开始、结束时间会格式格式是：yyyy-MM-dd 否则格式是： yyyy-MM-dd HH:mm） attachments String N 任务的附件格式（attachmentInputs:[Attachment]） plannedStartTime Long Y 计划开始时间 plannedEndTime Long Y 计划结束时间 milestone Integer N 里程碑(默认为否，可选{0:否,1:是}，如果是里程碑任务) remindstarttime int N 任务开始前提醒时间差 com.seeyon.apps.taskmanage.enums.RemindTimeEnums枚举中的分钟数 remindendtime int N 任务结束前提醒时间差 com.seeyon.apps.taskmanage.enums.RemindTimeEnums枚举中的分钟数 managers String Y 负责人 participators String N 参与人 inspectors String N 告知人 importantLevel Integer N 重要程度(默认为普通，可选{1:普通,2:重要,3:非常重要}) projectId Long N 项目id parent_task_id Long N 上级任务ID weight String N 权重（0~100） groupId Long N listType为Group群空间任务时,必须传递这个参数

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

hasAudit

boolean hasAudit()
          throws com.seeyon.ctp.common.exceptions.BusinessException

根据当前登录人员的id和登录的单位id，判断该人员单位是否开启了任务审核

返回:

true 开启 false 未开启

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTasks4XiaoZhi

java.util.Map<java.lang.String,java.lang.Object> findTasks4XiaoZhi(java.util.Map<java.lang.String,java.lang.String> params)
                                                            throws com.seeyon.ctp.common.exceptions.BusinessException

用于小致语音搜索获取小致数据 Author： wujie

参数:

params - 任务数据的查询条件，可以进行多条件组合查询

     {
         status    状态  "未完成": "unfinished","已完成": "finished","过期的": "overdue",
         pageNo   页码
         pageSize       页数
         beginDate      任务开始时间 格式 时间戳
                   endDate      任务结束时间 格式 时间戳
                   createBeginTime  任务创建的开始时间 时间戳
                   createEndTime    任务创建的结束时间 时间戳
                   createUserId 任务发起人 格式 Member|123434
     }
 

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException