管理CodeArts TestPlan测试用例

导入手工测试用例

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 单击“手工测试”页签，单击页面右侧“导入”，在下拉菜单中单击“从文件导入”。

   也可以单击“全量用例”页签，单击页面右侧“导入”，在下拉菜单中单击“从文件导入”，在弹窗中选择导入用例的执行类型为“手工测试和功能自动化”。

4. 设置当用例编号重复时，是否覆盖测试用例。

   勾选“是”：若用例编号重复，新上传的用例将覆盖相同编号的用例。

   勾选“否”：即使用例编号重复，所有用例都会上传至用例列表。

5. 在弹窗中单击“下载模板”。

   按照模板中的格式要求填写用例信息，返回页面，上传编写好的用例文件，单击“确定”。

   

   • 单次导入用例条数不超过5000条。
   • 单次文件大小不超过5M。
   • 测试计划服务当前支持Excel表格格式。如果数据不符合导入标准，页面提示下载错误报告，请修改数据后重新导入。

导入接口自动化用例

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

• 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文件，重新导入。

导入自定义自动化用例

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

• Excel文件：参照页面提供的模板编辑Excel格式文件。

导出测试用例

1. 在测试用例对应页签，单击页面右侧“更多”，在下拉菜单中单击“导出”。
2. 在弹框中选择导出用例范围，可以选择“全部导出”。

   选择部分导出(起始位置选择作为表格第一行的用例，结束位置默认为用例表最后一行的用例)，单击“确定”。

   

3. 在本地打开导出的excel表格，查看导出的用例内容。

批量添加测试用例

测试计划服务支持从用例库中向测试计划批量添加用例，包括手工测试用例和接口自动化用例。

用例在线评审

用户可以对已创建的测试用例进行评审。

新建评审

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 选择对应的测试类型页签，单击需要评审用例所在行右侧的图标，单击“新建评审”。
4. 在弹框内输入配置如下信息后，单击“确定”。

   配置项	是否必填	描述
   名称	是	新建评审时，名称默认与用例名称保持一致。
   用例修改时间	是	新建评审时，时间默认为当前系统日期。
   自动评审闭环	是	用户可以勾选是否自动评审闭环。 选择"是"：表示该用例评审闭环状态会自动置为关闭状态，自动闭环。 选择"否"：表示该用例评审会走人工审批流程，需要手动闭环。
   期望闭环时间	是	当用户将自动评审闭环勾选为否，可以选择期望闭环时间。
   评审意见	是	输入不超过1000个字符的评审信息。
   指定闭环人	是	当用户将自动评审闭环勾选为否，可以在下拉栏中选择指定闭环人。

批量评审

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 在测试用例列表中勾选需要批量评审的用例。
4. 单击下方“批量评审”。
5. 在弹框中配置如下信息后，单击“确定”。
   • 自动评审闭环：选择"是"：表示该用例评审闭环状态会自动置为关闭状态，自动闭环；选择"否"：表示该用例评审会走人工审批流程，需要手动闭环。
   • 期望闭环时间：当用户将自动评审闭环勾选为否，可以选择期望闭环时间。
   • 评审意见：输入不超过1000个字符的评审信息。
   • 指定闭环人：当用户将自动评审闭环勾选为否，可以在下拉栏中选择指定闭环人。

查看评审记录

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 单击“评审记录”，完成创建的评审记录将显示在页面中。
4. 单击评审记录页面中的搜索栏，可以添加筛选条件。
5. 输入筛选条件的关键字，可以查找对应的评审记录。
6. 对未闭环的评审记录，可以进行删除、编辑和闭环操作。

   

   • 单击未闭环的评审记录操作项中的，依照提示信息单击“确认”，删除此评审记录。
   • 单击未闭环的评审记录操作项中的，在“编辑评审”弹窗中编辑评审内容。
   • 单击未闭环的评审记录操作项中的，在“闭环评审”弹窗中，选择“是否闭环”选项中的“是”，单击“确定”。

需求与测试用例

测试用例关联需求

测试用例仅可关联Scrum项目Epic/Feature/Story类型的工作项及看板项目默认的“需求”类型工作项。

测试计划服务支持测试用例与需求相关联，操作步骤如下：

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 选择需要关联需求的测试用例，单击所在行右侧的图标，选择“关联需求”。或者在“全量用例”页面中，单击需要关联需求的用例所在操作列中的图标，进行关联需求。

   若需要将多个用例与同一个需求相关联，则可在列表中勾选需要关联需求的测试用例，单击页面下方“批量关联需求”。

4. 在弹窗中勾选需要关联的需求，可以选择当前计划下的需求或在所有需求中选择。单击“确定”完成关联。

   

添加需求相关的测试用例

• 前置条件

  测试计划下的需求在用例库下已关联了测试用例。

添加需求相关的测试用例的步骤与批量添加测试用例相同，在弹出框中勾选“选择本测试计划中的需求相关的所有用例”即可。

按需求管理测试用例

在“测试用例”页面，单击页面左侧“需求目录”。

• 已关联的需求都默认归属于“需求目录”下。
• 单击“需求目录”下的某个需求，可以查看与该需求关联的所有用例。
• 单击需求名称右侧的，可以查看需求详情，也可以新建与所选需求关联的测试用例。

需求变更通知

当某个需求关联了测试用例且在需求管理服务中对该需求做出修改时，“测试用例”页面的对应需求名称会出现红点，提醒对此需求所关联用例做补充或修改。

缺陷与测试用例

测试用例执行失败时，通常会将该用例与缺陷相关联。可以新建缺陷，或者关联已存在的缺陷。

本节以手工测试用例为例介绍如何将测试用例与缺陷相关联。

测试用例仅可关联Scrum项目“Bug”类型的工作项及看板项目默认的“缺陷”类型工作项。

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 选择需要关联缺陷的测试用例。可通过以下两个入口创建/关联缺陷。
   • 在“测试用例列表”页面操作。
     • 单击操作列，关联当前项目下已有的缺陷。
     • 单击操作列，选择“新建并关联缺陷”，并根据页面提示创建对应缺陷。
   • 打开单个“测试用例”进行新建并关联缺陷。

     单击测试用例名称，页面中选择“缺陷列表”，单击“新建并关联缺陷”进行操作。

4. 缺陷创建或关联完成后，可以在测试用例详情页面的“缺陷列表”页签查看缺陷信息。单击可以解除当前缺陷。

评论测试用例

测试计划服务支持对测试用例进行评论。

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 选择需要评论的测试用例，单击用例名称，选择“详情”页签。
4. 在页面下方“评论”框中输入评论内容，单击“保存”。

   保存成功的评论将显示在评论框下方。

过滤测试用例

测试计划服务支持自定义过滤测试用例，本节以“测试用例 > 手工测试”页面为例，介绍如何过滤测试用例。

使用默认过滤条件

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 在“手工测试”页签，单击列表上方“所有用例”或“全部”2个下拉列表，在列表中选择需要的过滤条件。
   • 所有用例：显示当前测试计划或用例库中所有的用例。
   • 我的用例：显示“处理人”是当前登录用户的所有用例。
   • 未关联测试套：显示在“测试执行”中，未关联任何测试套件的用例。

用户可以单击新建用例右键的两个下拉栏，根据“所有用例”或“我的用例”、“全部”或“未关联测试套”进行用例筛选。

设置高级过滤条件

当默认过滤条件不满足过滤需要时，可以添加自定义过滤条件。

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 在导航栏单击“测试 > 测试用例”。
3. 单击用例列表上方的“高级过滤”，页面将显示常用的过滤条件。
4. 根据需要设置过滤条件，单击“过滤”，页面中将显示符合过滤条件的用例列表。

   也可以单击“保存当前条件并过滤”，在弹框中输入过滤器名，单击“确定”。保存后的过滤器将会显示在“所有用例”下拉列表中。

5. （可选）若高级过滤条件仍不满足需求，可以单击“添加筛选条件”，根据需要在下拉列表中选择过滤项，单击该过滤项，完成添加。过滤项将显示在页面中，重复4操作，完成过滤。高级过滤支持过滤自定义字段。

自定义用例列表显示列

测试计划支持自定义列展示测试用例表格，本节以测试用例下的手工测试用例为例介绍具体操作。

1. 登录软件开发生产线首页，搜索目标项目并单击项目名称，进入项目。
2. 单击导航栏“测试 > 测试用例” 。
3. 在“手工测试”页面，单击表格最后一列，在弹出框中可以配置显示的列和隐藏的列，并可以拖拽排列显示顺序。用例列表支持配置自定义字段。

搜索用例

测试计划服务支持按用例名称、编号或描述进行搜索。

1. 完成创建测试用例。
2. 在用例列表上方的搜索框内输入用例名称、编号或描述的关键字。
3. 单击。
4. 搜索到的用例将显示在用例列表中。