# 自定义时间轴

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

## 接口简介

### 查询人员接口

[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)

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

### 更新人员接口：
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"]}'
```