---
title: "人员查询接口(通用接口)"
docId: "846330396695912448"
source: "https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/repository/91f5067f-775e-48f4-93a2-ce84ca0b9c2e/doc/846330396695912448"
---
| 引入 weaver-common-hrm

1. 本地接口
  
  ```java
  com.weaver.common.hrm.service.HrmCommonEmployeeService#queryEmpsByCondidtion
  ```
2. 本地分页接口
  
  ```java
  com.weaver.common.hrm.service.HrmCommonEmployeeService#pageEmpsByCondtion
  ```
3. 本地统计接口
  
  ```java
  com.weaver.common.hrm.service.HrmCommonEmployeeService#countEmpsByCondition
  ```
4. 远程接口
  
  ```java
  com.weaver.common.hrm.remote.HrmRemoteEmployeeService#queryEmpsByCondidtion
  ```
5. 远程分页接口
  
  ```java
  com.weaver.common.hrm.remote.HrmRemoteEmployeeService#pageEmpsByCondtion
  ```

- HrmOrgEmpCondition对象字段说明

| 字段名称 | 类型 | 说明 |
| --- | --- | --- |
| tenantKey | String | 租户key,必须提供 |
| subcompanyIds | List | 指定分部 |
| departmentIds | List | 指定部门 |
| locationIds | List | 指定办公地点 |
| positionList | List | 指定岗位 |
| typeList | List | 指定类型；默认内部人员；inside 内部人员，external 外部联系人 |
| superiors | List | 指定直接上级 |
| ids | List | 指定人员ID |
| channelList | List | 指定群组id |
| hireDateLists | List | 入职日期区间查询 |
| secLevelRange | HrmCommonRange | 人员安全级别区间；仅开启启用安全级别有效 |
| nameLikeList | List | 人员名称模糊查询 |
| emailRightLikeList | List | 邮箱右模糊查询 |
| userStatusList | List | 人员状态 ： normal 在职、unavailable离职 ；**默认在职** |
| outKeyList | List | outkey查询 |
| adoutKeyList | List | adoutKey查询 |
| updateTimeRange | HrmCommonRange | 修改日期范围; from和to不可以同时为空 |
| orderList | List | 指定返回人员排序:支持 employee表字段；建议先确认是否有索引 |
| containOtherDepartment | boolean | 是否包含兼职（指定分部或部门有效） |
| containSubordinates | boolean | 含下级（指定分部或部门有效） |
| containExtra | boolean | 是否包含兼职，默认不包含 |
| returnContainSubcompany | boolean | resultType=bean & 租户开启分部有效：返回信息包含人员归属分部ID |
| returnFieldList | list | 指定返回bean中字段列表；字段必须与employee表字段一致 |
| jobNumList | List | 工号 |
| nameList | List | 人员名称精确查询 |
| rehireTimeRange | HrmCommonRange | 返聘时间区间； from和to不可以同时为空 |
| mobileList | List | 手机号码 |
| userIds | List | 登录账号id列表 |

- 示例说明
  
  ```java
  // 获取部门人员
  List<Long> idList = hrmCommonEmployeeService.queryEmpsByCondidtion(
                  new HrmOrgEmpCondition()
                          .setTenantKey("T17MCVA4Z3")
                          .setDepartmentIds(Arrays.asList(8514074361485647880L, 8514074361485647880L))
                  , null);
  // 获取分部下人员
  List<Long> idList = hrmCommonEmployeeService.queryEmpsByCondidtion(
                  new HrmOrgEmpCondition()
                          .setTenantKey("T17MCVA4Z3")
                          .setSubcompanyIds(Arrays.asList(8514074361485647880L, 8514074361485647880L))
                  , null);
  // 查询部门下人员，按照拼音排序
          List<Long> orderPinyinUserIdsList = hrmCommonEmployeeService.queryEmpsByCondidtion(
                  new HrmOrgEmpCondition().setDepartmentIds(Arrays.asList(1L, 2L))
                          .setOrderList(Arrays.asList(
                                  new HrmCommonOrder().setName("pinyin").setDescType(HrmCommonOrderDescType.desc),
                                  new HrmCommonOrder().setName("dsporder").setDescType(HrmCommonOrderDescType.asc)
                          )),
                  HrmConditionResultType.ID.name()
          );
  // 人员名称模糊查询
          List<HrmEmployee> likeNameHrmEmployeeList = hrmCommonEmployeeService.queryEmpsByCondidtion(
                  new HrmOrgEmpCondition().setNameLikeList(Arrays.asList("葛", "王"))
                  .setTenantKey("1122")
                  , HrmConditionResultType.BEAN.name()
          );
  // 根据部门id+安全级别范围查询人员
          List<Long> idList = hrmCommonEmployeeService.queryEmpsByCondidtion(
                  new HrmOrgEmpCondition().setDepartmentIds(Arrays.asList(1L))
                          .setTenantKey("2244")
                          .setSecLevelRange(new HrmCommonRange<Integer>().setFrom(10).setTo(90))
                  , HrmConditionResultType.ID.name()
          );
  ```
