com.lark.oapi.service.payroll.v1.resource

类 DatasourceRecord

java.lang.Object

com.lark.oapi.service.payroll.v1.resource.DatasourceRecord

public class DatasourceRecord
extends Object

构造器概要

构造器

构造器和说明
DatasourceRecord(Config config)

方法概要

限定符和类型	方法和说明
QueryDatasourceRecordResp	query(QueryDatasourceRecordReq req) 批量查询外部算薪数据记录，1.
QueryDatasourceRecordResp	query(QueryDatasourceRecordReq req, RequestOptions reqOptions) 批量查询外部算薪数据记录，1.
SaveDatasourceRecordResp	save(SaveDatasourceRecordReq req) 创建 / 更新外部算薪数据，参照数据源配置字段格式，批量保存（创建或更新）数据记录。
SaveDatasourceRecordResp	save(SaveDatasourceRecordReq req, RequestOptions reqOptions) 创建 / 更新外部算薪数据，参照数据源配置字段格式，批量保存（创建或更新）数据记录。

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

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

构造器详细资料

DatasourceRecord

public DatasourceRecord(Config config)

方法详细资料

query

public QueryDatasourceRecordResp query(QueryDatasourceRecordReq req,
                                       RequestOptions reqOptions)
                                throws Exception

批量查询外部算薪数据记录，1. 支持通过payroll_period（必传）、employment_id（可选）这两个预置字段，批量查询指定数据源下的数据记录列表。;2. 数据源配置信息可从[获取外部数据源配置信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/datasource/list)或者 「飞书人事后台-设置-算薪数据设置-外部数据源配置」页面 获取

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

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

抛出:

Exception

query

public QueryDatasourceRecordResp query(QueryDatasourceRecordReq req)
                                throws Exception

批量查询外部算薪数据记录，1. 支持通过payroll_period（必传）、employment_id（可选）这两个预置字段，批量查询指定数据源下的数据记录列表。;2. 数据源配置信息可从[获取外部数据源配置信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/datasource/list)或者 「飞书人事后台-设置-算薪数据设置-外部数据源配置」页面 获取

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

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

抛出:

Exception

save

public SaveDatasourceRecordResp save(SaveDatasourceRecordReq req,
                                     RequestOptions reqOptions)
                              throws Exception

创建 / 更新外部算薪数据，参照数据源配置字段格式，批量保存（创建或更新）数据记录。;1. 记录的唯一标志通过业务主键判断（employment_id + payroll_period）;2. 若不存在数据记录，则本次保存会插入1条记录。;3. 若已存在数据记录，则本次保存会覆盖更新已有记录（只更新传入字段的值，未传入字段值不更新），如果传入的数据记录没有任何变化，则不更新。;4. 若更新或者插入成功，会返回产生数据变更的记录条数。

1. 除了接口自身的限流外，还会限制单个数据源只能串行批量写入（防止批量更新同一批数据导致底层性能或者死锁风险），需调用端做好并发控制;2. 本接口如果发生报错，调用方可认为全部保存失败，不会存在部分保存失败部分成功场景。;3. 请确保写入的数据记录的数据源及字段都是被启用的。;;; ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=save&project=payroll&resource=datasource_record&version=v1 ;

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

抛出:

Exception

save

public SaveDatasourceRecordResp save(SaveDatasourceRecordReq req)
                              throws Exception

创建 / 更新外部算薪数据，参照数据源配置字段格式，批量保存（创建或更新）数据记录。;1. 记录的唯一标志通过业务主键判断（employment_id + payroll_period）;2. 若不存在数据记录，则本次保存会插入1条记录。;3. 若已存在数据记录，则本次保存会覆盖更新已有记录（只更新传入字段的值，未传入字段值不更新），如果传入的数据记录没有任何变化，则不更新。;4. 若更新或者插入成功，会返回产生数据变更的记录条数。

1. 除了接口自身的限流外，还会限制单个数据源只能串行批量写入（防止批量更新同一批数据导致底层性能或者死锁风险），需调用端做好并发控制;2. 本接口如果发生报错，调用方可认为全部保存失败，不会存在部分保存失败部分成功场景。;3. 请确保写入的数据记录的数据源及字段都是被启用的。;;; ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=save&project=payroll&resource=datasource_record&version=v1 ;

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

抛出:

Exception