From feaf90e36152c31a57d57dfcf1c58076696254f4 Mon Sep 17 00:00:00 2001
From: softboy99 <anders.wong99@gmail.com>
Date: Thu, 12 Mar 2026 20:30:50 +0800
Subject: [PATCH] =?UTF-8?q?:art:=20#3925=20=E3=80=90=E4=BC=81=E4=B8=9A?=
 =?UTF-8?q?=E5=BE=AE=E4=BF=A1=E3=80=91=E4=BF=AE=E5=A4=8DHR=E5=8A=A9?=
 =?UTF-8?q?=E6=89=8BgetEmployeeFieldInfo=E6=8E=A5=E5=8F=A3getAll=E5=8F=82?=
 =?UTF-8?q?=E6=95=B0=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../chanjar/weixin/cp/api/WxCpHrService.java  | 20 +++++++++++++------
 .../weixin/cp/api/impl/WxCpHrServiceImpl.java |  6 ++++++
 2 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpHrService.java b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpHrService.java
index cdf39871a..d9d6ed012 100644
--- a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpHrService.java
+++ b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpHrService.java
@@ -9,9 +9,9 @@ import java.util.List;
 
 /**
  * 人事助手相关接口.
- * 官方文档：https://developer.work.weixin.qq.com/document/path/99132
+ * 官方文档：<a href="https://developer.work.weixin.qq.com/document/path/99132">...</a>
  *
- * @author <a href="https://github.com/leejoker">leejoker</a> created on 2024-01-01
+ * @author copilot
  */
 public interface WxCpHrService {
 
@@ -19,7 +19,7 @@ public interface WxCpHrService {
    * 获取员工档案字段信息.
    * <p>
    * 请求方式：POST（HTTPS）
-   * 请求地址：https://qyapi.weixin.qq.com/cgi-bin/hr/get_fields?access_token=ACCESS_TOKEN
+   * 请求地址：<a href="https://qyapi.weixin.qq.com/cgi-bin/hr/get_fields?access_token=ACCESS_TOKEN">...</a>
    * 权限说明：
    * 需要配置人事助手的secret，调用接口前需给对应成员赋予人事小助手应用的权限。
    *
@@ -33,22 +33,30 @@ public interface WxCpHrService {
    * 获取员工档案数据.
    * <p>
    * 请求方式：POST（HTTPS）
-   * 请求地址：https://qyapi.weixin.qq.com/cgi-bin/hr/get_staff_info?access_token=ACCESS_TOKEN
+   * 请求地址：<a href="https://qyapi.weixin.qq.com/cgi-bin/hr/get_staff_info?access_token=ACCESS_TOKEN">...</a>
    * 权限说明：
    * 需要配置人事助手的secret，调用接口前需给对应成员赋予人事小助手应用的权限。
    *
    * @param userid 员工userid
-   * @param fields 指定字段key列表，不填则返回全部字段
+   * @param fields 指定字段key列表
    * @return 员工档案数据响应 wx cp hr employee field data resp
    * @throws WxErrorException the wx error exception
    */
   WxCpHrEmployeeFieldDataResp getEmployeeFieldInfo(String userid, List<String> fields) throws WxErrorException;
 
+  /**
+   * 获取员工档案数据.
+   * <p>
+   * 请求方式：POST（HTTPS）
+   * 请求地址：<a href="https://qyapi.weixin.qq.com/cgi-bin/hr/get_staff_info?access_token=ACCESS_TOKEN">...</a>
+   */
+  WxCpHrEmployeeFieldDataResp getEmployeeFieldInfo(String userid, boolean getAll, List<String> fields) throws WxErrorException;
+
   /**
    * 更新员工档案数据.
    * <p>
    * 请求方式：POST（HTTPS）
-   * 请求地址：https://qyapi.weixin.qq.com/cgi-bin/hr/update_staff_info?access_token=ACCESS_TOKEN
+   * 请求地址：<a href="https://qyapi.weixin.qq.com/cgi-bin/hr/update_staff_info?access_token=ACCESS_TOKEN">...</a>
    * 权限说明：
    * 需要配置人事助手的secret，调用接口前需给对应成员赋予人事小助手应用的权限。
    *
diff --git a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpHrServiceImpl.java b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpHrServiceImpl.java
index 9daf20d86..df71643d4 100644
--- a/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpHrServiceImpl.java
+++ b/weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpHrServiceImpl.java
@@ -40,11 +40,17 @@ public class WxCpHrServiceImpl implements WxCpHrService {
 
   @Override
   public WxCpHrEmployeeFieldDataResp getEmployeeFieldInfo(String userid, List<String> fields) throws WxErrorException {
+    return getEmployeeFieldInfo(userid, false, fields);
+  }
+
+  @Override
+  public WxCpHrEmployeeFieldDataResp getEmployeeFieldInfo(String userid, boolean getAll, List<String> fields) throws WxErrorException {
     if (userid == null || userid.trim().isEmpty()) {
       throw new IllegalArgumentException("userid 不能为空");
     }
     JsonObject jsonObject = new JsonObject();
     jsonObject.addProperty("userid", userid);
+    jsonObject.addProperty("get_all", getAll);
     if (fields != null && !fields.isEmpty()) {
       jsonObject.add("fields", WxCpGsonBuilder.create().toJsonTree(fields));
     }