导入接口自动化用例

背景信息

测试计划服务支持通过导入文件的方式生成测试用例，可导入以下类型的文件：

• Postman文件：支持Postman Collection v2.1标准，导入Postman Collection JSON文件。
• Swagger文件：支持Swagger 2.0和3.0标准，导入YAML格式文件。
• Excel文件：参照页面提供的模板编辑Excel格式文件。

导入Postman文件/Swagger文件

每次只能导入一个测试用例。导入的测试用例只能生成测试步骤，不支持生成前置步骤与后置步骤。

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 选择“接口自动化”页签，单击页面右侧“导入”，选择“从文件导入”，弹出“从文件导入用例”窗口。
4. 选择“上传Postman文件”或“上传Swagger文件”。

   从本地拖拽文件到窗口，或单击“点击添加文件”并从本地选择文件。单击“下一步”。

   

5. 在列表中根据步骤的顺序勾选需要生成用例的条目，单击“保存”。

   

导入Excel文件

通过Excel文件导入测试用例时，单次导入用例条数不超过500条。

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 选择“接口自动化”页签，单击页面右侧“导入”，在下拉菜单中选择“从文件导入”。
4. 选择“上传Excel文件”，单击“下载模板”。

   

5. 在本地打开Excel模板，根据模板中标题的批注信息编辑测试用例信息，其中带有*号列内容是必填内容。

   模板中的字段信息如下：

   字段	是否必填	说明
   用例名称	是	字符长度为1-128个字符，可以包含中文、大小写字母、数字、特殊字符（-_/|*&`'^~;；:：()（）{}=+,×￥……——’!@#$%.'[]<>?·！"、‘“”？—。，《》【】）的组合格式。
   用例描述	否	字符长度不超过500个字符。
   请求类型	是	只可输入GET、POST、PUT、DELETE四种请求类型。
   请求头参数	否	格式为“key=value”。 若存在多个参数，则参数之间使用&分割，即“key=value&key1=value1”。
   请求地址	是	请求协议支持http和https。格式为“https://ip:port/pathParam?query=1”。
   环境分组	否	对应环境参数分组。
   IP变量名	否	在对应“环境分组”中生成该变量名，提取“请求地址”内容，生成相应全局变量内容。
   请求体类型	否	支持填写raw、json、formdata，分别对应页面中文本、JSON请求体、表单参数三种请求体格式。 若未填入，则默认为json。
   请求体	否	若请求体类型为“formdata”，则请求体的格式为“key=value”。若存在多个参数，则参数之间使用&分割，即“key=value&key2=value2”。 通过Excel导入用例时，“formdata”不支持文件格式请求体。
   检查点匹配方式	否	支持精确匹配、模糊匹配。精确匹配代表“相等”，模糊匹配代表“包含”。
   期望检查点值	否	对应检查点“目标值”。

6. 保存编辑后的Excel文件，从本地拖拽文件到“从文件导入用例”窗口，或单击“点击添加文件”并从本地选择文件。单击“下一步”。
7. 查看导入结果：
   • 导入成功，列表中将新增用例，新增的用例条数与Excel中编辑的行数相同。
   • 导入失败，页面右上角会弹框提示失败。

     

     在“从文件导入用例”窗口中可下载错误列表，参照列表中的错误原因修改Excel文件，重新导入。