CustomOrg (larksuite-oapi 2.8.5 API)

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

```
public class CustomOrg
extends Object
```

构造器概要

构造器
构造器和说明

CustomOrg(Config config)

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

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`ActiveCustomOrgResp`	`active(ActiveCustomOrgReq req)` 启用/停用自定义组织，对自定义组织进行启用或停用操作 - 停用自定义组织时请确认有无在职员工、异动单据、待入职单据关联此自定义组织，如有会导致停用失败。
`ActiveCustomOrgResp`	`active(ActiveCustomOrgReq req, RequestOptions reqOptions)` 启用/停用自定义组织，对自定义组织进行启用或停用操作 - 停用自定义组织时请确认有无在职员工、异动单据、待入职单据关联此自定义组织，如有会导致停用失败。
`CreateCustomOrgResp`	`create(CreateCustomOrgReq req)` 创建自定义组织，使用指定信息创建自定义组织，接口内会做相关规则校验。
`CreateCustomOrgResp`	`create(CreateCustomOrgReq req, RequestOptions reqOptions)` 创建自定义组织，使用指定信息创建自定义组织，接口内会做相关规则校验。
`DeleteOrgCustomOrgResp`	`deleteOrg(DeleteOrgCustomOrgReq req)` 删除自定义组织，根据传入的自定义组织 ID 删除相应自定义组织 - 删除后无法恢复，并且在系统中无法搜索到对应自定义组织信息，请谨慎操作。
`DeleteOrgCustomOrgResp`	`deleteOrg(DeleteOrgCustomOrgReq req, RequestOptions reqOptions)` 删除自定义组织，根据传入的自定义组织 ID 删除相应自定义组织 - 删除后无法恢复，并且在系统中无法搜索到对应自定义组织信息，请谨慎操作。
`PatchCustomOrgResp`	`patch(PatchCustomOrgReq req)` 更新自定义组织基础信息，更新一个自定义组织基础信息，不支持更新自动匹配规则，如需更新自动匹配规则请使用[更新匹配规则](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/custom_org/update_rule) 如果是新建版本时，会将停用版本更新为启用版本;;- 非必填字段，不传时即不做变更。
`PatchCustomOrgResp`	`patch(PatchCustomOrgReq req, RequestOptions reqOptions)` 更新自定义组织基础信息，更新一个自定义组织基础信息，不支持更新自动匹配规则，如需更新自动匹配规则请使用[更新匹配规则](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/custom_org/update_rule) 如果是新建版本时，会将停用版本更新为启用版本;;- 非必填字段，不传时即不做变更。
`QueryCustomOrgResp`	`query(QueryCustomOrgReq req)` 批量查询当前版本的自定义组织信息，根据传入的筛选条件批量查询自定义组织信息。
`QueryCustomOrgResp`	`query(QueryCustomOrgReq req, RequestOptions reqOptions)` 批量查询当前版本的自定义组织信息，根据传入的筛选条件批量查询自定义组织信息。
`QueryRecentChangeCustomOrgResp`	`queryRecentChange(QueryRecentChangeCustomOrgReq req)` 查询当前生效信息发生变更的自定义组织，查询指定时间范围内当前生效信息发生变更的自定义组织，即只有部门当前生效版本的生效时间在查询时间范围内，才返回该自定义组织id - 时间窗支持大范围查询，限定查询范围在90天以内，例如要查询2020年1月1日至2020年6月30日的数据，建议分成两次查询，分别为2020年1月1日至2020年3月31日，2020年4月1日至2020年6月30日，不建议查询大时间范围数据 ;- 未来生效的版本数据，会在生效日期当天凌晨产生变更事件。
`QueryRecentChangeCustomOrgResp`	`queryRecentChange(QueryRecentChangeCustomOrgReq req, RequestOptions reqOptions)` 查询当前生效信息发生变更的自定义组织，查询指定时间范围内当前生效信息发生变更的自定义组织，即只有部门当前生效版本的生效时间在查询时间范围内，才返回该自定义组织id - 时间窗支持大范围查询，限定查询范围在90天以内，例如要查询2020年1月1日至2020年6月30日的数据，建议分成两次查询，分别为2020年1月1日至2020年3月31日，2020年4月1日至2020年6月30日，不建议查询大时间范围数据 ;- 未来生效的版本数据，会在生效日期当天凌晨产生变更事件。
`UpdateRuleCustomOrgResp`	`updateRule(UpdateRuleCustomOrgReq req)` 更新自定义组织的匹配规则，更新自定义组织的匹配规则。
`UpdateRuleCustomOrgResp`	`updateRule(UpdateRuleCustomOrgReq req, RequestOptions reqOptions)` 更新自定义组织的匹配规则，更新自定义组织的匹配规则。

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

- 构造器详细资料
  - CustomOrg
```
public CustomOrg(Config config)
```
- 方法详细资料
  - active
```
public ActiveCustomOrgResp active(ActiveCustomOrgReq req,
                                  RequestOptions reqOptions)
                           throws Exception
```
    启用/停用自定义组织，对自定义组织进行启用或停用操作
    - 停用自定义组织时请确认有无在职员工、异动单据、待入职单据关联此自定义组织，如有会导致停用失败。;- 若启/停用的生效时间当天不存在版本则会自动生成一个版本。;- 若启/停用的生效时间当天存在版本则会修改该版本。 ;- 如果该自定义组织设置了自动匹配规则，该规则也会同时被停用。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=active&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/ActiveCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - active
```
public ActiveCustomOrgResp active(ActiveCustomOrgReq req)
                           throws Exception
```
    启用/停用自定义组织，对自定义组织进行启用或停用操作
    - 停用自定义组织时请确认有无在职员工、异动单据、待入职单据关联此自定义组织，如有会导致停用失败。;- 若启/停用的生效时间当天不存在版本则会自动生成一个版本。;- 若启/停用的生效时间当天存在版本则会修改该版本。 ;- 如果该自定义组织设置了自动匹配规则，该规则也会同时被停用。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=active&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/ActiveCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - create
```
public CreateCustomOrgResp create(CreateCustomOrgReq req,
                                  RequestOptions reqOptions)
                           throws Exception
```
    创建自定义组织，使用指定信息创建自定义组织，接口内会做相关规则校验。
    - 每种自定义组织都可以通过此接口创建，不同种自定义组织通过不同 object_api_name 区分。;- 非必填字段，不传时默认为空。;- 此接口字段是否必填以【飞书人事-组织配置】为准。建议参照【飞书人事-组织管理-自定义组织-新建】页面来传参 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/CreateCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - create
```
public CreateCustomOrgResp create(CreateCustomOrgReq req)
                           throws Exception
```
    创建自定义组织，使用指定信息创建自定义组织，接口内会做相关规则校验。
    - 每种自定义组织都可以通过此接口创建，不同种自定义组织通过不同 object_api_name 区分。;- 非必填字段，不传时默认为空。;- 此接口字段是否必填以【飞书人事-组织配置】为准。建议参照【飞书人事-组织管理-自定义组织-新建】页面来传参 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/CreateCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - deleteOrg
```
public DeleteOrgCustomOrgResp deleteOrg(DeleteOrgCustomOrgReq req,
                                        RequestOptions reqOptions)
                                 throws Exception
```
    删除自定义组织，根据传入的自定义组织 ID 删除相应自定义组织
    - 删除后无法恢复，并且在系统中无法搜索到对应自定义组织信息，请谨慎操作。;- 删除自定义组织时请确认有无员工、异动单据、待入职单据关联此自定义组织，如有会导致删除失败。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete_org&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/DeleteOrgCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - deleteOrg
```
public DeleteOrgCustomOrgResp deleteOrg(DeleteOrgCustomOrgReq req)
                                 throws Exception
```
    删除自定义组织，根据传入的自定义组织 ID 删除相应自定义组织
    - 删除后无法恢复，并且在系统中无法搜索到对应自定义组织信息，请谨慎操作。;- 删除自定义组织时请确认有无员工、异动单据、待入职单据关联此自定义组织，如有会导致删除失败。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=delete_org&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/DeleteOrgCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - patch
```
public PatchCustomOrgResp patch(PatchCustomOrgReq req,
                                RequestOptions reqOptions)
                         throws Exception
```
    更新自定义组织基础信息，更新一个自定义组织基础信息，不支持更新自动匹配规则，如需更新自动匹配规则请使用[更新匹配规则](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/custom_org/update_rule)
    如果是新建版本时，会将停用版本更新为启用版本;;- 非必填字段，不传时即不做变更。;- 如果传入生效时间当天不存在版本则会自动生成一个版本。;- 如果传入生效时间当天存在版本则会修改该版本。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=patch&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/PatchCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - patch
```
public PatchCustomOrgResp patch(PatchCustomOrgReq req)
                         throws Exception
```
    更新自定义组织基础信息，更新一个自定义组织基础信息，不支持更新自动匹配规则，如需更新自动匹配规则请使用[更新匹配规则](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/custom_org/update_rule)
    如果是新建版本时，会将停用版本更新为启用版本;;- 非必填字段，不传时即不做变更。;- 如果传入生效时间当天不存在版本则会自动生成一个版本。;- 如果传入生效时间当天存在版本则会修改该版本。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=patch&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/PatchCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - query
```
public QueryCustomOrgResp query(QueryCustomOrgReq req,
                                RequestOptions reqOptions)
                         throws Exception
```
    批量查询当前版本的自定义组织信息，根据传入的筛选条件批量查询自定义组织信息。不传任何筛选条件，默认获得该租户下所有的自定义组织数据。
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - query
```
public QueryCustomOrgResp query(QueryCustomOrgReq req)
                         throws Exception
```
    批量查询当前版本的自定义组织信息，根据传入的筛选条件批量查询自定义组织信息。不传任何筛选条件，默认获得该租户下所有的自定义组织数据。
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - queryRecentChange
```
public QueryRecentChangeCustomOrgResp queryRecentChange(QueryRecentChangeCustomOrgReq req,
                                                        RequestOptions reqOptions)
                                                 throws Exception
```
    查询当前生效信息发生变更的自定义组织，查询指定时间范围内当前生效信息发生变更的自定义组织，即只有部门当前生效版本的生效时间在查询时间范围内，才返回该自定义组织id
    - 时间窗支持大范围查询，限定查询范围在90天以内，例如要查询2020年1月1日至2020年6月30日的数据，建议分成两次查询，分别为2020年1月1日至2020年3月31日，2020年4月1日至2020年6月30日，不建议查询大时间范围数据 ;- 未来生效的版本数据，会在生效日期当天凌晨产生变更事件。例如：今天为1月1日，新建自定义组织 1月10日生效，则1月10日凌晨 1点之后可查询到。;;- 默认排序条件：默认先按照组织记录 ID 增序排序，便于滚动查询;- 使用滚动查询而非分页查询，是为了防止大批量获取数据时，深分页导致超时 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query_recent_change&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryRecentChangeCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - queryRecentChange
```
public QueryRecentChangeCustomOrgResp queryRecentChange(QueryRecentChangeCustomOrgReq req)
                                                 throws Exception
```
    查询当前生效信息发生变更的自定义组织，查询指定时间范围内当前生效信息发生变更的自定义组织，即只有部门当前生效版本的生效时间在查询时间范围内，才返回该自定义组织id
    - 时间窗支持大范围查询，限定查询范围在90天以内，例如要查询2020年1月1日至2020年6月30日的数据，建议分成两次查询，分别为2020年1月1日至2020年3月31日，2020年4月1日至2020年6月30日，不建议查询大时间范围数据 ;- 未来生效的版本数据，会在生效日期当天凌晨产生变更事件。例如：今天为1月1日，新建自定义组织 1月10日生效，则1月10日凌晨 1点之后可查询到。;;- 默认排序条件：默认先按照组织记录 ID 增序排序，便于滚动查询;- 使用滚动查询而非分页查询，是为了防止大批量获取数据时，深分页导致超时 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query_recent_change&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryRecentChangeCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - updateRule
```
public UpdateRuleCustomOrgResp updateRule(UpdateRuleCustomOrgReq req,
                                          RequestOptions reqOptions)
                                   throws Exception
```
    更新自定义组织的匹配规则，更新自定义组织的匹配规则。仅开启了「为组织设置自动匹配规则」的自定义组织类型可用。如需更新自定义组织基本信息可使用[更新自定义组织](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/custom_org/patch);
    - 自定义组织规则无生效时间概念，规则变更不会生成相应版本。;- 自定义组织规则变更后不会自动生效，需要在「飞书人事-组织管理-对应自定义组织」页面右上角点击「立即计算匹配规则」按钮才会生效。或者每天 0 点自动生效。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update_rule&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/UpdateRuleCustomOrgSample.java ;
    
    抛出:
    
    Exception
  - updateRule
```
public UpdateRuleCustomOrgResp updateRule(UpdateRuleCustomOrgReq req)
                                   throws Exception
```
    更新自定义组织的匹配规则，更新自定义组织的匹配规则。仅开启了「为组织设置自动匹配规则」的自定义组织类型可用。如需更新自定义组织基本信息可使用[更新自定义组织](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/custom_org/patch);
    - 自定义组织规则无生效时间概念，规则变更不会生成相应版本。;- 自定义组织规则变更后不会自动生效，需要在「飞书人事-组织管理-对应自定义组织」页面右上角点击「立即计算匹配规则」按钮才会生效。或者每天 0 点自动生效。 ;
    官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update_rule&project=corehr&resource=custom_org&version=v2 ;
    使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/UpdateRuleCustomOrgSample.java ;
    
    抛出:
    
    Exception

类 CustomOrg

构造器概要

方法概要

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

构造器详细资料

CustomOrg

方法详细资料

active

active

create

create

deleteOrg

deleteOrg

patch

patch

query

query

queryRecentChange

queryRecentChange

updateRule

updateRule