自定义时间轴

人员档案支持创建自定义时间轴对象，支持在开放平台更新自定义时间轴对象。一条自定义时间轴记录可以有多个版本，更新时要针对对应的版本做更新。

接口简介

查询人员接口

批量查询员工信息

自定义时间轴分组查询方式与更新和普通自定义分组类似。

更新人员接口：

URL：open-apis/corehr/v2/employees/:employment_id

该接口还处于灰度阶段，灰度内租户可以使用。

功能简介

时间轴对象查询可以一次查询所有版本。 版本写操作包括新增、更正、撤销，写操作每次只能写一个版本。 与普通自定义对象不同的是，写操作时需要有三个额外参数：wk_id,wk_tid,_append_type。其中wk_id表示，wk_tid表示版本id，_append_type表示操作类型。

参数	值	获取方式	必填属性
wk_id	对象记录id	从“查询人员”接口获取	新增第一个版本时不填，新增其它版本时必填
wk_tid	版本id	从“查询人员”接口获取	更正、撤销时必填
_append_type	操作类型	根据是新增、更正、撤销 分别传入："_append_"、"_update_"、"_remove_"	必填

读写Demo

查询人员接口

与普通自定义对象类似，自定义时间轴分组会额外返回wk_tid。

更新人员接口

注意：下面使用的域名和数据均为测试数据，使用时需要替换为自己的域名和数据

新增第一个版本

• custom_groups中"custom_obj_7293841034264462892_1713343313_7293641346149138452__c"对应分组新增一个版本

curl --location --request PUT 'https://open.feishu-boe.cn/open-apis/corehr/v2/employees/7332037633013253676?user_id_type=people_corehr_id' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxx' \
--data '{"personal_info":{"personal_basic_info":{"custom_fields":[{"field_name":"buerceshi_7293641346149138452__c","value":"abcdefg"}]},"custom_groups":[{"group_name":"custom_obj_7293841034264462892_1712715147_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"wenben1_7293641346149138452__c","value":"hello123"}]}]},{"group_name":"custom_obj_7293841034264462892_1713343313_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"_append_type","value":"_append_"},{"field_name":"effective_time","value":"2024-03-02"},{"field_name":"zidingyidanxingwenben_729364134614913845__c","value":"文本12345"}]}]}]},"employment_info":{"basic_info":{"custom_fields":[{"field_name":"kpdanxingwenben_7293641346149138452__c","value":"test000"}]},"custom_groups":[{"group_name":"custom_obj_7293841027780068908_1713343556_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"danxingwenbenbitian_7293641346149138452__c","value":"这是工作信息下的单行文本。。。。"}]}]}]},"update_fields":["personal_info.personal_basic_info.custom_fields","personal_info.custom_groups","employment_info.basic_info.custom_fields"]}'

新增其它版本

curl --location --request PUT 'https://open.feishu-boe.cn/open-apis/corehr/v2/employees/7332037633013253676?user_id_type=people_corehr_id' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxx' \
--data '{"personal_info":{"personal_basic_info":{"custom_fields":[{"field_name":"buerceshi_7293641346149138452__c","value":"abcdefg"}]},"custom_groups":[{"group_name":"custom_obj_7293841034264462892_1712715147_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"wenben1_7293641346149138452__c","value":"hello123"}]}]},{"group_name":"custom_obj_7293841034264462892_1713343313_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"_append_type","value":"_append_"},{"field_name":"wk_id","value":"7365475672397743660"},{"field_name":"effective_time","value":"2024-03-03"},{"field_name":"zidingyidanxingwenben_729364134614913845__c","value":"文本12345"}]}]}]},"employment_info":{"basic_info":{"custom_fields":[{"field_name":"kpdanxingwenben_7293641346149138452__c","value":"test000"}]},"custom_groups":[{"group_name":"custom_obj_7293841027780068908_1713343556_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"danxingwenbenbitian_7293641346149138452__c","value":"这是工作信息下的单行文本。。。。"}]}]}]},"update_fields":["personal_info.personal_basic_info.custom_fields","personal_info.custom_groups","employment_info.basic_info.custom_fields"]}'

更正一个版本

curl --location --request PUT 'https://open.feishu-boe.cn/open-apis/corehr/v2/employees/7332037633013253676?user_id_type=people_corehr_id' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxx' \
--data '{"personal_info":{"personal_basic_info":{"custom_fields":[{"field_name":"buerceshi_7293641346149138452__c","value":"abcdefg"}]},"custom_groups":[{"group_name":"custom_obj_7293841034264462892_1712715147_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"wenben1_7293641346149138452__c","value":"hello123"}]}]},{"group_name":"custom_obj_7293841034264462892_1713343313_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"_append_type","value":"_update_"},{"field_name":"wk_id","value":"7365475672397743660"},{"field_name":"wk_tid","value":"7365491118376322604"},{"field_name":"effective_time","value":"2024-03-03"},{"field_name":"zidingyidanxingwenben_729364134614913845__c","value":"文本12345678"}]}]}]},"employment_info":{"basic_info":{"custom_fields":[{"field_name":"kpdanxingwenben_7293641346149138452__c","value":"test000"}]},"custom_groups":[{"group_name":"custom_obj_7293841027780068908_1713343556_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"danxingwenbenbitian_7293641346149138452__c","value":"这是工作信息下的单行文本。。。。"}]}]}]},"update_fields":["personal_info.personal_basic_info.custom_fields","personal_info.custom_groups","employment_info.basic_info.custom_fields"]}'

撤销一个版本

• 时间轴对象如果存在多个版本时，第一个版本不支持撤销

curl --location --request PUT 'https://open.feishu-boe.cn/open-apis/corehr/v2/employees/7332037633013253676?user_id_type=people_corehr_id' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxx' \
--data '{"personal_info":{"personal_basic_info":{"custom_fields":[{"field_name":"buerceshi_7293641346149138452__c","value":"abcdefg"}]},"custom_groups":[{"group_name":"custom_obj_7293841034264462892_1712715147_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"wenben1_7293641346149138452__c","value":"hello123"}]}]},{"group_name":"custom_obj_7293841034264462892_1713343313_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"_append_type","value":"_remove_"},{"field_name":"wk_id","value":"7365475672397743660"},{"field_name":"wk_tid","value":"7365491118376322604"},{"field_name":"effective_time","value":"2024-03-03"},{"field_name":"zidingyidanxingwenben_729364134614913845__c","value":"文本12345678"}]}]}]},"employment_info":{"basic_info":{"custom_fields":[{"field_name":"kpdanxingwenben_7293641346149138452__c","value":"test000"}]},"custom_groups":[{"group_name":"custom_obj_7293841027780068908_1713343556_7293641346149138452__c","items":[{"custom_fields":[{"field_name":"danxingwenbenbitian_7293641346149138452__c","value":"这是工作信息下的单行文本。。。。"}]}]}]},"update_fields":["personal_info.personal_basic_info.custom_fields","personal_info.custom_groups","employment_info.basic_info.custom_fields"]}'