🆕 #1416: 企业微信增加获取OA审批模板详情接口

Author: Gyv12345

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpOaService.java

@@ -124,4 +124,12 @@ WxCpApprovalInfo getApprovalInfo(@NonNull Date startTime, @NonNull Date endTime,
   List<WxCpDialRecord> getDialRecord(Date startTime, Date endTime, Integer offset,
                                      Integer limit) throws WxErrorException;
 
+  /**
+   * 获取审批模板详情
+   * @param templateId 模板ID
+   * @return
+   * @throws WxErrorException
+   */
+  WxCpTemplateResult getTemplateDetail(@NonNull String templateId)throws WxErrorException;
+
 }

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpOaServiceImpl.java

@@ -209,4 +209,13 @@ public List<WxCpDialRecord> getDialRecord(Date startTime, Date endTime, Integer
       }.getType()
     );
   }
+
+  @Override
+  public WxCpTemplateResult getTemplateDetail(@NonNull String templateId) throws WxErrorException {
+    JsonObject jsonObject = new JsonObject();
+    jsonObject.addProperty("template_id",templateId);
+    final String url = this.mainService.getWxCpConfigStorage().getApiUrl(GET_TEMPLATE_DETAIL);
+    String responseContent = this.mainService.post(url, jsonObject.toString());
+    return WxCpGsonBuilder.create().fromJson(responseContent,WxCpTemplateResult.class);
+  }
 }

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/WxCpCheckinData.java

@@ -47,4 +47,8 @@ public class WxCpCheckinData implements Serializable {
 
   @SerializedName("mediaids")
   private List<String> mediaIds;
+
+  private Integer lat;
+
+  private Integer lng;
 }

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/WxCpTemplateResult.java

@@ -0,0 +1,35 @@
+package me.chanjar.weixin.cp.bean.oa;
+
+import com.google.gson.JsonObject;
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import me.chanjar.weixin.cp.bean.oa.templatedata.TemplateContent;
+import me.chanjar.weixin.cp.bean.oa.templatedata.TemplateControls;
+import me.chanjar.weixin.cp.bean.oa.templatedata.TemplateTitle;
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 审批模板详情
+ *
+ * @author [email protected]
+ */
+@Data
+public class WxCpTemplateResult implements Serializable {
+  private static final long serialVersionUID = 6690547131189343887L;
+
+  @SerializedName("errcode")
+  private Integer errCode;
+
+  @SerializedName("errmsg")
+  private String errMsg;
+
+  @SerializedName("template_names")
+  private List<TemplateTitle> templateNames;
+
+  @SerializedName("template_content")
+  private TemplateContent templateContent;
+
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/templatedata/TemplateConfig.java

@@ -0,0 +1,37 @@
+package me.chanjar.weixin.cp.bean.oa.templatedata;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import me.chanjar.weixin.cp.bean.oa.templatedata.control.*;
+
+import java.io.Serializable;
+
+/**
+ * 模板控件配置，包含了部分控件类型的附加类型、属性，详见附录说明。
+ * 目前有配置信息的控件类型有：
+ * Date-日期/日期+时间；
+ * Selector-单选/多选；
+ * Contact-成员/部门；
+ * Table-明细；
+ * Attendance-假勤组件（请假、外出、出差、加班）
+ * @author [email protected]
+ */
+@Data
+public class TemplateConfig implements Serializable {
+
+  private static final long serialVersionUID = 6993937809371277669L;
+
+  private TemplateDate date;
+
+  private TemplateSelector selector;
+
+  private TemplateContact contact;
+
+  private TemplateTable table;
+
+  private TemplateAttendance attendance;
+
+  @SerializedName("vacation_list")
+  private TemplateVacation vacationList;
+
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/templatedata/TemplateContent.java

@@ -0,0 +1,17 @@
+package me.chanjar.weixin.cp.bean.oa.templatedata;
+
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * @author [email protected]
+ */
+@Data
+public class TemplateContent implements Serializable {
+
+  private static final long serialVersionUID = -5640250983775840865L;
+
+  private List<TemplateControls> controls;
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/templatedata/TemplateControls.java

@@ -0,0 +1,19 @@
+package me.chanjar.weixin.cp.bean.oa.templatedata;
+
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Map;
+
+/**
+ * @author Administrator
+ */
+@Data
+public class TemplateControls implements Serializable {
+
+  private static final long serialVersionUID = -7496794407355510374L;
+
+  private TemplateProperty property;
+
+  private TemplateConfig config;
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/templatedata/TemplateDateRange.java

@@ -0,0 +1,19 @@
+package me.chanjar.weixin.cp.bean.oa.templatedata;
+
+import lombok.Data;
+
+import java.io.Serializable;
+
+/**
+ * @author [email protected]
+ */
+@Data
+public class TemplateDateRange implements Serializable {
+
+  private static final long serialVersionUID = -9209035461466543180L;
+
+  /**
+   * 时间刻度：hour-精确到分钟, halfday—上午/下午
+   */
+  private String type;
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/templatedata/TemplateOptions.java

@@ -0,0 +1,16 @@
+package me.chanjar.weixin.cp.bean.oa.templatedata;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * @author [email protected]
+ */
+public class TemplateOptions implements Serializable {
+
+  private static final long serialVersionUID = -7883792668568772078L;
+
+  private String key;
+
+  private List<TemplateTitle> value;
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/oa/templatedata/TemplateProperty.java

@@ -0,0 +1,41 @@
+package me.chanjar.weixin.cp.bean.oa.templatedata;
+
+import com.google.gson.JsonObject;
+import com.google.gson.annotations.SerializedName;
+import me.chanjar.weixin.cp.bean.oa.WxCpTemplateResult;
+import me.chanjar.weixin.cp.bean.oa.templatedata.control.TemplateContact;
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @author [email protected]
+ */
+public class TemplateProperty implements Serializable {
+
+  private static final long serialVersionUID = -3429251158540167453L;
+
+  private String control;
+
+  private String id;
+
+  private List<TemplateTitle> title;
+
+  /**
+   * 控件说明，向申请者展示的控件填写说明，若配置了多语言则会包含中英文的控件说明，默认为zh_CN中文
+   */
+  private List<TemplateTitle> placeholder;
+
+  /**
+   * 是否必填：1-必填；0-非必填
+   */
+  private Integer require;
+  /**
+   * 是否参与打印：1-不参与打印；0-参与打印
+   */
+  @SerializedName("un_print")
+  private Integer unPrint;
+
+  private TemplateConfig config;
+}