文档首页/ 需求管理 CodeArts Req/ API参考/ API/ Scrum项目的工作项/ 修改工作项状态时联动修改对应状态的责任人
更新时间:2025-09-11 GMT+08:00
分享

修改工作项状态时联动修改对应状态的责任人

功能介绍

修改工作项状态时联动修改对应状态的责任人。

调用方法

请参见如何调用API

URI

GET /v3/workitem/{project_id}/issue-assigned/{issue_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目Id

issue_id

Integer

工作项Id

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

result

IssueAssignedByStatusResponse object

参数解释:

返回结果。

取值范围:

不涉及。

status

String

参数解释:

返回状态。

取值范围:

success:返回成功。

error:返回失败。

表3 IssueAssignedByStatusResponse

参数

参数类型

描述

configs

Array of IssueStatusConfigs objects

工作项配置信息。

表4 IssueStatusConfigs

参数

参数类型

描述

definedName

String

参数解释:

自定义状态名称。

取值范围:

不涉及。

description

String

参数解释:

自定义状态的描述。

取值范围:

不涉及。

domain_id

String

参数解释:

自定义状态的领域id。

取值范围:

不涉及。

flag

Integer

参数解释:

状态是否为自定义状态。

取值范围:

0(不是自定义状态)

1(是自定义状态)

id

String

参数解释:

自定义状态id。

取值范围:

不涉及。

is_closed

Boolean

参数解释:

自定义状态是否为结束态。

取值范围:

true(是结束态)

false(不是结束态)

is_initial

Boolean

参数解释:

自定义状态是否初始化。

取值范围:

true(是初始化)

false(不是初始化)

issue_field_configs

Array of IssueFieldConfig objects

参数解释:

工作项字段配置。

issue_status_attribute

Array of IssueStatusAttribute objects

参数解释:

工作项状态属性。

position

Integer

参数解释:

自定义状态在页面中的位置。

取值范围:

不涉及。

project_id

String

参数解释:

项目32位id,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

取值范围:

不涉及。

project_num_id

Integer

参数解释:

项目数字id。

取值范围:

不涉及。

status_attribute

Integer

参数解释:

自定义状态属性。

取值范围:

0(开始态)

1(进行态)

2(结束态)

status_attribute_name

String

参数解释:

自定义状态属性名称。

取值范围:

开始态

进行态

结束态

status_config_id

String

参数解释:

自定义状态配置id。

取值范围:

不涉及。

statusId

Integer

参数解释:

自定义状态数字id。

取值范围:

不涉及。

tracker_id

Integer

参数解释:

工作项类型。

取值范围:

2(任务/Task)

3(缺陷/Bug)

5(Epic)

6(Feature)

7(Story)

new_position

String

参数解释:

自定义状态更新后在页面中的位置。

取值范围:

不涉及。

old_position

String

参数解释:

自定义状态更新前在页面中的位置。

取值范围:

不涉及。

表5 IssueFieldConfig

参数

参数类型

描述

custom

Boolean

参数解释:

是否自定义状态。

取值范围:

true(是自定义状态)

false(不是自定义状态)

default_option

Array of OptionVOV2 objects

参数解释:

默认配置。

default_options

Array of OptionVOV2 objects

参数解释:

默认配置。

default_value

String

参数解释:

字段的默认值。

取值范围:

不涉及。

field

String

参数解释:

字段。

取值范围:

不涉及。

field_type

String

参数解释:

字段值设置类型。

取值范围:

textArea(多行文本,只能包含汉字、英文大小写字母、数字、下划线和连接符,不能超过500字符)

text(单行文本,只能包含汉字、英文大小写字母、数字、下划线和连接符,不能超过500字符)

select(下拉框,只能包含汉字、英文大小写字母、数字、下划线和连接符,每个选项最大长度40个字符,最多可定义60个选项)

number(数字,取值范围由用户创建自定义字段时设置)

date(日期,精确到年月日)

time_date,时间戳格式(示例:1839340800000)(日期精确到时分秒,长整型时间戳)

checkbox(多选框,只能包含汉字、英文大小写字母、数字、下划线和连接符,每个选项最大长度40个字符,最多可定义60个选项)

radio(单选框,只能包含汉字、英文大小写字母、数字、下划线和连接符,每个选项最大长度40个字符,最多可定义60个选项)

is_required

Integer

参数解释:

状态是否必选状态。

取值范围:

0(不是必选状态)

1(是必选状态)

is_visible

Boolean

参数解释:

状态是否可见。

取值范围:

true(可见)

false(不可见)

last

Boolean

参数解释:

状态是否处于最后位置。

取值范围:

true(最后)

false(不是最后)

name

String

参数解释:

字段名称。

取值范围:

不涉及。

option

Array of OptionVOV2 objects

参数解释:

配置。

options

String

参数解释:

字段配置。

取值范围:

不涉及。

position

Integer

参数解释:

状态在页面的位置id

取值范围:

不涉及。

project_id

String

参数解释:

项目32位id,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

取值范围:

不涉及。

tracker_list

Array of integers

参数解释:

工作项类型列表。

type_options

String

参数解释:

字段值设置类型。

取值范围:

select(可选值)

fixed_value(固定值)

表6 OptionVOV2

参数

参数类型

描述

id

String

参数解释:

选项Id。

取值范围:

不涉及。

name

String

参数解释:

选项名称。

取值范围:

不涉及。

表7 IssueStatusAttribute

参数

参数类型

描述

project_id

String

参数解释:

项目32位UUID,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

取值范围:

不涉及。

name

String

参数解释:

状态名称。

取值范围:

不涉及。

type

String

参数解释:

状态类型。

取值范围:

开始态

进行态

结束态

请求示例

/v3/workitem/a6a33eca679b435b85574bd2fde46ce7/issue-assigned/69908574

响应示例

状态码:200

工作项状态修改联动责任人接口成功的响应。

{
  "result" : {
    "configs" : [ {
      "id" : "a0efd7f835234a10a88b85bfe093ef7d",
      "status_config_id" : "a0efd7f835234a10a88b85bfe093ef7d",
      "statusId" : 2,
      "definedName" : "进行中",
      "position" : 3,
      "is_closed" : false,
      "is_initial" : false,
      "issue_field_configs" : [ {
        "custom" : false,
        "field" : "assigned_to_id",
        "name" : "处理人",
        "field_type" : "fixed_value",
        "type_options" : "select,fixed_value",
        "default_value" : "",
        "is_visible" : true,
        "position" : 1,
        "is_required" : 2,
        "last" : true,
        "options" : "1274137"
      }, {
        "custom" : false,
        "field" : "notes",
        "name" : "评论",
        "field_type" : "text",
        "type_options" : "fixed_value",
        "default_value" : "",
        "is_visible" : true,
        "position" : 2,
        "is_required" : 0,
        "last" : false,
        "options" : ""
      } ]
    } ]
  },
  "status" : "success"
}

状态码

状态码

描述

200

工作项状态修改联动责任人接口成功的响应。

错误码

请参见错误码

相关文档