com.lark.oapi.service.corehr.v2.resource

类 Position

java.lang.Object

com.lark.oapi.service.corehr.v2.resource.Position

public class Position
extends Object

构造器概要

构造器

构造器和说明
Position(Config config)

方法概要

限定符和类型	方法和说明
ActivePositionResp	active(ActivePositionReq req) 启用或停用岗位，对岗位进行启用或停用操作 官网API文档链接:	ActivePositionResp	active(ActivePositionReq req, RequestOptions reqOptions) 启用或停用岗位，对岗位进行启用或停用操作 官网API文档链接:	CreatePositionResp	create(CreatePositionReq req) 创建岗位信息，创建岗位，可定义岗位关联的职务、职级、序列，以及岗位描述等 - 非必填字段，不传时默认为空;- 此接口字段是否必填以【飞书人事-组织配置】为准。
CreatePositionResp	create(CreatePositionReq req, RequestOptions reqOptions) 创建岗位信息，创建岗位，可定义岗位关联的职务、职级、序列，以及岗位描述等 - 非必填字段，不传时默认为空;- 此接口字段是否必填以【飞书人事-组织配置】为准。
DelPositionPositionResp	delPosition(DelPositionPositionReq req) 删除岗位，删除整条岗位记录 删除后不可恢复，请谨慎操作 ; 官网API文档链接:	DelPositionPositionResp	delPosition(DelPositionPositionReq req, RequestOptions reqOptions) 删除岗位，删除整条岗位记录 删除后不可恢复，请谨慎操作 ; 官网API文档链接:	PatchPositionResp	patch(PatchPositionReq req) 更新岗位信息，更新岗位的版本信息，例如岗位关联的职务、职级、序列，以及岗位描述等 岗位在关联人员、异动、入职对象信息及建立自身上下级关系后，不允许更新部门;;- 非必填字段，不传时即不做变更;- 如果传入生效时间当天不存在版本则会自动生成一个版本。
PatchPositionResp	patch(PatchPositionReq req, RequestOptions reqOptions) 更新岗位信息，更新岗位的版本信息，例如岗位关联的职务、职级、序列，以及岗位描述等 岗位在关联人员、异动、入职对象信息及建立自身上下级关系后，不允许更新部门;;- 非必填字段，不传时即不做变更;- 如果传入生效时间当天不存在版本则会自动生成一个版本。
QueryPositionResp	query(QueryPositionReq req) 查询岗位信息，支持通过岗位 ID、部门 ID 查询岗位的详细信息，例如岗位关联的职务、职级、序列，以及岗位描述，是否关键岗位等 ;#### 限制说明:;- 在筛选 ID 和 查询字段对象个数过多时，可能出现超时现象，请减少筛选项和字段对象个数。
QueryPositionResp	query(QueryPositionReq req, RequestOptions reqOptions) 查询岗位信息，支持通过岗位 ID、部门 ID 查询岗位的详细信息，例如岗位关联的职务、职级、序列，以及岗位描述，是否关键岗位等 ;#### 限制说明:;- 在筛选 ID 和 查询字段对象个数过多时，可能出现超时现象，请减少筛选项和字段对象个数。
QueryRecentChangePositionResp	queryRecentChange(QueryRecentChangePositionReq req) 查询指定时范围内当前版本信息发生变更的岗位，查询指定时间范围内信息发生变更的岗位，仅当岗位当前生效版本的生效时间在查询时间范围内，才返回该岗位id - 时间窗支持大范围查询，限定查询范围在90天以内，例如要查询2020年1月1日至2020年6月30日的数据，建议分成两次查询，分别为2020年1月1日至2020年3月31日，2020年4月1日至2020年6月30日，不建议查询大时间范围数据 ;- 未来生效的版本数据，会在生效日期当天凌晨产生变更事件。
QueryRecentChangePositionResp	queryRecentChange(QueryRecentChangePositionReq req, RequestOptions reqOptions) 查询指定时范围内当前版本信息发生变更的岗位，查询指定时间范围内信息发生变更的岗位，仅当岗位当前生效版本的生效时间在查询时间范围内，才返回该岗位id - 时间窗支持大范围查询，限定查询范围在90天以内，例如要查询2020年1月1日至2020年6月30日的数据，建议分成两次查询，分别为2020年1月1日至2020年3月31日，2020年4月1日至2020年6月30日，不建议查询大时间范围数据 ;- 未来生效的版本数据，会在生效日期当天凌晨产生变更事件。

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

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Position

public Position(Config config)

方法详细资料

active

public ActivePositionResp active(ActivePositionReq req,
                                 RequestOptions reqOptions)
                          throws Exception

启用或停用岗位，对岗位进行启用或停用操作

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=active&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/ActivePositionSample.java ;

抛出:

Exception

active

public ActivePositionResp active(ActivePositionReq req)
                          throws Exception

启用或停用岗位，对岗位进行启用或停用操作

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=active&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/ActivePositionSample.java ;

抛出:

Exception

create

public CreatePositionResp create(CreatePositionReq req,
                                 RequestOptions reqOptions)
                          throws Exception

创建岗位信息，创建岗位，可定义岗位关联的职务、职级、序列，以及岗位描述等

- 非必填字段，不传时默认为空;- 此接口字段是否必填以【飞书人事-组织配置】为准。建议参照【飞书人事-组织管理-岗位-新建】页面来传参 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/CreatePositionSample.java ;

抛出:

Exception

create

public CreatePositionResp create(CreatePositionReq req)
                          throws Exception

创建岗位信息，创建岗位，可定义岗位关联的职务、职级、序列，以及岗位描述等

- 非必填字段，不传时默认为空;- 此接口字段是否必填以【飞书人事-组织配置】为准。建议参照【飞书人事-组织管理-岗位-新建】页面来传参 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/CreatePositionSample.java ;

抛出:

Exception

delPosition

public DelPositionPositionResp delPosition(DelPositionPositionReq req,
                                           RequestOptions reqOptions)
                                    throws Exception

删除岗位，删除整条岗位记录

删除后不可恢复，请谨慎操作 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=del_position&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/DelPositionPositionSample.java ;

抛出:

Exception

delPosition

public DelPositionPositionResp delPosition(DelPositionPositionReq req)
                                    throws Exception

删除岗位，删除整条岗位记录

删除后不可恢复，请谨慎操作 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=del_position&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/DelPositionPositionSample.java ;

抛出:

Exception

patch

public PatchPositionResp patch(PatchPositionReq req,
                               RequestOptions reqOptions)
                        throws Exception

更新岗位信息，更新岗位的版本信息，例如岗位关联的职务、职级、序列，以及岗位描述等

岗位在关联人员、异动、入职对象信息及建立自身上下级关系后，不允许更新部门;;- 非必填字段，不传时即不做变更;- 如果传入生效时间当天不存在版本则会自动生成一个版本。;- 如果传入生效时间当天存在版本则会修改该版本。 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=patch&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/PatchPositionSample.java ;

抛出:

Exception

patch

public PatchPositionResp patch(PatchPositionReq req)
                        throws Exception

更新岗位信息，更新岗位的版本信息，例如岗位关联的职务、职级、序列，以及岗位描述等

岗位在关联人员、异动、入职对象信息及建立自身上下级关系后，不允许更新部门;;- 非必填字段，不传时即不做变更;- 如果传入生效时间当天不存在版本则会自动生成一个版本。;- 如果传入生效时间当天存在版本则会修改该版本。 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=patch&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/PatchPositionSample.java ;

抛出:

Exception

query

public QueryPositionResp query(QueryPositionReq req,
                               RequestOptions reqOptions)
                        throws Exception

查询岗位信息，支持通过岗位 ID、部门 ID 查询岗位的详细信息，例如岗位关联的职务、职级、序列，以及岗位描述，是否关键岗位等

;#### 限制说明:;- 在筛选 ID 和 查询字段对象个数过多时，可能出现超时现象，请减少筛选项和字段对象个数。阻塞性问题请联系[技术支持](https://applink.feishu.cn/TLJpeNdW);- 所有筛选项可一起使用，之间为 AND 关系;- 请求体入参不填写默认为空，不参与筛选;;#### 前提条件:;- 本接口会按照「岗位资源」权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限」中已申请此数据权限; ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryPositionSample.java ;

抛出:

Exception

query

public QueryPositionResp query(QueryPositionReq req)
                        throws Exception

查询岗位信息，支持通过岗位 ID、部门 ID 查询岗位的详细信息，例如岗位关联的职务、职级、序列，以及岗位描述，是否关键岗位等

;#### 限制说明:;- 在筛选 ID 和 查询字段对象个数过多时，可能出现超时现象，请减少筛选项和字段对象个数。阻塞性问题请联系[技术支持](https://applink.feishu.cn/TLJpeNdW);- 所有筛选项可一起使用，之间为 AND 关系;- 请求体入参不填写默认为空，不参与筛选;;#### 前提条件:;- 本接口会按照「岗位资源」权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限」中已申请此数据权限; ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=corehr&resource=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryPositionSample.java ;

抛出:

Exception

queryRecentChange

public QueryRecentChangePositionResp queryRecentChange(QueryRecentChangePositionReq 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=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryRecentChangePositionSample.java ;

抛出:

Exception

queryRecentChange

public QueryRecentChangePositionResp queryRecentChange(QueryRecentChangePositionReq 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=position&version=v2 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/corehrv2/QueryRecentChangePositionSample.java ;

抛出:

Exception