添加需求/缺陷和多个用例关联关系 - BatchAddRelationsByOneWorkItem
功能介绍
此接口用于将多个用例批量和需求/缺陷做关联,同页面 测试 -> 测试用例 -> 选中多个用例 -> 批量关联需求
调用方法
请参见如何调用API。
URI
POST /v4/workitems/{work_item_id}/relations/testrelation
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| work_item_id | 是 | String | 需求/缺陷id 获取方法： 从req系统获取 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| relations | 是 | Array of RelationInfo objects | 参数解释 关联关系 约束限制 数组长度为1-100 取值范围 不涉及 默认取值 不涉及 |
| tracker_id | 否 | String | 参数解释 工作项类型id 约束限制 1到20位数字 取值范围 不涉及 默认取值 不涉及 |
| version_uri | 否 | String | 参数解释 分支或者迭代uri，用于指定用例所属的分支或测试计划。获取方式请参见获取分支列表接口或查询测试计划列表接口 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| task_uri | 否 | String | 参数解释 测试套id 约束限制 11到32位英文或数字 取值范围 字符串类型，长度为11-34位的字母或数字 默认取值 不涉及 |
| add_to_iterator | 否 | Boolean | 参数解释 是否将需求添加到迭代 约束限制 11到34位英文或数字 取值范围 不涉及 默认取值 不涉及 |
| project_uuid | 是 | String | 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制 不涉及 取值范围 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| dr_number | 是 | String | 参数解释 需求id 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| test_case_uri | 是 | String | 参数解释 用例uri 约束限制 不涉及 取值范围 11到34位英文或数字 默认取值 不涉及 |
| relate_type | 是 | String | 参数解释: 资源类型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| resource_type | 否 | String | 参数解释: 资源类型 取值范围: 默认取值: 不涉及 |
| source_system | 否 | String | 参数解释 来源系统 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| association_number | 否 | String | 参数解释 关联资源编号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| region | 否 | String | 参数解释 逻辑region，外部使用公有云实际区域，内部使用默认值 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| value | String | 参数解释 请求返回的数据 取值范围 不涉及 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
请求示例
post https://{endpoint}/v4/workitems/1141659003163119616/relations/testrelation
{
"project_uuid" : "407ac57de7ea44d28e47293a2b9cf15c",
"version_uri" : "v90200010aelu5om",
"relations" : [ {
"dr_number" : "1141659003163119616",
"test_case_uri" : "v90100010i5o9atn",
"relate_type" : "bug"
}, {
"dr_number" : "1141659003163119616",
"test_case_uri" : "v90310i5nma7355e",
"relate_type" : "bug"
} ]
} 响应示例
状态码：200
{
"result" : "success"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | ok |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |
| 500 | Internal Server Error |
错误码
请参见错误码。
