更新记录的执行者
更新记录的执行者。
可在启用了流程管理的应用中使用。
执行者更改之后，会在记录的更改历史记录中记录。
如果对仅可指定一名执行者的状态指定了2名或更多的执行者时，将报错。
URI
https://(子域名).cybozu.cn/k/v1/record/assignees.json
来宾空间内的应用
https://(子域名).cybozu.cn/k/guest/(空间的ID)/v1/record/assignees.json
HTTP 方法
PUT
必要的访问权限
应用的管理权限
应用的记录查看权限
要更新执行者的记录的查看权限
请求
参数
| 参数名称 | 要指定的值 | 必须 | 说明 |
|---|---|---|---|
| app | 数值或字符串 | 必须 | 指定应用的ID。 |
| id | 数值或字符串 | 必须 | 指定记录ID。 |
| assignees | 数组 | 必须 | 指定要设为执行者的用户的代码。 如果指定空数组，将用空值更新。 上限值为100。 |
| revision | 数值或字符串 | 指定更改前的记录的修订号。如果指定的修订号不是最新的，请求将报错。 如果省略或指定“-1”，将不对修订号进行验证。 |
请求的范例
头部
PUT /k/v1/record/assignees.json HTTP/1.1 Host: example.cybozu.cn:443 X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU= Content-Type: application/json
正文
{
"app": 1,
"id": 1,
"assignees": ["user2"],
"revision": 1
}应答
参数
| 参数名称 | 值的类型 | 说明 |
|---|---|---|
| revision | 字符串 | 更改之后的记录的修订号。 |
应答的范例
{"revision": "2"}JavaScript 范例
使用API请求发送 kintone REST API 请求
var body = {
"app": 1,
"id": 1001,
"assignees": ["user1"]
}
kintone.api(kintone.api.url('/k/v1/record/assignees', true), 'PUT', body, function(resp) {
//success
console.log(resp);
}, function(error) {
//error
console.log(error);
});使用 XMLHttpRequest 请求
var body = {
"app": 1,
"id": 1001,
"assignees": ["user1"],
// CSRF TOKEN: 在kintone中执行API(POST, PUT, DELETE)时需要设置
"__REQUEST_TOKEN__": kintone.getRequestToken()
};
var url = 'https://{subdomain}.cybozu.cn/k/v1/record/assignees.json';
var xhr = new XMLHttpRequest();
xhr.open('PUT', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function() {
if (xhr.status === 200) {
// success
console.log(JSON.parse(xhr.responseText));
} else {
// error
console.log(JSON.parse(xhr.responseText));
}
};
xhr.send(JSON.stringify(body));