# 添加需求/缺陷和多个用例关联关系 - BatchAddRelationsByOneWorkItem #### 功能介绍 此接口用于将多个用例批量和需求/缺陷做关联,同页面 测试 -\> 测试用例 -\> 选中多个用例 -\> 批量关联需求 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/workitems/{work_item_id}/relations/testrelation 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | work_item_id | 是 | String | 需求/缺陷id **获取方法**： 从req系统获取 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | 表3RelationInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dr_number | 是 | String | 需求id | | test_case_uri | 否 | String | 用例uri | | relate_type | 是 | String | **参数解释**: 关联关系类型 **约束限制**: 不涉及 **取值范围**: - bug，缺陷。 - requirement，需求。 **默认取值**: 不涉及 | | resource_type | 否 | String | **参数解释**: 资源类型 **约束限制**: 不涉及 **取值范围**: - TestCase，测试用例。 - TestItem，特性目录。 **默认取值**: TestCase | | source_system | 否 | String | 来源系统 | | association_number | 否 | String | 关联资源编号 | | region | 否 | String | 逻辑region，外部使用公有云实际区域，内部使用默认值 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。 - error，表示接口调用失败。 | | result | [ResultValueString] object | 请求返回的数据 | | error | [ApiError] object | 错误信息 | | request_id | String | 由接口调用方传入，建议使用UUID保证请求的唯一性。 | | server_address | String | 本次请求的受理的服务地址 | 表5ResultValueString | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | String | 实际的数据类型：单个对象，集合 或 NULL | | reason | String | 业务失败的提示内容 | | page_size | Integer | 分页大小 | | page_no | Integer | 分页编码 | | has_more | Boolean | 是否有更多 | 表6ApiError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 业务失败的错误编码 | | reason | String | 业务失败的提示内容 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：401** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：404** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：500** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。