细粒度权限用户创建工作项

功能介绍

拥有IAM细粒度权限（projectmanConfig:systemSettingField:set）且在devcloud项目中有创建工作项的权限的用户可以设置工作项的创建者

URI

POST /v4/projects/{project_id}/system/issue

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	devcloud项目的32位id

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数
参数	是否必选	参数类型	描述
actual_work_hours	否	Double	实际工时
assigned_id	否	Integer	处理人id,对应用户信息的数字id
begin_time	否	String	开始时间，年-月-日
description	否	String	描述信息
developer_id	否	Integer	开发者id,对应用户信息的数字id
domain_id	否	Integer	id 领域, 14 '性能', 15 '功能', 16 '可靠性' 17 '网络安全' 18 '可维护性' 19 '其他DFX' 20 '可用性'
done_ratio	否	Integer	工作项进度值
end_time	否	String	结束时间，年-月-日
expected_work_hours	否	Double	预计工时
iteration_id	否	Integer	迭代id
module_id	否	Integer	模块id
name	是	String	标题
parent_issue_id	否	Integer	父工作项的id,创建子工作项时必填，父工作项的类型tracker_id不能为2,3
priority_id	是	Integer	优先级, 1 低, 2 中, 3 高,
severity_id	否	Integer	重要程度, 10 关键, 11 重要, 12 一般, 13 提示,
status_id	否	Integer	状态 id, 新建 1, 进行中 2, 已解决 3, 测试中 4, 已关闭 5, 已拒绝 6,
tracker_id	是	Integer	工作项类型, 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story; 5 只能为 6 的父工作项类型; 6 只能为 7 的父工作项类型; 7 只能为 2,3的父;
new_custom_fields	否	Array of NewCustomField objects	用户自定义字段
creator	是	Creator object	用户信息
custom_fields	否	Array of ScrumCustomField objects	用户自定义字段

表4 NewCustomField
参数	是否必选	参数类型	描述
custom_field	否	String	自定义字段
field_name	否	String	自定义字段名称
value	否	String	自定义属性对应的值，多个值以英文逗号区分开

表5 Creator
参数	是否必选	参数类型	描述
user_id	是	String	指定工作项的创建者用户id

表6 ScrumCustomField
参数	是否必选	参数类型	描述
name	否	String	自定义字段
value	否	String	自定义字段值

响应参数

状态码：200

表7 响应Body参数
参数	参数类型	描述
actual_work_hours	Double	实际工时
assigned_cc_user	Array of IssueUser objects	抄送人
assigned_user	IssueUser object	用户信息
begin_time	String	开始时间，年-月-日
creator	IssueUser object	用户信息
custom_fields	Array of CustomField objects	自定义属性值,不建议使用，建议参考new_custom_fields字段
new_custom_fields	Array of NewCustomField objects	自定义属性值
developer	IssueUser object	用户信息
domain	domain object	id 领域, 14 '性能', 15 '功能', 16 '可靠性', 17 '网络安全', 18 '可维护性', 19 '其他DFX', 20 '可用性',
done_ratio	Integer	工作项进度值
end_time	String	结束时间，年-月-日
expected_work_hours	Double	预计工时
id	Integer	工作项项id
project	IssueProjectResponseV4 object	项目信息
iteration	iteration object	迭代
module	module object	模块
parent_issue	parent_issue object	父工作项
priority	priority object	工作项优先级
severity	severity object	工作项重要程度
status	status object	工作项状态
tracker	tracker object	工作项类型 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story

表8 IssueUser
参数	参数类型	描述
user_id	String	用户uuid
user_num_id	Integer	用户数字id
id	Integer	用户id
name	String	带租户名的用户名(租户名_用户名)
nick_name	String	昵称
first_name	String	用户名

表9 CustomField
参数	参数类型	描述
name	String	自定义属性名
value	String	自定义属性对应的值
new_name	String	自定义属性名

**表10** NewCustomField
参数	参数类型	描述
custom_field	String	自定义字段
field_name	String	自定义字段名称
value	String	自定义属性对应的值，多个值以英文逗号区分开

**表11** domain
参数	参数类型	描述
id	Integer	领域id
name	String	领域

**表12** IssueProjectResponseV4
参数	参数类型	描述
project_id	String	项目id
project_name	String	项目名称
project_num_id	Integer	项目数字id

**表13** iteration
参数	参数类型	描述
id	Integer	迭代id
name	String	迭代名

**表14** module
参数	参数类型	描述
id	Integer	模块id
name	String	模块

**表15** parent_issue
参数	参数类型	描述
id	Integer	父工作项id
name	String	父工作项

**表16** priority
参数	参数类型	描述
id	Integer	优先级id
name	String	优先级

**表17** severity
参数	参数类型	描述
id	Integer	重要程度id
name	String	重要程度

**表18** status
参数	参数类型	描述
id	Integer	状态id
name	String	状态名称

**表19** tracker
参数	参数类型	描述
id	Integer	类型id
name	String	类型名称

状态码：400

**表20** 响应Body参数
参数	参数类型	描述
error_msg	String	错误描述
error_code	String	错误码

状态码：401

**表21** 响应Body参数
参数	参数类型	描述
error_msg	String	错误描述
error_code	String	错误码

请求示例

POST https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/system/issue

{
  "parent_issue_id" : 1679822,
  "end_time" : "2018-07-05",
  "name" : "test",
  "begin_time" : "2018-1-31",
  "description" : "",
  "assigned_id" : 4091,
  "developer_id" : 4091,
  "tracker_id" : 3,
  "status_id" : 1,
  "priority_id" : 2,
  "severity_id" : 10,
  "iteration_id" : 11302238,
  "creator" : {
    "user_id" : "a360371833bf4c558f796fd707b44daf"
  }
}

响应示例

状态码：200

{
  "actual_work_hours" : 0,
  "assigned_cc_user" : [ {
    "id" : 4091,
    "name" : "demo_user_name",
    "nick_name" : "bear"
  } ],
  "assigned_user" : {
    "id" : 4091,
    "name" : "demo_user_name",
    "nick_name" : "bear"
  },
  "begin_time" : "2020-09-12",
  "creator" : {
    "id" : 4091,
    "name" : "demo_user_name",
    "nick_name" : "bear"
  },
  "custom_fields" : [ {
    "name" : "customField16",
    "value" : "多选框",
    "new_name" : "custom_field16"
  } ],
  "new_custom_fields" : [ {
    "custom_field" : "custom_field16",
    "field_name" : "field_name",
    "value" : "多选框1,多选框2"
  } ],
  "developer" : {
    "id" : 4091,
    "name" : "demo_user_name",
    "nick_name" : "bear1"
  },
  "domain" : {
    "id" : 14,
    "name" : "性能"
  },
  "done_ratio" : 0,
  "end_time" : "2020-09-19",
  "expected_work_hours" : 9,
  "id" : 4567,
  "project" : {
    "project_id" : "526cefde62004de2b62b5e8dd2c2b3af",
    "project_name" : "testDemo",
    "project_num_id" : 78953
  },
  "iteration" : {
    "id" : 456,
    "name" : "迭代1"
  },
  "module" : {
    "id" : 456,
    "name" : "Project"
  },
  "parent_issue" : {
    "id" : 123,
    "name" : "parentIssue"
  },
  "priority" : {
    "id" : 1,
    "name" : "低"
  },
  "severity" : {
    "id" : 12,
    "name" : "一般"
  },
  "status" : {
    "id" : 1,
    "name" : "新建"
  },
  "tracker" : {
    "id" : 7,
    "name" : "story"
  }
}

状态码

状态码	描述
200	OK
400	Bad Request
401	Unauthorized

错误码

请参见错误码。

父主题：Scrum项目的工作项

上一篇：查询Scrum项目的工作项流转配置

下一篇：查询当前工作项已经关联的工作项

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试