com.kdayun.wecom.controller

类 WecomOAController

java.lang.Object

com.kdayun.z1.core.base.BaseController

com.kdayun.wecom.controller.WecomContollerBase

com.kdayun.wecom.controller.WecomOAController

@Controller
 @RequestMapping(value="wecom/oa")
public class WecomOAController
extends WecomContollerBase

企业微信

作者:

gk

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	WecomOAController.ApprovalInfoParam
static class	WecomOAController.CheckinDataParam
static class	WecomOAController.CheckinOptionParam
static class	WecomOAController.CheckinParam
static class	WecomOAController.GetApprovalDetailParam
static class	WecomOAController.GetDialRecordParam
static class	WecomOAController.GetTemplateDetailParam

从类继承的嵌套类/接口 com.kdayun.wecom.controller.WecomContollerBase

WecomContollerBase.WecomParamBase

字段概要

字段

限定符和类型	字段和说明
(专用程序包) WecomService	wecomService

从类继承的字段 com.kdayun.z1.core.base.BaseController

DOWNLOAD_ID_COOKIE_EXPIRY, DOWNLOAD_ID_NAME

构造器概要

构造器

构造器和说明
WecomOAController()

方法概要

限定符和类型	方法和说明
RetVo	getApprovalDetail(WecomOAController.GetApprovalDetailParam param) 获取审批申请详情 企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。
RetVo	getApprovalInfo(WecomOAController.ApprovalInfoParam params) 批量获取审批单号 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
RetVo	getCheckinData(WecomOAController.CheckinParam param) 获取打卡数据 官方API:https://work.weixin.qq.com/api/doc#90000/90135/90262
RetVo	getCheckinDayData(WecomOAController.CheckinDataParam params) 获取打卡日报数据
RetVo	getCheckinMonthData(WecomOAController.CheckinDataParam params) 获取打卡月报数据
RetVo	getCheckinOption(WecomOAController.CheckinOptionParam param) 获取打卡规则 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
RetVo	getCheckinScheduleList(WecomOAController.CheckinDataParam params) 获取打卡人员排班信息
RetVo	getDialRecord(WecomOAController.GetDialRecordParam params) 获取公费电话拨打记录
RetVo	getTemplateDetail(WecomOAController.GetTemplateDetailParam params) 获取公费电话拨打记录
RetVo	setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule) 为打卡人员排班

从类继承的方法 com.kdayun.wecom.controller.WecomContollerBase

saveOrgIdAgendId

从类继承的方法 com.kdayun.z1.core.base.BaseController

commonsDownloadEx, commonsUploadEx, getUploadNewFileName, setResponseContentType, setResponseContentTypeAndStatus, setResponseHttpStatus, writeJsonToResponse

从类继承的方法 java.lang.Object

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

字段详细资料

wecomService

@Autowired
WecomService wecomService

构造器详细资料

WecomOAController

public WecomOAController()

方法详细资料

getCheckinData

@ResponseBody
 @RequestMapping(value="getCheckinData",
                method=POST)
public RetVo getCheckinData(@RequestBody
                                                                                                                   WecomOAController.CheckinParam param)
                                                                                                            throws java.lang.Exception

获取打卡数据 官方API:https://work.weixin.qq.com/api/doc#90000/90135/90262

参数:

param - 参数

返回:

RetVo

抛出:

java.lang.Exception - 出错会抛出异常

getCheckinOption

@ResponseBody
 @RequestMapping(value="getCheckinOption",
                method=POST)
public RetVo getCheckinOption(@RequestBody
                                                                                                                       WecomOAController.CheckinOptionParam param)
                                                                                                                throws java.lang.Exception

   获取打卡规则
   API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
 

参数:

param - 参数

返回:

打卡规则列表 checkin option

抛出:

java.lang.Exception - 出错会抛出异常

getApprovalInfo

@ResponseBody
 @RequestMapping(value="getApprovalInfo",
                method=POST)
public RetVo getApprovalInfo(@RequestBody
                                                                                                                     WecomOAController.ApprovalInfoParam params)
                                                                                                              throws java.lang.Exception

 批量获取审批单号

 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
 自建应用调用此接口，需在“管理后台-应用管理-审批-API-审批数据权限”中，授权应用允许提交审批单据。

 一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

 API doc : https://work.weixin.qq.com/api/doc/90000/90135/91816
 

参数:

params - 参数 如:[ { "key": "template_id", "value": "ZLqk8pcsAoaXZ1eY56vpAgfX28MPdYU3ayMaSPHaaa" }, { "key" : "creator", "value" : "WuJunJie" }] key取值: template_id - 模板类型/模板id； creator - 申请人； department - 审批单提单者所在部门； sp_status - 审批状态; record_type - 审批单类型属性，1-请假；2-打卡补卡；3-出差；4-外出；5-加班； 6- 调班；7-会议室预定；8-退款审批；9-红包报销审批

返回:

WxCpApprovalInfo approval info

抛出:

java.lang.Exception - 出错会抛出异常

getApprovalDetail

@ResponseBody
 @RequestMapping(value="getApprovalDetail",
                method=POST)
public RetVo getApprovalDetail(@RequestBody
                                                                                                                         WecomOAController.GetApprovalDetailParam param)
                                                                                                                  throws java.lang.Exception

   获取审批申请详情

   企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。

   API Doc : https://work.weixin.qq.com/api/doc/90000/90135/91983
 

参数:

param - 参数

返回:

WxCpApprovaldetail approval detail

抛出:

java.lang.Exception - 出错会抛出异常 .

setCheckinScheduleList

@ResponseBody
 @RequestMapping(value="setCheckinScheduleList",
                method=POST)
public RetVo setCheckinScheduleList(@RequestBody
                                                                                                                                   WxCpSetCheckinSchedule wxCpSetCheckinSchedule)
                                                                                                                            throws java.lang.Exception

为打卡人员排班

参数:

wxCpSetCheckinSchedule - the wx cp set checkin schedule

返回:

RetVo

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

java.lang.Exception

getDialRecord

@ResponseBody
 @RequestMapping(value="getDialRecord")
public RetVo getDialRecord(@RequestBody
                                                                                   WecomOAController.GetDialRecordParam params)
                                                                            throws java.lang.Exception

获取公费电话拨打记录

参数:

params - 参数

返回:

RetVo

抛出:

java.lang.Exception - 出错会抛出异常 .

getTemplateDetail

@ResponseBody
 @RequestMapping(value="getTemplateDetail",
                method=POST)
public RetVo getTemplateDetail(@RequestBody
                                                                                                                         WecomOAController.GetTemplateDetailParam params)
                                                                                                                  throws java.lang.Exception

获取公费电话拨打记录

参数:

params - 参数

返回:

RetVo

抛出:

java.lang.Exception - 出错会抛出异常 .

getCheckinDayData

@ResponseBody
 @RequestMapping(value="getCheckinDayData",
                method=POST)
public RetVo getCheckinDayData(@RequestBody
                                                                                                                         WecomOAController.CheckinDataParam params)
                                                                                                                  throws java.lang.Exception

获取打卡日报数据

参数:

params - 参数

返回:

日报数据列表 checkin day data

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

java.lang.Exception

getCheckinMonthData

@ResponseBody
 @RequestMapping(value="getCheckinMonthData",
                method=POST)
public RetVo getCheckinMonthData(@RequestBody
                                                                                                                             WecomOAController.CheckinDataParam params)
                                                                                                                      throws java.lang.Exception

获取打卡月报数据

参数:

params - 参数

返回:

月报数据列表

抛出:

java.lang.Exception - 出错会抛出异常 the wx error exception

getCheckinScheduleList

@ResponseBody
 @RequestMapping(value="getCheckinScheduleList",
                method=POST)
public RetVo getCheckinScheduleList(@RequestBody
                                                                                                                                   WecomOAController.CheckinDataParam params)
                                                                                                                            throws java.lang.Exception

获取打卡人员排班信息

参数:

params - 参数

返回:

排班表信息

抛出:

java.lang.Exception - 出错会抛出异常 the wx error exception