添加需求/缺陷和多个用例关联关系 - BatchAddRelationsByOneWorkItem
功能介绍
此接口用于将多个用例批量和需求/缺陷做关联,同页面 测试 -> 测试用例 -> 选中多个用例 -> 批量关联需求
调用方法
请参见如何调用API。
URI
POST /v4/workitems/{work_item_id}/relations/testrelation
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
work_item_id |
是 |
String |
需求/缺陷id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
relations |
否 |
Array of RelationInfo objects |
关联信息 |
|
tracker_id |
否 |
String |
工作项类型id |
|
version_uri |
否 |
String |
版本uri |
|
task_uri |
否 |
String |
测试套id |
|
add_to_iterator |
否 |
Boolean |
是否将需求添加到迭代 |
|
project_uuid |
是 |
String |
项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
dr_number |
是 |
String |
需求id |
|
test_case_uri |
否 |
String |
用例uri |
|
relate_type |
是 |
String |
参数解释: 关联关系类型 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
resource_type |
否 |
String |
参数解释: 资源类型 约束限制: 不涉及 取值范围:
默认取值: TestCase |
|
source_system |
否 |
String |
来源系统 |
|
association_number |
否 |
String |
关联资源编号 |
|
region |
否 |
String |
逻辑region，外部使用公有云实际区域，内部使用默认值 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
参数解释: 调用此接口的响应状态。 取值范围:
|
|
result |
ResultValueString object |
请求返回的数据 |
|
error |
ApiError object |
错误信息 |
|
request_id |
String |
由接口调用方传入，建议使用UUID保证请求的唯一性。 |
|
server_address |
String |
本次请求的受理的服务地址 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 |
|
value |
String |
实际的数据类型：单个对象，集合 或 NULL |
|
reason |
String |
业务失败的提示内容 |
|
page_size |
Integer |
分页大小 |
|
page_no |
Integer |
分页编码 |
|
has_more |
Boolean |
是否有更多 |
状态码：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
ok
{
"result" : "success"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
ok |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server Error |
错误码
请参见错误码。
