@@ -1,10 +1,8 @@ | |||
package me.chanjar.weixin.cp.api; | |||
import lombok.NonNull; | |||
import me.chanjar.weixin.common.error.WxErrorException; | |||
import me.chanjar.weixin.cp.bean.WxCpApprovalDataResult; | |||
import me.chanjar.weixin.cp.bean.WxCpCheckinData; | |||
import me.chanjar.weixin.cp.bean.WxCpCheckinOption; | |||
import me.chanjar.weixin.cp.bean.WxCpDialRecord; | |||
import me.chanjar.weixin.cp.bean.oa.*; | |||
import java.util.Date; | |||
import java.util.List; | |||
@@ -30,7 +28,8 @@ public interface WxCpOaService { | |||
* @return 打卡数据列表 | |||
* @throws WxErrorException 异常 | |||
*/ | |||
List<WxCpCheckinData> getCheckinData(Integer openCheckinDataType, Date startTime, Date endTime, List<String> userIdList) throws WxErrorException; | |||
List<WxCpCheckinData> getCheckinData(Integer openCheckinDataType, Date startTime, Date endTime, | |||
List<String> userIdList) throws WxErrorException; | |||
/** | |||
* <pre> | |||
@@ -41,13 +40,63 @@ public interface WxCpOaService { | |||
* @param datetime 需要获取规则的当天日期 | |||
* @param userIdList 需要获取打卡规则的用户列表 | |||
* @return 打卡规则列表 | |||
* @throws WxErrorException 异常 | |||
* @throws WxErrorException | |||
*/ | |||
List<WxCpCheckinOption> getCheckinOption(Date datetime, List<String> userIdList) throws WxErrorException; | |||
/** | |||
* <pre> | |||
* 获取审批数据 | |||
* | |||
* 批量获取审批单号 | |||
* | |||
* 审批应用及有权限的自建应用,可通过Secret调用本接口,以获取企业一段时间内企业微信“审批应用”单据的审批编号,支持按模板类型、申请人、部门、申请单审批状态等条件筛选。 | |||
* 自建应用调用此接口,需在“管理后台-应用管理-审批-API-审批数据权限”中,授权应用允许提交审批单据。 | |||
* | |||
* 一次拉取调用最多拉取100个审批记录,可以通过多次拉取的方式来满足需求,但调用频率不可超过600次/分。 | |||
* | |||
* API doc : https://work.weixin.qq.com/api/doc/90000/90135/91816 | |||
* </pre> | |||
* | |||
* @param startTime 开始时间 | |||
* @param endTime 结束时间 | |||
* @param cursor 分页查询游标,默认为0,后续使用返回的next_cursor进行分页拉取 | |||
* @param size 一次请求拉取审批单数量,默认值为100,上限值为100 | |||
* @param filters 筛选条件,可对批量拉取的审批申请设置约束条件,支持设置多个条件,nullable | |||
* @return WxCpApprovalInfo | |||
* @throws WxErrorException | |||
*/ | |||
WxCpApprovalInfo getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime, Integer cursor, Integer size, | |||
List<WxCpApprovalInfoQueryFilter> filters) throws WxErrorException; | |||
/** | |||
* short method | |||
* | |||
* @param startTime 开始时间 | |||
* @param endTime 结束时间 | |||
* @return WxCpApprovalInfo | |||
* @throws WxErrorException | |||
* @see me.chanjar.weixin.cp.api.WxCpOaService#getApprovalInfo | |||
*/ | |||
WxCpApprovalInfo getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime) throws WxErrorException; | |||
/** | |||
* <pre> | |||
* 获取审批申请详情 | |||
* | |||
* 企业可通过审批应用或自建应用Secret调用本接口,根据审批单号查询企业微信“审批应用”的审批申请详情。 | |||
* | |||
* API Doc : https://work.weixin.qq.com/api/doc/90000/90135/91983 | |||
* </pre> | |||
* | |||
* @param spNo 审批单编号。 | |||
* @return WxCpApprovaldetail | |||
* @throws WxErrorException | |||
*/ | |||
WxCpApprovalDetailResult getApprovalDetail(@NonNull String spNo) throws WxErrorException; | |||
/** | |||
* <pre> | |||
* 获取审批数据 (已过期, 请使用"批量获取审批单号" && "获取审批申请详情") | |||
* 通过本接口来获取公司一段时间内的审批记录。一次拉取调用最多拉取10000个审批记录,可以通过多次拉取的方式来满足需求,但调用频率不可超过600次/分。 | |||
* API doc : https://work.weixin.qq.com/api/doc#90000/90135/91530 | |||
* </pre> | |||
@@ -55,10 +104,24 @@ public interface WxCpOaService { | |||
* @param startTime 获取审批记录的开始时间 | |||
* @param endTime 获取审批记录的结束时间 | |||
* @param nextSpnum 第一个拉取的审批单号,不填从该时间段的第一个审批单拉取 | |||
* @throws WxErrorException 异常 | |||
* @throws WxErrorException | |||
* @see me.chanjar.weixin.cp.api.WxCpOaService#getApprovalInfo | |||
* @see me.chanjar.weixin.cp.api.WxCpOaService#getApprovalDetail | |||
*/ | |||
@Deprecated | |||
WxCpApprovalDataResult getApprovalData(Date startTime, Date endTime, Long nextSpnum) throws WxErrorException; | |||
List<WxCpDialRecord> getDialRecord(Date startTime, Date endTime, Integer offset, Integer limit) throws WxErrorException; | |||
/** | |||
* 获取公费电话拨打记录 | |||
* | |||
* @param startTime 查询的起始时间戳 | |||
* @param endTime 查询的结束时间戳 | |||
* @param offset 分页查询的偏移量 | |||
* @param limit 分页查询的每页大小,默认为100条,如该参数大于100则按100处理 | |||
* @return | |||
* @throws WxErrorException | |||
*/ | |||
List<WxCpDialRecord> getDialRecord(Date startTime, Date endTime, Integer offset, | |||
Integer limit) throws WxErrorException; | |||
} |
@@ -5,15 +5,12 @@ import com.google.gson.JsonElement; | |||
import com.google.gson.JsonObject; | |||
import com.google.gson.JsonParser; | |||
import com.google.gson.reflect.TypeToken; | |||
import lombok.NonNull; | |||
import lombok.RequiredArgsConstructor; | |||
import me.chanjar.weixin.common.error.WxErrorException; | |||
import me.chanjar.weixin.cp.api.WxCpOaService; | |||
import me.chanjar.weixin.cp.api.WxCpService; | |||
import me.chanjar.weixin.cp.bean.WxCpApprovalDataResult; | |||
import me.chanjar.weixin.cp.bean.WxCpCheckinData; | |||
import me.chanjar.weixin.cp.bean.WxCpCheckinOption; | |||
import me.chanjar.weixin.cp.bean.WxCpDialRecord; | |||
import me.chanjar.weixin.cp.constant.WxCpApiPathConsts; | |||
import me.chanjar.weixin.cp.bean.oa.*; | |||
import me.chanjar.weixin.cp.util.json.WxCpGsonBuilder; | |||
import java.util.Date; | |||
@@ -22,7 +19,7 @@ import java.util.List; | |||
import static me.chanjar.weixin.cp.constant.WxCpApiPathConsts.Oa.*; | |||
/** | |||
* . | |||
* 企业微信 OA 接口实现 | |||
* | |||
* @author Element | |||
* @date 2019-04-06 11:20 | |||
@@ -31,6 +28,9 @@ import static me.chanjar.weixin.cp.constant.WxCpApiPathConsts.Oa.*; | |||
public class WxCpOaServiceImpl implements WxCpOaService { | |||
private final WxCpService mainService; | |||
private static final int MONTH_SECONDS = 30 * 24 * 60 * 60; | |||
private static final int USER_IDS_LIMIT = 100; | |||
@Override | |||
public List<WxCpCheckinData> getCheckinData(Integer openCheckinDataType, Date startTime, Date endTime, | |||
List<String> userIdList) throws WxErrorException { | |||
@@ -38,14 +38,14 @@ public class WxCpOaServiceImpl implements WxCpOaService { | |||
throw new RuntimeException("starttime and endtime can't be null"); | |||
} | |||
if (userIdList == null || userIdList.size() > 100) { | |||
throw new RuntimeException("用户列表不能为空,不超过100个,若用户超过100个,请分批获取"); | |||
if (userIdList == null || userIdList.size() > USER_IDS_LIMIT) { | |||
throw new RuntimeException("用户列表不能为空,不超过 " + USER_IDS_LIMIT + " 个,若用户超过 " + USER_IDS_LIMIT + " 个,请分批获取"); | |||
} | |||
long endtimestamp = endTime.getTime() / 1000L; | |||
long starttimestamp = startTime.getTime() / 1000L; | |||
if (endtimestamp - starttimestamp < 0 || endtimestamp - starttimestamp >= 30 * 24 * 60 * 60) { | |||
if (endtimestamp - starttimestamp < 0 || endtimestamp - starttimestamp >= MONTH_SECONDS) { | |||
throw new RuntimeException("获取记录时间跨度不超过一个月"); | |||
} | |||
@@ -79,8 +79,8 @@ public class WxCpOaServiceImpl implements WxCpOaService { | |||
throw new RuntimeException("datetime can't be null"); | |||
} | |||
if (userIdList == null || userIdList.size() > 100) { | |||
throw new RuntimeException("用户列表不能为空,不超过100个,若用户超过100个,请分批获取"); | |||
if (userIdList == null || userIdList.size() > USER_IDS_LIMIT) { | |||
throw new RuntimeException("用户列表不能为空,不超过 " + USER_IDS_LIMIT + " 个,若用户超过 " + USER_IDS_LIMIT + " 个,请分批获取"); | |||
} | |||
JsonArray jsonArray = new JsonArray(); | |||
@@ -104,6 +104,59 @@ public class WxCpOaServiceImpl implements WxCpOaService { | |||
); | |||
} | |||
@Override | |||
public WxCpApprovalInfo getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime, | |||
Integer cursor, Integer size, List<WxCpApprovalInfoQueryFilter> filters) throws WxErrorException { | |||
if (cursor == null) { | |||
cursor = 0; | |||
} | |||
if (size == null) { | |||
size = 100; | |||
} | |||
if (size < 0 || size > 100) { | |||
throw new IllegalArgumentException("size参数错误,请使用[1-100]填充,默认100"); | |||
} | |||
JsonObject jsonObject = new JsonObject(); | |||
jsonObject.addProperty("starttime", startTime.getTime() / 1000L); | |||
jsonObject.addProperty("endtime", endTime.getTime() / 1000L); | |||
jsonObject.addProperty("size", size); | |||
jsonObject.addProperty("cursor", cursor); | |||
if (filters != null && !filters.isEmpty()) { | |||
JsonArray filterJsonArray = new JsonArray(); | |||
for (WxCpApprovalInfoQueryFilter filter : filters) { | |||
filterJsonArray.add(new JsonParser().parse(filter.toJson())); | |||
} | |||
jsonObject.add("filters", filterJsonArray); | |||
} | |||
final String url = this.mainService.getWxCpConfigStorage().getApiUrl(GET_APPROVAL_INFO); | |||
String responseContent = this.mainService.post(url, jsonObject.toString()); | |||
return WxCpGsonBuilder.create().fromJson(responseContent, WxCpApprovalInfo.class); | |||
} | |||
@Override | |||
public WxCpApprovalInfo getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime) throws WxErrorException { | |||
return this.getApprovalInfo(startTime, endTime, null, null, null); | |||
} | |||
@Override | |||
public WxCpApprovalDetailResult getApprovalDetail(@NonNull String spNo) throws WxErrorException { | |||
JsonObject jsonObject = new JsonObject(); | |||
jsonObject.addProperty("sp_no", spNo); | |||
final String url = this.mainService.getWxCpConfigStorage().getApiUrl(GET_APPROVAL_DETAIL); | |||
String responseContent = this.mainService.post(url, jsonObject.toString()); | |||
return WxCpGsonBuilder.create().fromJson(responseContent, WxCpApprovalDetailResult.class); | |||
} | |||
@Override | |||
public WxCpApprovalDataResult getApprovalData(Date startTime, Date endTime, Long nextSpnum) throws WxErrorException { | |||
JsonObject jsonObject = new JsonObject(); | |||
@@ -139,7 +192,7 @@ public class WxCpOaServiceImpl implements WxCpOaService { | |||
long endtimestamp = endTime.getTime() / 1000L; | |||
long starttimestamp = startTime.getTime() / 1000L; | |||
if (endtimestamp - starttimestamp < 0 || endtimestamp - starttimestamp >= 30 * 24 * 60 * 60) { | |||
if (endtimestamp - starttimestamp < 0 || endtimestamp - starttimestamp >= MONTH_SECONDS) { | |||
throw new RuntimeException("受限于网络传输,起止时间的最大跨度为30天,如超过30天,则以结束时间为基准向前取30天进行查询"); | |||
} | |||
@@ -0,0 +1,21 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import lombok.Data; | |||
import me.chanjar.weixin.cp.bean.oa.applydata.Content; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
/** | |||
* 审批申请数据 | |||
* | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalApplyData implements Serializable { | |||
private static final long serialVersionUID = 4061352949894274704L; | |||
private List<Content> contents; | |||
} |
@@ -0,0 +1,23 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
/** | |||
* 申请人信息 | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalApplyer extends WxCpOperator implements Serializable { | |||
private static final long serialVersionUID = -8974662568286821271L; | |||
/** | |||
* 申请人所在部门id | |||
*/ | |||
@SerializedName("partyid") | |||
private String partyId; | |||
} |
@@ -0,0 +1,48 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
/** | |||
* 审批申请备注信息 | |||
* | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalComment implements Serializable { | |||
private static final long serialVersionUID = -5430367411926856292L; | |||
/** | |||
* 备注人信息 | |||
*/ | |||
private WxCpOperator commentUserInfo; | |||
/** | |||
* 备注提交时间戳,Unix时间戳 | |||
*/ | |||
@SerializedName("commenttime") | |||
private Long commentTime; | |||
/** | |||
* 备注id | |||
*/ | |||
@SerializedName("commentid") | |||
private String commentId; | |||
/** | |||
* 备注文本内容 | |||
*/ | |||
@SerializedName("commentcontent") | |||
private String commentContent; | |||
/** | |||
* 备注附件id,可能有多个 | |||
*/ | |||
@SerializedName("media_id") | |||
private List<String> mediaIds; | |||
} |
@@ -1,4 +1,4 @@ | |||
package me.chanjar.weixin.cp.bean; | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
@@ -12,6 +12,7 @@ import java.util.Map; | |||
* @author Element | |||
* @date 2019-04-06 14:36 | |||
*/ | |||
@Deprecated | |||
@Data | |||
public class WxCpApprovalDataResult implements Serializable { | |||
private static final long serialVersionUID = -1046940445840716590L; |
@@ -0,0 +1,78 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
/** | |||
* 审批申请详情 | |||
* | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalDetail implements Serializable { | |||
private static final long serialVersionUID = 1353393306564207170L; | |||
/** | |||
* 审批编号 | |||
*/ | |||
@SerializedName("sp_no") | |||
private String spNo; | |||
/** | |||
* 审批申请类型名称(审批模板名称) | |||
*/ | |||
@SerializedName("sp_name") | |||
private String spName; | |||
/** | |||
* 申请单状态:1-审批中;2-已通过;3-已驳回;4-已撤销;6-通过后撤销;7-已删除;10-已支付 | |||
*/ | |||
@SerializedName("sp_status") | |||
private WxCpSpStatus spStatus; | |||
/** | |||
* 审批模板id。可在“获取审批申请详情”、“审批状态变化回调通知”中获得,也可在审批模板的模板编辑页面链接中获得。 | |||
*/ | |||
@SerializedName("template_id") | |||
private String templateId; | |||
/** | |||
* 审批申请提交时间,Unix时间戳 | |||
*/ | |||
@SerializedName("apply_time") | |||
private Long applyTime; | |||
/** | |||
* 申请人信息 | |||
*/ | |||
private WxCpApprovalApplyer applyer; | |||
/** | |||
* 审批流程信息,可能有多个审批节点 | |||
*/ | |||
@SerializedName("sp_record") | |||
private WxCpApprovalRecord spRecord; | |||
/** | |||
* 抄送信息,可能有多个抄送节点 | |||
*/ | |||
@SerializedName("notifyer") | |||
private WxCpOperator notifyer; | |||
/** | |||
* 审批申请数据 | |||
*/ | |||
@SerializedName("apply_data") | |||
private WxCpApprovalApplyData applyData; | |||
/** | |||
* 审批申请备注信息,可能有多个备注节点 | |||
*/ | |||
@SerializedName("comments") | |||
private List<WxCpApprovalComment> comments; | |||
} |
@@ -0,0 +1,27 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
/** | |||
* 审批申请详情响应结果 | |||
* | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalDetailResult implements Serializable { | |||
private static final long serialVersionUID = 3909779949756252918L; | |||
@SerializedName("errcode") | |||
private Integer errCode; | |||
@SerializedName("errmsg") | |||
private String errMsg; | |||
@SerializedName("info") | |||
private WxCpApprovalDetail info; | |||
} |
@@ -0,0 +1,29 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
/** | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalInfo implements Serializable { | |||
private static final long serialVersionUID = 7387181805254287167L; | |||
@SerializedName("errcode") | |||
private Integer errCode; | |||
@SerializedName("errmsg") | |||
private String errMsg; | |||
@SerializedName("sp_no_list") | |||
private List<String> spNoList; | |||
@SerializedName("next_cursor") | |||
private Integer nextCursor; | |||
} |
@@ -0,0 +1,61 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import me.chanjar.weixin.common.util.json.WxGsonBuilder; | |||
import java.io.Serializable; | |||
/** | |||
* <pre> | |||
* 批量获取审批单号的筛选条件,可对批量拉取的审批申请设置约束条件,支持设置多个条件 | |||
* 注意: | |||
* 仅“部门”支持同时配置多个筛选条件。 | |||
* 不同类型的筛选条件之间为“与”的关系,同类型筛选条件之间为“或”的关系 | |||
* </pre> | |||
* | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalInfoQueryFilter implements Serializable { | |||
private static final long serialVersionUID = 3318064927980231802L; | |||
private WxCpApprovalInfoQueryFilter.KEY key; | |||
private Object value; | |||
public String toJson() { | |||
return WxGsonBuilder.create().toJson(this); | |||
} | |||
public static enum KEY { | |||
/** | |||
* template_id - 模板类型/模板id; | |||
*/ | |||
@SerializedName("template_id") | |||
TEMPLATE_ID("template_id"), | |||
/** | |||
* creator - 申请人; | |||
*/ | |||
@SerializedName("creator") | |||
CREATOR("creator"), | |||
/** | |||
* department - 审批单提单者所在部门; | |||
*/ | |||
@SerializedName("department") | |||
DEPARTMENT("department"), | |||
/** | |||
* sp_status - 审批状态。 | |||
*/ | |||
@SerializedName("sp_status") | |||
SP_STATUS("sp_status"); | |||
private String value; | |||
private KEY(String value) { | |||
this.value = value; | |||
} | |||
} | |||
} |
@@ -0,0 +1,26 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
/** | |||
* 审批流程信息 | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalRecord implements Serializable { | |||
private static final long serialVersionUID = -327230786004105887L; | |||
@SerializedName("sp_status") | |||
private WxCpRecordSpStatus status; | |||
@SerializedName("approverattr") | |||
private WxCpApproverAttr approverAttr; | |||
private List<WxCpApprovalRecordDetail> details; | |||
} |
@@ -0,0 +1,48 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
/** | |||
* 审批节点详情 | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpApprovalRecordDetail implements Serializable { | |||
private static final long serialVersionUID = -9142079764088495301L; | |||
/** | |||
* 分支审批人 | |||
*/ | |||
@SerializedName("approver") | |||
private WxCpOperator approver; | |||
/** | |||
* 审批意见 | |||
*/ | |||
@SerializedName("speech") | |||
private String speech; | |||
/** | |||
* 分支审批人审批状态 | |||
*/ | |||
@SerializedName("sp_status") | |||
private WxCpRecordSpStatus spStatus; | |||
/** | |||
* 节点分支审批人审批操作时间戳,0表示未操作 | |||
*/ | |||
@SerializedName("sptime") | |||
private Long spTime; | |||
/** | |||
* 节点分支审批人审批意见附件 | |||
*/ | |||
@SerializedName("media_id") | |||
private List<String> mediaIds; | |||
} |
@@ -0,0 +1,28 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
/** | |||
* 审批方式 | |||
* | |||
* @author element | |||
*/ | |||
public enum WxCpApproverAttr { | |||
/** | |||
* 或签 | |||
*/ | |||
@SerializedName("1") | |||
ONE_SIGN(1), | |||
/** | |||
* 会签 | |||
*/ | |||
@SerializedName("2") | |||
ALL_SIGN(2); | |||
private Integer attr; | |||
private WxCpApproverAttr(Integer attr) { | |||
this.attr = attr; | |||
} | |||
} |
@@ -1,4 +1,4 @@ | |||
package me.chanjar.weixin.cp.bean; | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; |
@@ -1,4 +1,4 @@ | |||
package me.chanjar.weixin.cp.bean; | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; |
@@ -1,4 +1,4 @@ | |||
package me.chanjar.weixin.cp.bean; | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; |
@@ -0,0 +1,24 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
/** | |||
* 企业微信操作人 | |||
* | |||
* @author element | |||
*/ | |||
@Data | |||
public class WxCpOperator implements Serializable { | |||
private static final long serialVersionUID = 5797144853574346736L; | |||
/** | |||
* 企业微信userid | |||
*/ | |||
@SerializedName("userid") | |||
private String userId; | |||
} |
@@ -0,0 +1,41 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
/** | |||
* 审批记录(节点)分支审批状态 | |||
* | |||
* 1-审批中;2-已同意;3-已驳回;4-已转审 | |||
* | |||
* @author element | |||
*/ | |||
public enum WxCpRecordSpStatus { | |||
/** | |||
* 审批中 | |||
*/ | |||
@SerializedName("1") | |||
AUDITING(1), | |||
/** | |||
* 已同意 | |||
*/ | |||
@SerializedName("2") | |||
PASSED(2), | |||
/** | |||
* 已驳回 | |||
*/ | |||
@SerializedName("3") | |||
REJECTED(3), | |||
/** | |||
* 已转审 | |||
*/ | |||
@SerializedName("4") | |||
TURNED(4); | |||
private Integer status; | |||
private WxCpRecordSpStatus(Integer status) { | |||
this.status = status; | |||
} | |||
} |
@@ -0,0 +1,54 @@ | |||
package me.chanjar.weixin.cp.bean.oa; | |||
import com.google.gson.annotations.SerializedName; | |||
/** | |||
* 审批单状态 | |||
* (1-审批中;2-已通过;3-已驳回;4-已撤销;6-通过后撤销;7-已删除;10-已支付) | |||
* | |||
* @author element | |||
*/ | |||
public enum WxCpSpStatus { | |||
/** | |||
* 审批中 | |||
*/ | |||
@SerializedName("1") | |||
AUDITING(1), | |||
/** | |||
* 已通过 | |||
*/ | |||
@SerializedName("2") | |||
PASSED(2), | |||
/** | |||
* 已驳回 | |||
*/ | |||
@SerializedName("3") | |||
REJECTED(3), | |||
/** | |||
* 已撤销 | |||
*/ | |||
@SerializedName("4") | |||
UNDONE(4), | |||
/** | |||
* 通过后撤销 | |||
*/ | |||
@SerializedName("6") | |||
PASS_UNDONE(6), | |||
/** | |||
* 已删除 | |||
*/ | |||
@SerializedName("7") | |||
DELETED(7), | |||
/** | |||
* 已支付 | |||
*/ | |||
@SerializedName("10") | |||
ALREADY_PAY(10); | |||
private Integer status; | |||
private WxCpSpStatus(Integer status) { | |||
this.status = status; | |||
} | |||
} |
@@ -0,0 +1,24 @@ | |||
package me.chanjar.weixin.cp.bean.oa.applydata; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
/** | |||
* @author element | |||
*/ | |||
@Data | |||
public class Content implements Serializable { | |||
private static final long serialVersionUID = 8456821731930526935L; | |||
private String control; | |||
private String id; | |||
@SerializedName("title") | |||
private List<ContentTitle> titles; | |||
private ContentValue value; | |||
} |
@@ -0,0 +1,18 @@ | |||
package me.chanjar.weixin.cp.bean.oa.applydata; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
/** | |||
* @author element | |||
*/ | |||
@Data | |||
public class ContentTitle implements Serializable { | |||
private static final long serialVersionUID = -4501999157383517007L; | |||
private String text; | |||
private String lang; | |||
} |
@@ -0,0 +1,103 @@ | |||
package me.chanjar.weixin.cp.bean.oa.applydata; | |||
import com.google.gson.annotations.SerializedName; | |||
import lombok.Data; | |||
import java.io.Serializable; | |||
import java.util.List; | |||
/** | |||
* @author element | |||
*/ | |||
@Data | |||
public class ContentValue implements Serializable { | |||
private static final long serialVersionUID = -5607678965965065261L; | |||
private String text; | |||
@SerializedName("new_number") | |||
private Integer newNumber; | |||
@SerializedName("new_money") | |||
private Integer newMoney; | |||
private ContentValue.Date date; | |||
private ContentValue.Selector selector; | |||
private List<ContentValue.Member> members; | |||
private List<ContentValue.Department> departments; | |||
private List<ContentValue.File> files; | |||
private List<ContentValue.Child> children; | |||
@Data | |||
public static class Date implements Serializable { | |||
private static final long serialVersionUID = -6181554080062231138L; | |||
private String type; | |||
@SerializedName("s_timestamp") | |||
private Long timestamp; | |||
} | |||
@Data | |||
public static class Selector implements Serializable { | |||
private static final long serialVersionUID = 7305458759126951773L; | |||
private String type; | |||
private List<Option> options; | |||
@Data | |||
public static class Option implements Serializable { | |||
private static final long serialVersionUID = -3471071106328280252L; | |||
private String key; | |||
@SerializedName("value") | |||
private List<ContentTitle> values; | |||
} | |||
} | |||
@Data | |||
public static class Member implements Serializable { | |||
private static final long serialVersionUID = 1316551341955496067L; | |||
@SerializedName("userid") | |||
private String userId; | |||
private String name; | |||
} | |||
@Data | |||
public static class Department implements Serializable { | |||
private static final long serialVersionUID = -2513762192924826234L; | |||
@SerializedName("openapi_id") | |||
private String openApiId; | |||
private String name; | |||
} | |||
@Data | |||
public static class File implements Serializable { | |||
private static final long serialVersionUID = 3890971381800855142L; | |||
@SerializedName("file_id") | |||
private String fileId; | |||
} | |||
@Data | |||
public static class Child implements Serializable { | |||
private static final long serialVersionUID = -3500102073821161558L; | |||
private List<Content> list; | |||
} | |||
} |
@@ -64,8 +64,11 @@ public final class WxCpApiPathConsts { | |||
public static class Oa { | |||
public static final String GET_CHECKIN_DATA = "/cgi-bin/checkin/getcheckindata"; | |||
public static final String GET_CHECKIN_OPTION = "/cgi-bin/checkin/getcheckinoption"; | |||
public static final String GET_APPROVAL_DATA = "/cgi-bin/corp/getapprovaldata"; | |||
public static final String GET_APPROVAL_INFO = "/cgi-bin/oa/getapprovalinfo"; | |||
public static final String GET_APPROVAL_DETAIL = "/cgi-bin/oa/getapprovaldetail"; | |||
public static final String GET_DIAL_RECORD = "/cgi-bin/dial/get_dial_record"; | |||
@Deprecated | |||
public static final String GET_APPROVAL_DATA = "/cgi-bin/corp/getapprovaldata"; | |||
} | |||
public static class Tag { | |||
@@ -1,33 +1,40 @@ | |||
package me.chanjar.weixin.cp.api.impl; | |||
import com.google.common.collect.Lists; | |||
import com.google.gson.Gson; | |||
import com.google.inject.Inject; | |||
import me.chanjar.weixin.common.error.WxErrorException; | |||
import me.chanjar.weixin.cp.api.ApiTestModule; | |||
import me.chanjar.weixin.cp.api.WxCpService; | |||
import me.chanjar.weixin.cp.bean.WxCpCheckinData; | |||
import me.chanjar.weixin.cp.bean.WxCpCheckinOption; | |||
import me.chanjar.weixin.cp.bean.oa.WxCpApprovalDetailResult; | |||
import me.chanjar.weixin.cp.bean.oa.WxCpApprovalInfo; | |||
import me.chanjar.weixin.cp.bean.oa.WxCpCheckinData; | |||
import me.chanjar.weixin.cp.bean.oa.WxCpCheckinOption; | |||
import org.apache.commons.lang3.time.DateFormatUtils; | |||
import org.testng.annotations.Guice; | |||
import org.testng.annotations.Test; | |||
import org.testng.collections.Lists; | |||
import java.text.ParseException; | |||
import java.util.ArrayList; | |||
import java.util.Date; | |||
import java.util.List; | |||
import static org.assertj.core.api.Assertions.assertThat; | |||
/** | |||
* 企业微信 OA数据接口 测试用例 | |||
* | |||
* @author Element | |||
* @date 2019-04-20 13:46 | |||
*/ | |||
@Guice(modules = ApiTestModule.class) | |||
public class WxCpOaServiceImplTest { | |||
@Inject | |||
protected WxCpService wxService; | |||
@Inject | |||
protected Gson gson; | |||
@Test | |||
public void testGetCheckinData() throws ParseException, WxErrorException { | |||
Date startTime = DateFormatUtils.ISO_8601_EXTENDED_DATE_FORMAT.parse("2019-04-11"); | |||
@@ -37,13 +44,43 @@ public class WxCpOaServiceImplTest { | |||
.getCheckinData(1, startTime, endTime, Lists.newArrayList("binary")); | |||
assertThat(results).isNotNull(); | |||
System.out.println("results "); | |||
System.out.println(gson.toJson(results)); | |||
} | |||
@Test | |||
public void testGetCheckinOption() throws WxErrorException { | |||
Date now = new Date(); | |||
List<WxCpCheckinOption> results = wxService.getOAService() | |||
.getCheckinOption(now, Lists.newArrayList("binary")); | |||
List<WxCpCheckinOption> results = wxService.getOAService().getCheckinOption(now, Lists.newArrayList("binary")); | |||
assertThat(results).isNotNull(); | |||
System.out.println("results "); | |||
System.out.println(gson.toJson(results)); | |||
} | |||
@Test | |||
public void testGetApprovalInfo() throws WxErrorException, ParseException { | |||
Date startTime = DateFormatUtils.ISO_8601_EXTENDED_DATE_FORMAT.parse("2019-04-11"); | |||
Date endTime = DateFormatUtils.ISO_8601_EXTENDED_DATE_FORMAT.parse("2019-05-10"); | |||
WxCpApprovalInfo result = wxService.getOAService().getApprovalInfo(startTime, endTime); | |||
assertThat(result).isNotNull(); | |||
System.out.println("result "); | |||
System.out.println(gson.toJson(result)); | |||
} | |||
@Test | |||
public void testGetApprovalDetail() throws WxErrorException { | |||
String spNo = "201909270001"; | |||
WxCpApprovalDetailResult result = wxService.getOAService().getApprovalDetail(spNo); | |||
assertThat(result).isNotNull(); | |||
System.out.println("result "); | |||
System.out.println(gson.toJson(result)); | |||
} | |||
} |