Employee (larksuite-oapi 2.8.5 API)

java.lang.Object
- com.lark.oapi.service.corehr.v2.resource.Employee

```
public class Employee
extends Object
```

构造器概要

构造器
构造器和说明

Employee(Config config)

构造器
构造器和说明
`Employee(Config config)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`BatchGetEmployeeResp`	`batchGet(BatchGetEmployeeReq req)` 批量查询员工信息，通过员工 ID 、个人信息 ID、工作邮箱等筛选项批量查询员工的工作信息、个人信息。
`BatchGetEmployeeResp`	`batchGet(BatchGetEmployeeReq req, RequestOptions reqOptions)` 批量查询员工信息，通过员工 ID 、个人信息 ID、工作邮箱等筛选项批量查询员工的工作信息、个人信息。
`CreateEmployeeResp`	`create(CreateEmployeeReq req)` 添加人员，支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息 - 此接口参数校验规则与【人事系统-人员档案配置】的校验规则一致，字段是否必填以【人事系统-人员档案配置】为准。
`CreateEmployeeResp`	`create(CreateEmployeeReq req, RequestOptions reqOptions)` 添加人员，支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息 - 此接口参数校验规则与【人事系统-人员档案配置】的校验规则一致，字段是否必填以【人事系统-人员档案配置】为准。
`SearchEmployeeResp`	`search(SearchEmployeeReq req)` 搜索员工信息，查询员工的工作信息、个人信息等数据 - 请求体入参不填写默认为空;- 所有筛选项可一起使用，之间为 AND 关系;- 字段未返回请检查：字段权限、用户该字段有值，以及飞书人事档案配置中字段是否启用;- 在人事系统开启【复用工号】后，存在一个工号对应多个员工的情况，请勿依赖工号做唯一性检查;- 基于 `id_type` 类型字段（如 employment_id），在部分转换失败（ID映射不存在）的场景会返回 lark_id，无法区分值是否为对应 `id_type`。
`SearchEmployeeResp`	`search(SearchEmployeeReq req, RequestOptions reqOptions)` 搜索员工信息，查询员工的工作信息、个人信息等数据 - 请求体入参不填写默认为空;- 所有筛选项可一起使用，之间为 AND 关系;- 字段未返回请检查：字段权限、用户该字段有值，以及飞书人事档案配置中字段是否启用;- 在人事系统开启【复用工号】后，存在一个工号对应多个员工的情况，请勿依赖工号做唯一性检查;- 基于 `id_type` 类型字段（如 employment_id），在部分转换失败（ID映射不存在）的场景会返回 lark_id，无法区分值是否为对应 `id_type`。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Employee
```
public Employee(Config config)
```
- 方法详细资料
  - batchGet
```
public BatchGetEmployeeResp batchGet(BatchGetEmployeeReq req,
                                     RequestOptions reqOptions)
                              throws Exception
```
    批量查询员工信息，通过员工 ID 、个人信息 ID、工作邮箱等筛选项批量查询员工的工作信息、个人信息。
    - 字段未返回请检查：字段权限、用户该字段有值，以及飞书人事档案配置中字段是否启用;- 基于 `id_type` 类型字段（如 employment_id），在部分转换失败（ID映射不存在）的场景会返回 lark_id，无法区分值是否为对应 `id_type`。新增相关 id_v2 的字段，在转换失败时返回空值，用于区分是否转换成功；正常情况下两个字段的值是没有区别的，建议使用 id_v2 的字段;- 在人事系统开启【复用工号】后，存在一个工号对应多个员工的情况，请勿依赖工号做唯一性检查; ;;该接口会按照应用拥有的「员工数据」的权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限」中有申请「员工资源」权限范围;- 每次最多传 100 个员工 ID，若需单次查询全量员工，可使用接口[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search);- 由于人员全数据关联较多业务数据和计算数据等，更新后存在2-5s短暂延时，建议数据更新动作完成后稍等几秒进行最新数据查询请求;- 当员工未完成入职时，该接口将无法查询到该员工数据，如【待入职】【撤销入职】【删除雇佣】等情况;- 部分计算字段是在凌晨零点进行计算，建议不要在零点时间段进行查询 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_get&project=corehr&resource=employee&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/BatchGetEmployeeSample.java ;
    
    抛出:
    
    Exception
  - batchGet
```
public BatchGetEmployeeResp batchGet(BatchGetEmployeeReq req)
                              throws Exception
```
    批量查询员工信息，通过员工 ID 、个人信息 ID、工作邮箱等筛选项批量查询员工的工作信息、个人信息。
    - 字段未返回请检查：字段权限、用户该字段有值，以及飞书人事档案配置中字段是否启用;- 基于 `id_type` 类型字段（如 employment_id），在部分转换失败（ID映射不存在）的场景会返回 lark_id，无法区分值是否为对应 `id_type`。新增相关 id_v2 的字段，在转换失败时返回空值，用于区分是否转换成功；正常情况下两个字段的值是没有区别的，建议使用 id_v2 的字段;- 在人事系统开启【复用工号】后，存在一个工号对应多个员工的情况，请勿依赖工号做唯一性检查; ;;该接口会按照应用拥有的「员工数据」的权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限」中有申请「员工资源」权限范围;- 每次最多传 100 个员工 ID，若需单次查询全量员工，可使用接口[【搜索员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/search);- 由于人员全数据关联较多业务数据和计算数据等，更新后存在2-5s短暂延时，建议数据更新动作完成后稍等几秒进行最新数据查询请求;- 当员工未完成入职时，该接口将无法查询到该员工数据，如【待入职】【撤销入职】【删除雇佣】等情况;- 部分计算字段是在凌晨零点进行计算，建议不要在零点时间段进行查询 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_get&project=corehr&resource=employee&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/BatchGetEmployeeSample.java ;
    
    抛出:
    
    Exception
  - create
```
public CreateEmployeeResp create(CreateEmployeeReq req,
                                 RequestOptions reqOptions)
                          throws Exception
```
    添加人员，支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息
    - 此接口参数校验规则与【人事系统-人员档案配置】的校验规则一致，字段是否必填以【人事系统-人员档案配置】为准。建议参照【飞书人事-我的团队-添加人员】页面来传参;- 若开启工号自动编码规则则无需输入人员“工号”，系统将自动进行工号生成；若手动输入工号，则会按照手动输入工号内容进行人员档案建立 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=corehr&resource=employee&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/CreateEmployeeSample.java ;
    
    抛出:
    
    Exception
  - create
```
public CreateEmployeeResp create(CreateEmployeeReq req)
                          throws Exception
```
    添加人员，支持在单个接口中进行人员全信息添加，包括人员的基本信息，雇佣信息，入职任职记录及其他分组信息
    - 此接口参数校验规则与【人事系统-人员档案配置】的校验规则一致，字段是否必填以【人事系统-人员档案配置】为准。建议参照【飞书人事-我的团队-添加人员】页面来传参;- 若开启工号自动编码规则则无需输入人员“工号”，系统将自动进行工号生成；若手动输入工号，则会按照手动输入工号内容进行人员档案建立 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=corehr&resource=employee&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/CreateEmployeeSample.java ;
    
    抛出:
    
    Exception
  - search
```
public SearchEmployeeResp search(SearchEmployeeReq req,
                                 RequestOptions reqOptions)
                          throws Exception
```
    搜索员工信息，查询员工的工作信息、个人信息等数据
    - 请求体入参不填写默认为空;- 所有筛选项可一起使用，之间为 AND 关系;- 字段未返回请检查：字段权限、用户该字段有值，以及飞书人事档案配置中字段是否启用;- 在人事系统开启【复用工号】后，存在一个工号对应多个员工的情况，请勿依赖工号做唯一性检查;- 基于 `id_type` 类型字段（如 employment_id），在部分转换失败（ID映射不存在）的场景会返回 lark_id，无法区分值是否为对应 `id_type`。新增相关 xxx_id_v2 的字段，在转换失败时返回空值，用于区分是否转换成功；正常情况下两个字段的值是没有区别的，建议使用 id_v2 的字段;;- 该接口会按照应用拥有的「员工数据」的权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限」中有申请「员工资源」权限范围;- 接口已升级，推荐使用，性能更优。;如需继续使用旧版本接口，可点击[ 查询单个雇佣信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/employment/get) [ 查询单个个人信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/person/get);- 本接口关联数据库更新存在5分钟延迟，若希望获取刚更新的数据内容请延缓请求;- 当员工未完成入职时，该接口将无法查询到该员工数据，如【待入职】【撤销入职】【删除雇佣】等情况;- 部分计算字段是在凌晨零点进行计算，建议不要在零点时间段进行查询; ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=search&project=corehr&resource=employee&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/SearchEmployeeSample.java ;
    
    抛出:
    
    Exception
  - search
```
public SearchEmployeeResp search(SearchEmployeeReq req)
                          throws Exception
```
    搜索员工信息，查询员工的工作信息、个人信息等数据
    - 请求体入参不填写默认为空;- 所有筛选项可一起使用，之间为 AND 关系;- 字段未返回请检查：字段权限、用户该字段有值，以及飞书人事档案配置中字段是否启用;- 在人事系统开启【复用工号】后，存在一个工号对应多个员工的情况，请勿依赖工号做唯一性检查;- 基于 `id_type` 类型字段（如 employment_id），在部分转换失败（ID映射不存在）的场景会返回 lark_id，无法区分值是否为对应 `id_type`。新增相关 xxx_id_v2 的字段，在转换失败时返回空值，用于区分是否转换成功；正常情况下两个字段的值是没有区别的，建议使用 id_v2 的字段;;- 该接口会按照应用拥有的「员工数据」的权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限」中有申请「员工资源」权限范围;- 接口已升级，推荐使用，性能更优。;如需继续使用旧版本接口，可点击[ 查询单个雇佣信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/employment/get) [ 查询单个个人信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/person/get);- 本接口关联数据库更新存在5分钟延迟，若希望获取刚更新的数据内容请延缓请求;- 当员工未完成入职时，该接口将无法查询到该员工数据，如【待入职】【撤销入职】【删除雇佣】等情况;- 部分计算字段是在凌晨零点进行计算，建议不要在零点时间段进行查询; ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=search&project=corehr&resource=employee&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/SearchEmployeeSample.java ;
    
    抛出:
    
    Exception

类 Employee

构造器概要

方法概要

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

构造器详细资料

Employee

方法详细资料

batchGet

batchGet

create

create

search

search