Azure DevOps Services
Azure 测试计划用户可以使用 CSV 或Microsoft Excel 文件格式批量导入或导出测试用例。 导入作支持将新的测试用例创建到给定的测试套件中，或通过提供测试用例 ID 更新现有测试用例。 导出作允许用户将测试用例导出到 CSV 或Microsoft Excel 文件（XLSX）。 虽然您可以继续使用批量导入和更新，但也可以使用网络门户自身的功能来复制、克隆和更新测试用例。 有关详细信息，请参阅 复制或克隆测试计划、测试套件和测试用例。
有关测试对象和术语的概述，请参阅 测试对象和术语。
先决条件
| 类别 | 要求 |
|---|---|
| 项目访问权限 | 项目成员. |
| 访问级别 | 要请求或提供反馈，必须至少拥有利益干系人的访问权限。 |
| 权限 | - 要添加或修改 bug 或其他工作项类型：在相应的“区域路径”下，将“编辑此节点中的工作项”权限设置为“允许”。 - 若要添加新标记：创建标记定义 权限设置为 “允许”。 有关详细信息，请参阅为测试设置权限和访问权限。 |
导出测试用例
从 测试计划>测试计划页面 中，选择包含要导出的测试用例的测试套件所属的测试计划。
（可选）选择
列选项添加要包含在下载文件中的字段。若要导出测试套件的所有测试用例，请选择 将测试用例导出到 CSV，或 将测试用例导出到 XLSX。
若要导出测试套件的测试用例的子集，请选择要导出的测试用例，选择
更多选项，然后选择 将测试用例导出到 CSV 或 将测试用例导出到 XLSX。
导出的 CSV 文件将显示在 下载 文件夹中。
导入测试用例
从测试计划页面>中，选择包含要导入测试用例的测试套件的测试计划。
选择要从打开的对话框导入的文件，然后选择 导入。
在显示的 确认导入 对话框中选择 确认。 如果指定测试套件中已定义的测试用例，某些元素可能会在导入期间过度写入。
更新现有测试用例
若要更新工作项，请创建一个列视图，其中包含要导出和可能编辑的所有列。 将相关列应用到视图后，是时候将测试用例导出到 CSV 或 XLSX 文件中了。 选择“导出到 CSV 或 导出到 XLSX 以将文件保存到本地计算机。
对测试用例进行编辑。 不得更改 ID 和 工作项类型 字段。 要包含的任何其他字段都是可选的。
保存文件并将其导入回测试套件（请参阅 导入部分。）
导入自动测试用例（TCM）
若要将自动测试用例导入测试套件，请使用 tcm testcase /import。 必须为包含测试的测试程序集指定 .dll 文件。
tcm testcase /import /collection:teamprojectcollectionurl /teamproject:project
/storage:path
[/maxpriority:priority]
[/minpriority:priority]
[/category:filter]
[/syncsuite:id [/include]]
[/login:username,[password]]
| 参数 | 描述 |
|---|---|
/storage：path |
指定包含要导入的自动测试的测试程序集的路径和名称。 |
/maxpriority：priority |
自选。 根据测试方法的最大优先级指定要导入的测试。 例如，如果参数 /maxpriority:1，则仅将测试方法的优先级属性小于或等于 1 的测试导入为程序集中的测试用例。 |
/minpriority：priority |
自选。 根据测试方法的最低优先级指定要导入的测试。 例如，如果参数 /minpriority:2，则只有测试方法的优先级属性等于或大于 2 的测试将导入为程序集中的测试用例。 |
/category：filter |
自选。 根据测试程序集中每个测试方法的类别指定要导入的测试。 可以将此参数与 /syncsuite 一起使用，将具有特定类别的测试导入到特定的测试套件中。有关测试类别的详细信息，请参阅 使用测试资源管理器运行单元测试。 |
/syncsuite：id |
自选。 指定测试计划中测试套件的套件 ID，以便将导入的测试用例添加到其中。 此套件不能是动态套件或基于查询的套件。 如果指定要同步以更新测试的测试套件，则不受支持的测试将从测试套件中删除，但不会从测试计划本身中删除。 |
常见问题解答
问：是否可以导入新的测试用例并更新同一 CSV/XLSX 文件中的现有事例？
答：绝对！ 对于任何新的工作项，将测试用例 ID 字段留空。 对于要更新的现有测试用例，请提供相应的“测试用例 ID”和“工作项类型”值。
问：如何知道导入的文件是否出错？
答：CSV/XLSX 文件格式出现任何问题都显示在 Web 门户的导入视图中。 在格式和语法正确之前，无法导入工作项。
问：导入操作是否支持所有工作项类型？
答：否，并不是所有工作项都支持。 测试用例导入仅支持以下工作项类型：
- 测试用例
对于使用导入功能在测试用例中引用共享步骤很重要：
共享步骤工作项必须已存在，并且可以在 CSV 中引用其 ID。 CSV 或 XLSX 导入功能不支持在没有 ID 的情况下引用新的共享步骤工作项，并且导入失败并显示“无效列”错误。
可以从测试用例工作项 UI 创建新的共享步骤工作项，并使用其中的创建共享步骤选项。
创建共享步骤工作项后，可以在 CSV 中引用共享步骤的 ID。
- 请注意，如果共享步骤工作项引用随 CSV 或 XLSX 中的步骤一起提供，它将更新共享步骤工作项。 因此，如果只想提供对共享步骤的引用，请不要在 CSV 或 XLSX 中添加步骤。
Azure Boards 使用 CSV 文件提供单独的批量导入功能。 有关详细信息，请参阅 批量导入或更新（CSV）。
问：导入 CSV/XLSX 文件中要包括哪些必需标头？
答：确保每个导入文件都有以下标头（具有确切拼写）：
- ID：尝试导入的工作项的 ID。 对于新的测试用例创建，请将此字段留空。
- 工作项类型： 测试用例导入方法仅支持“测试用例”和“共享步骤”。 提供工作项类型信息时，请使用这些确切关键字。
- 标题：要创建或更新的测试用例的标题，可以是字母数字值。
- 测试步骤：测试用例中定义的 步骤位于有序列表中。 需要提供每个测试步骤的订单号。
- 步骤操作： 定义手动测试人员在执行测试步骤时需要采取的行动。
- 步骤预期： 给定操作的预期结果。
问：导入或导出操作有哪些限制？
答：确保遵循以下限制：
- 测试用例状态列必须处于“设计”状态。
- 测试用例标题长度不得超过 128 个字符。
- 导入和导出期间创建的 JSON 对象限制为 20 MB。 如果导入失败，请尝试使用小部分测试用例进行操作。
- 执行导入的用户必须对要导入或导出的测试计划和测试套件的区域和迭代路径具有权限。
- 如果相关链接的计数超过 1000，对于该测试用例，复制和导入操作将失败。