更新记录的执行者

aki发表于:2016年11月25日 16:50:14更新于:2021年08月09日 11:56:37

更新记录的执行者

更新记录的执行者。

  • 可在启用了流程管理的应用中使用。

  • 执行者更改之后,会在记录的更改历史记录中记录。

  • 如果指定了没有权限的用户为执行者,将报错。

  • 如果对仅可指定一名执行者的状态指定了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));



相关内容