更新工作项字段,可以支持批量更新多个字段。
接口说明
批量更新工作项字段,只支持工作项上下文字段以及自定义字段,不能更新工作项本身属性(描述,标题,状态等,这些字段选择更新工作项属性字段)。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
POST /organization/{organizationId}/workitems/updateWorkitemField
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
organizationId | string | 是 | 企业 id | 60ee8a814690c27532d412f8 |
body | object | 否 | 请求 Body | |
workitemIdentifier | string | 是 | 工作项 id,同 workitemId,工作项唯一标识 | 9144ef6b72d8exxxxx9e61a4d0 |
updateWorkitemPropertyRequest | array<object> | 是 | 更新工作项属性请求,数组形式 | |
object | 否 | 实体属性 | ||
fieldIdentifier | string | 是 | 需要更新的工作项字段 id,可以从获取工作项所有字段接口获取相应的数据 | tag |
fieldValue | string | 是 | 需要更新字段的属性值 (注:1.如果是人员类型的值必须要填写 aliyunPK。2.如果是含有待选值的字段,填写相应的待选值的 id。 3.如果多个值,需要用" , "进行分割,拼接成一个字符串。 | 个人属性 |
返回参数
示例
正常返回示例
JSON
格式
{
"requestId": "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
"errorMsg": "error",
"errorCode": "Openapi.RequestError",
"success": true,
"workitem": {
"identifier": "e8bxxxxxxxxxxxxxxxx23",
"subject": "测试工作项",
"document": "html格式",
"assignedTo": "19xx7043xxxxxxx914",
"status": "待处理",
"statusStageIdentifier": "1",
"spaceIdentifier": "e8b26xxxxx6e76aa20xxxxx23",
"spaceName": "需求项目",
"spaceType": "Project",
"logicalStatus": "NORMAL",
"categoryIdentifier": "Req",
"parentIdentifier": "e8bxxxxxxxxxxxxxxxx24",
"workitemTypeIdentifier": "9uxxxxxxre573f5xxxxxx0",
"updateStatusAt": 1640850328000,
"serialNumber": "1",
"gmtCreate": 1640850318000,
"gmtModified": 1640850318000,
"creator": "19xx7043xxxxxxx914",
"modifier": "19xx7043xxxxxxx914",
"statusIdentifier": "28",
"sprintIdentifier": "75528f17703e92e5a568......"
}
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Openapi.RequestError | request error | OpenAPI请求数据错误 |
403 | Operate.NoPermission | NoPermission | 没有权限 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|
暂无变更历史