com.seeyon.apps.meeting.api

接口 MeetingApi

所有已知实现类:

AbstractMeetingApi

public interface MeetingApi

版本:

创建时间：2015-7-7 上午10:14:20

作者:

muj E-mail:muj@seeyon.com

方法概要

限定符和类型	方法和说明
void	deleteTemplate(Long userId, Long templateId) 删除会议模版 正常: 1、传入正确的人员id和该人员的会议模板id，删除模板 异常: 2、传入传入正确的人员id和非该人员的会议模板id，不能删除模板，抛异常 3、所有参数传入null，抛异常
List<Map<String,Object>>	findArrangeMeetingByMembers(List<Long> memberIds, Date beginDate, Date endDate, List<Integer> meetingStateList) 安排给他人的会议,memberId所创建的但是不参与的会议 正常: 1、传入正确的人员id、状态、开始时间小于结束时间且时间段内有会议，返回会议列表 2、传入正确的人员id、状态、开始时间小于结束时间且时间段内无会议，返回空会议列表（返回size=0的list实体） 异常: 3、所有参数传入null，抛异常
List<MeetingBO>	findMeetings(com.seeyon.ctp.common.constants.ApplicationCategoryEnum category, Map<String,Object> param) 查找一个人一段时间某些回复状态的会议，主要 用于日程。
List<Map<String,Object>>	findMeetingsByMembers(Date startDate, Date endDate, List<Long> memberIds, List<Integer> status) 获取人员参与的会议(我是主持人,记录人,与会人任意一种角色) 正常: 1、传入正确的人员id、开始时间小于结束时间且时间段内有计划，返回计划列表 2、传入正确的人员id、开始时间小于结束时间且时间段内无计划，返回空计划列表（返回size=0的list实体） O 异常: 3、所有参数传入null，抛异常
Map<String,List<Long>>	findMtReplyUsers(Long meetingId) 参会人员列表 正常: 1、传入正确的会议id，获取会议参会人员列表
List<Map<String,Object>>	findOtherMeetingsByMembers(Date startDate, Date endDate, List<Long> memberIds, List<Integer> mtStates) 获取他人参与或者待定的会议 正常: 1、传入正确的人员id、状态、开始时间小于结束时间且时间段内有会议，返回会议列表 2、传入正确的人员id、状态、开始时间小于结束时间且时间段内无会议，返回空会议列表（返回size=0的list实体） 异常: 3、所有参数传入null，抛异常
List<MeetingBO>	findPendingMeetings(com.seeyon.ctp.util.FlipInfo fi, Map<String,Object> params) 根据指定时间段，模块app[ApplicationCategoryEnum的key]，查询人员memberId的待办代开会议 正常: 1、所有参数传入正确值，获取人员的待开会议列表
List<MtReplyBO>	findReplyByMeetingIdAndUserId(Long meetingId, Long userId) 根据当前会议Id、用户id查询回执信息 正常: 1、所有参数传入正确值且该人员在会议中有回执内容，返回该人员的回执列表 2、所有参数传入正确值且该人员在会议中没有回执内容，返回空列表 异常: 3、所有参数传入null，抛异常
List<MtReplyBO>	findReplyList(Long meetingId) 会议回复列表 正常: 1、传入正确的会议id且会议有回复，获取会议回复列表 2、传入正确的会议id且会议没有回复，返回空列表
List<MtTemplateBO>	findTemplates(Long userId) 获取用户所有的会议模版列表 正常: 1、传入正确的用户id，返回该人员全部会议模板列表 2、传入正确的用户id且该人员没有会议模板，返回空列表
MeetingBO	getMeeting(Long id) 获取会议 正常: 1、传入正确的会议id，获取会议实体
MeetingBO	getMeetingByAffairId(Long affairId, Long userId) 根据affairId 获取会议BO 正常: 1、传入正确的affairId和人员id，获取会议实体
MeetingBO	getMeetingByAffairId(Long affairId, Long userId, Long meetingId, String openFrom)
List<MeetingBO>	getMeetings(List<Long> ids)
Map<Long,MeetingBO>	getMeetingsMap(List<Long> ids)
MtSummaryBO	getMtSummary(Long id) 获取会议纪要内容 正常: 1、传入正确的有会议纪要id，返回会议纪要实体 2、传入正确的没有会议纪要的会议纪要id，返null
int	getPortleMeetingDataCount() 获取待开会议列表角标数量
int	getProcessedNumberByObjectId(Long objectId) 根据objectId查询 会议 已处理人数 从协同模块迁移的代码 正常: 1、传入正确的对象id，获取会议已处理人数
MtTemplateBO	getTemplate(Long templateId) 获取单条会议模版 正常: 1、传入正确的模板id，返回模板实体 2、传入已经删除的模板id，返回空 异常: 3、传入错误的模板id，返回空
int	getTotalNumberByObjectId(Long objectId) 根据objectId查询 会议 总人数 从协同模块迁移的代码 正常: 1、传入正确的对象id，获取会议总人数
void	repairMeeting(Long meetingId)
void	replayMeeting(Long userId, Long affairId, String feedbackContent, MeetingEnums.MeetingFeedbackFlagEnum feedbackFlag, List<com.seeyon.ctp.common.po.filemanager.Attachment> atts) 处理会议 正常: 1、回执状态为参加、其他参数正确，能成功回执会议 2、回执状态为不参加、其他参数正确，能成功回执会议 3、回执状态为待定、其他参数正确，能成功回执会议 4、当前人员为代理人，回执状态为参加，其他参数正确，能成功回执会议 异常: 5、所有参数传入null，抛异常
void	updateTemplate(Long userId, Long templateId, Map<String,Object> columns) 更新模板信息 正常: 1、所有参数传入正确值，成功更新模板信息 异常: 2、所有参数传入null，抛异常

方法详细资料

replayMeeting

void replayMeeting(Long userId,
                   Long affairId,
                   String feedbackContent,
                   MeetingEnums.MeetingFeedbackFlagEnum feedbackFlag,
                   List<com.seeyon.ctp.common.po.filemanager.Attachment> atts)
            throws com.seeyon.ctp.common.exceptions.BusinessException

处理会议 正常:
1、回执状态为参加、其他参数正确，能成功回执会议
2、回执状态为不参加、其他参数正确，能成功回执会议
3、回执状态为待定、其他参数正确，能成功回执会议
4、当前人员为代理人，回执状态为参加，其他参数正确，能成功回执会议
异常:
5、所有参数传入null，抛异常

参数:

userId - 当前用户Id

affairId - 待办事项ID

feedbackContent - 回执的内容

feedbackFlag - 回执状态（即参加、不参加、待定）

atts - 附件列表

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findReplyByMeetingIdAndUserId

List<MtReplyBO> findReplyByMeetingIdAndUserId(Long meetingId,
                                              Long userId)
                                       throws com.seeyon.ctp.common.exceptions.BusinessException

根据当前会议Id、用户id查询回执信息 正常:
1、所有参数传入正确值且该人员在会议中有回执内容，返回该人员的回执列表
2、所有参数传入正确值且该人员在会议中没有回执内容，返回空列表 异常:
3、所有参数传入null，抛异常

参数:

meetingId -

userId -

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findMeetings

List<MeetingBO> findMeetings(com.seeyon.ctp.common.constants.ApplicationCategoryEnum category,
                             Map<String,Object> param)
                      throws com.seeyon.ctp.common.exceptions.BusinessException

查找一个人一段时间某些回复状态的会议，主要 用于日程。 正常:
1、传入正确的查询参数（查询回复状态为参加、其他查询参数正确），查询出该人员时间段参加的会议列表
2、传入正确的查询参数（查询回复状态为待定、其他查询参数正确），查询出该人员时间段待定的会议列表
3、传入正确的查询参数（查询回复状态为不参加、其他查询参数正确），查询出该人员时间段不参加的会议列表
异常:
4、所有参数传入null，抛异常

参数:

param - 查询参数，可以包含以下4个key值 key - replystateList value - List 具体存放的是SubStateEnum的Key值 ，例如：SubStateEnum.meeting_pending_join.key() key - beginDate value - Date类型 key - endDate value - Date类型 key - memberId value - Long类型 key - mtStates value -List 具体存放的是MeetingStateEnum的Key值 ，例如：MeetingStateEnum.start.key()

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findMeetingsByMembers

List<Map<String,Object>> findMeetingsByMembers(Date startDate,
                                               Date endDate,
                                               List<Long> memberIds,
                                               List<Integer> status)
                                        throws com.seeyon.ctp.common.exceptions.BusinessException

获取人员参与的会议(我是主持人,记录人,与会人任意一种角色)
正常:
1、传入正确的人员id、开始时间小于结束时间且时间段内有计划，返回计划列表
2、传入正确的人员id、开始时间小于结束时间且时间段内无计划，返回空计划列表（返回size=0的list实体）
O 异常:
3、所有参数传入null，抛异常

参数:

memberIds - 人员id

beginDate - 开始时间

endDate - 结束时间

states - 会议的状态(30,31,10,20 com.seeyon.apps.meeting.constants.MeetingConstant.MeetingStateEnum)

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getMeeting

MeetingBO getMeeting(Long id)
              throws com.seeyon.ctp.common.exceptions.BusinessException

获取会议 正常:
1、传入正确的会议id，获取会议实体

参数:

id - 会议Id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getMeetingByAffairId

MeetingBO getMeetingByAffairId(Long affairId,
                               Long userId)
                        throws com.seeyon.ctp.common.exceptions.BusinessException

根据affairId 获取会议BO 正常:
1、传入正确的affairId和人员id，获取会议实体

参数:

affairId -

userId - 当前登录用户Id, 用于设置代理信息

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getMeetingByAffairId

MeetingBO getMeetingByAffairId(Long affairId,
                               Long userId,
                               Long meetingId,
                               String openFrom)
                        throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getMtSummary

MtSummaryBO getMtSummary(Long id)
                  throws com.seeyon.ctp.common.exceptions.BusinessException

获取会议纪要内容 正常:
1、传入正确的有会议纪要id，返回会议纪要实体
2、传入正确的没有会议纪要的会议纪要id，返null

参数:

id -

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findTemplates

List<MtTemplateBO> findTemplates(Long userId)
                          throws com.seeyon.ctp.common.exceptions.BusinessException

获取用户所有的会议模版列表 正常:
1、传入正确的用户id，返回该人员全部会议模板列表
2、传入正确的用户id且该人员没有会议模板，返回空列表

参数:

userId - 用户ID

返回:

返回个人全部会议模版，如果没有找到记录，返回空的列表

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getTemplate

MtTemplateBO getTemplate(Long templateId)
                  throws com.seeyon.ctp.common.exceptions.BusinessException

获取单条会议模版 正常:
1、传入正确的模板id，返回模板实体
2、传入已经删除的模板id，返回空
异常:
3、传入错误的模板id，返回空

参数:

templateId - 模版ID

返回:

如果没有找到记录，返回null

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

deleteTemplate

void deleteTemplate(Long userId,
                    Long templateId)
             throws com.seeyon.ctp.common.exceptions.BusinessException

删除会议模版 正常:
1、传入正确的人员id和该人员的会议模板id，删除模板
异常:
2、传入传入正确的人员id和非该人员的会议模板id，不能删除模板，抛异常
3、所有参数传入null，抛异常

参数:

userId - 删除模板人

templateId - 模板ID

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

updateTemplate

void updateTemplate(Long userId,
                    Long templateId,
                    Map<String,Object> columns)
             throws com.seeyon.ctp.common.exceptions.BusinessException

更新模板信息 正常:
1、所有参数传入正确值，成功更新模板信息
异常:
2、所有参数传入null，抛异常

参数:

userId - 修改人ID

templateId - 模版ID

columns - 修改属性

 /------ key -----|--- 类型---|-----说明------/
 |   title        |   string  |   会议标题          |
 |   templateName |   string  |   模版名称          |
 

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getProcessedNumberByObjectId

int getProcessedNumberByObjectId(Long objectId)
                          throws com.seeyon.ctp.common.exceptions.BusinessException

根据objectId查询 会议 已处理人数 从协同模块迁移的代码 正常:
1、传入正确的对象id，获取会议已处理人数

参数:

objectId -

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getTotalNumberByObjectId

int getTotalNumberByObjectId(Long objectId)
                      throws com.seeyon.ctp.common.exceptions.BusinessException

根据objectId查询 会议 总人数 从协同模块迁移的代码 正常:
1、传入正确的对象id，获取会议总人数

参数:

objectId -

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findReplyList

List<MtReplyBO> findReplyList(Long meetingId)
                       throws com.seeyon.ctp.common.exceptions.BusinessException

会议回复列表 正常:
1、传入正确的会议id且会议有回复，获取会议回复列表
2、传入正确的会议id且会议没有回复，返回空列表

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findMtReplyUsers

Map<String,List<Long>> findMtReplyUsers(Long meetingId)
                                 throws com.seeyon.ctp.common.exceptions.BusinessException

参会人员列表 正常:
1、传入正确的会议id，获取会议参会人员列表

返回:

returenMap.get("join") 参加 returenMap.get("noJoin") 不参加 returenMap.get("pending") 待定 returenMap.get("noFeedback") 未回执

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findPendingMeetings

List<MeetingBO> findPendingMeetings(com.seeyon.ctp.util.FlipInfo fi,
                                    Map<String,Object> params)
                             throws com.seeyon.ctp.common.exceptions.BusinessException

根据指定时间段，模块app[ApplicationCategoryEnum的key]，查询人员memberId的待办代开会议 正常:
1、所有参数传入正确值，获取人员的待开会议列表

参数:

params - 查询参数 *

 /------ key -----|--- 类型---|-----说明------/
 |   memberId   |   long |  人员Id                                                                |
 

fi -

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findArrangeMeetingByMembers

List<Map<String,Object>> findArrangeMeetingByMembers(List<Long> memberIds,
                                                     Date beginDate,
                                                     Date endDate,
                                                     List<Integer> meetingStateList)
                                              throws com.seeyon.ctp.common.exceptions.BusinessException

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

参数:

memberIds - 人员id集合

beginDate - 开始时间

endDate - 结束时间

meetingStateList - 状态 (10, 20, 30, 31 ArrangeTimeStatus.getMeetingStatus 方法)

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findOtherMeetingsByMembers

List<Map<String,Object>> findOtherMeetingsByMembers(Date startDate,
                                                    Date endDate,
                                                    List<Long> memberIds,
                                                    List<Integer> mtStates)

获取他人参与或者待定的会议
正常:
1、传入正确的人员id、状态、开始时间小于结束时间且时间段内有会议，返回会议列表
2、传入正确的人员id、状态、开始时间小于结束时间且时间段内无会议，返回空会议列表（返回size=0的list实体）
异常:
3、所有参数传入null，抛异常

参数:

memberIds - 人员id集合

beginDate - 开始时间

endDate - 结束时间

states - 状态 (10, 20, 30, 31 ArrangeTimeStatus.getMeetingStatus 方法)

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getMeetings

List<MeetingBO> getMeetings(List<Long> ids)
                     throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getMeetingsMap

Map<Long,MeetingBO> getMeetingsMap(List<Long> ids)
                            throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

repairMeeting

void repairMeeting(Long meetingId)
            throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getPortleMeetingDataCount

int getPortleMeetingDataCount()

获取待开会议列表角标数量

返回: