删除Azure Boards中的测试项目

Azure DevOps 服务 |Azure DevOps Server |Azure DevOps Server 2022

测试项目(如测试计划、测试套件和测试用例)都是Azure DevOps中的工作项。 删除它们在 Azure DevOps Server 中永久,但在 Azure DevOps 服务中可恢复。 了解删除过程和恢复选项有助于安全地删除。

Tip

可以在本文后面使用 AI 来帮助完成此任务,或参阅启用 Azure DevOps MCP Server 的 AI 帮助以开始使用。

了解删除行为

Azure DevOps服务和Azure DevOps Server之间的删除行为有所不同。 了解每个平台如何处理删除以及可用的恢复选项有助于自信地删除。

Azure DevOps服务删除模型

Azure DevOps服务支持软删除模型。 删除测试计划或测试套件后,它们会进入 14 天的恢复期,之后才会被永久删除。

删除测试项目时会发生什么情况

  1. 从 TCM 数据存储中删除

    • 已删除的测试项目将从测试用例管理 (TCM) 数据存储中删除。
    • 将删除与测试项目关联的基础工作项。
  2. 删除子项

    • 后台作业会从 TCM 数据存储和底层工作项中删除所有子项。
    • 此过程可能需要几分钟时间,具体取决于要删除的项目数。
  3. 软删除

    • 工作项跟踪数据存储和 TCM 数据存储中的所有信息都处于软删除状态,可以在 14 天内还原。
  4. 永久删除

    • 在任何情况下,都无法重新激活或还原已删除的数据。

若要在 14 天软删除阶段还原已删除的测试计划或测试套件,请执行以下操作:

  1. 运行 List API 以获取要还原的 测试计划 和 /。
  2. 如果列表 API 返回包含要还原的测试计划或测试套件的响应,请运行 测试计划/测试套件 的 PATCH API 以还原它们。
  3. 如果列表 API 未返回要还原的测试计划或测试套件,则会从系统永久删除它,并且无法还原。

还原已删除的测试计划或套件

在 14 天的软删除阶段,可以还原已删除的测试计划和套件:

  1. 调用列表 API,通过 GET 获取要还原的测试计划/测试套件。
  2. 如果列表 API 返回包含要还原的测试计划或套件的响应,请运行 Test Plan/Test Suite 的 PATCH API 以还原它们。
  3. 如果列表 API 未返回要还原的测试计划或套件,则会永久删除它,并且无法恢复。

重要限制

  • 删除后,测试计划和测试套件处于软删除状态 14 天。 在此时间段后,它们将被永久删除,无法还原。
  • 还原测试计划或套件时,也会还原所有子项目(测试套件、测试用例)。
  • 不支持还原与测试计划和套件关联的测试运行。
  • 通过 API 或非门户方法删除的测试用例将被永久删除,无法还原。

Azure DevOps Server删除模型

重要说明

永久和不可逆删除:Azure DevOps Server仅支持永久删除测试项目,包括测试计划、测试套件、测试用例、共享步骤和共享参数。 无法还原已删除的工件,并且所有与其关联的子项,例如测试结果,都会被删除。 此外,不支持批量删除测试项目。

在删除测试项目之前备份任何必要的信息,因为此操作无法撤消。

删除测试项目时会发生什么情况

  1. 从 TCM 数据存储中删除:

    • 已删除的测试项目将从测试用例管理 (TCM) 数据存储中删除。
    • 将删除与测试项目关联的基础工作项。
  2. 删除子项:

    • 后台作业会从 TCM 数据存储和底层工作项中删除所有子项。
    • 此过程可能需要几分钟时间,具体取决于要删除的项目数。
  3. 永久删除:

    • 此过程永久删除工作项跟踪数据存储和 TCM 数据存储中的所有信息。
    • 在任何情况下,都无法重新激活或还原已删除的数据。

先决条件

类别 要求
访问级别 基本 + 测试计划或Visual Studio Enterprise 来管理或删除测试项目。 具有 基本 访问权限的用户只能删除孤立的测试用例(测试用例未链接到任何测试计划或套件)。
权限——测试运行 Project Administrators 组的成员,或项目级别的 删除测试运行 权限设置为 允许。
权限 - 测试计划和套件 Project管理员组的成员,或区域路径节点级管理测试计划或管理测试套件权限设置为“允许”。

注意

如果你不是项目管理员,则需要同时具有项目级别的 删除测试运行 权限以及相应的区域路径节点级权限。

Tip

不确定你是否具有正确的权限? 请参阅 “验证删除权限 ”部分。

支持测试体验的工作项类型

下图演示了一组支持测试体验和使用 Microsoft 测试管理器的工作项类型。 这些工作项类型使用所示的链接类型链接在一起。

显示测试管理工作项类型的屏幕截图。

从 Web 门户或 Microsoft 测试管理器中,可以查看针对测试套件定义了哪些测试用例,以及针对测试计划定义了哪些测试套件。 但是,这些对象并没有通过链接类型而互相连接。 有关这些工作项类型中使用的每个字段的定义,请参阅基于生成和测试集成字段的查询。

删除测试项目

Warning

删除测试项目是永久性的,无法撤消。 在 Azure DevOps 服务中,有 14 天时间还原已删除的测试计划和测试套件。 在Azure DevOps Server中,删除是即时和永久的。 在确认删除之前,请仔细验证所选内容。

删除测试用例

  1. 转到要删除的测试用例。
  2. 从操作菜单中选择 “永久删除 ”。
  3. 在弹出的对话框中确认删除。

从 Web 窗体中删除测试用例和关联的测试项目。

注意

仅当具有必要的权限和访问级别时, 永久删除 选项才可用。

删除测试套件

  1. 转到要删除的测试套件。
  2. 从操作菜单中选择 “永久删除 ”。
  3. 在弹出的对话框中确认删除。

确认删除“测试项目”对话框。

删除测试计划

选项 A:从测试计划视图中删除

  1. 转到要删除的测试计划。
  2. 从操作菜单中选择 “永久删除 ”。
  3. 在弹出的对话框中确认删除。

选项 B:从测试计划中心中删除

  1. 打开 测试计划。
  2. 在列表中查找要删除的测试计划。
  3. 右键单击测试计划(或选择计划旁边的 ···菜单 图标)。
  4. 选择 删除。
  5. 确认删除。

“测试计划”页、删除测试计划的屏幕截图。

删除共享步骤或共享参数

  1. 打开要删除的共享步骤或共享参数。
  2. 选择“ 显示引用 ”以查看链接到此项的所有测试用例。
  3. 对于每个测试用例,请打开它并删除指向共享步骤或参数的链接。
  4. 删除所有引用后,返回到共享步骤或参数并选择 “永久删除”。
  5. 确认删除。

注意

如果“ 永久删除 ”选项已禁用,请验证是否删除了所有引用。 系统会阻止删除测试用例仍然引用的共享步骤或参数。

屏幕截图显示“从窗体中删除共享步骤”。

验证删除权限

在尝试删除测试项目之前,请验证你是否具有所需的权限:

  1. 转到 “项目设置>权限”。
  2. 搜索您的用户账户或团队。
  3. 验证是否已将以下权限设置为 “允许” :
    • 删除测试运行 (用于删除测试结果)
    • 管理测试计划 或 管理测试套件 (用于删除测试计划和套件)
  4. 请检查你的访问级别是否为 基本 + 测试计划 或更高级别。
  5. 如果权限不正确,请与项目管理员联系。

有关详细信息,请参阅 “管理测试项目”权限。

排查测试工件删除问题

“永久删除”选项未显示

可能的原因:

  • 您的访问级别低于 Basic + Test Plans 级别。
  • 您没有此工件所需的权限。
  • 您没有此位置的区域路径权限。

解决方法:

  1. 检查访问级别:转到 配置文件>安全性 以查看当前的访问级别。
  2. 验证权限:请参阅 “验证删除权限”。
  3. 如果你不是项目管理员,请让管理员分配所需的权限。

删除速度缓慢或超时

可能的原因:

  • 测试工件具有多个子项(测试用例、测试套件、测试结果)。
  • 后台任务仍在处理删除操作。
  • 网络连接问题

解决方法:

  • 大型删除可能需要几分钟时间。 请留出一些时间让后台作业完成。
  • 等待几分钟后刷新页面以验证删除。
  • 检查网络连接,然后重试。

删除后工件仍然显示(Azure DevOps Services)

可能的原因:

  • 该对象处于软删除状态(14 天恢复期)。

解决方法:

  • 在Azure DevOps服务中,已删除的测试计划和测试套件在 14 天的恢复时段内在某些视图中保持可见。
  • 该构件将在 14 天后被永久删除。
  • 若要在此窗口中还原项目,请参阅 还原已删除的测试计划或套件 (在上面的简介部分)。

无法删除共享步骤或参数

可能的原因:

  • 共享步骤或参数仍具有来自测试用例的引用。

解决方法:

  1. 打开共享的步骤或参数。
  2. 选择“ 显示引用 ”以查看所有链接的测试用例。
  3. 打开每个测试用例并删除链接。
  4. 再次尝试删除。

有关详细信息,请参阅上面的 “删除共享步骤”或“共享参数 ”。

通过 REST API 删除测试项目

还可以使用 Azure DevOps REST API 以编程方式删除测试项目。 此方法适用于自动化、批量删除或与 CI/CD 管道的集成。

删除测试用例

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/testcase/{testCaseId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

删除测试套件

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}/suites/{suiteId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

删除测试计划

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

注意

  • 用实际值替换 {organization}、{project}、{planId}、{suiteId} 和 {testCaseId}。
  • 使用 API 版本 7.1 或更高版本。 检查 REST API 版本控制 是否有当前版本。
  • 在 Azure DevOps 服务中,可以在 14 天的软删除窗口中通过 API 还原已删除的项目。
  • 在Azure DevOps Server中,通过 API 删除是永久性的。
  • 使用 个人访问令牌(PAT) 或 OAuth 令牌进行身份验证。

有关完整的 API 详细信息,请参阅 测试计划回收站 API 参考。

使用 AI 删除测试项目

如果为组织配置Azure DevOps MCP 服务器,可以使用它通过自然语言大规模查找和删除测试项目。 此方法特别适用于批量删除或难以手动执行的复杂查询。

下面是自然语言查询的常见模式:

任务 示例提示
删除测试计划 Delete test plan <TestPlanName> in project <Contoso>
查找旧的测试项目 List all test plans in project <Contoso> that aren't updated in the last 6 months
删除已放弃的测试套件 Find all test suites in project <Contoso> that have no test runs in the last 90 days and delete them
查找重复的测试用例 Identify duplicate test cases in test suite <SuiteName> that have the same title and steps
按标记批量删除测试用例 Delete all test cases marked with tag "deprecated" in project <Contoso>
删除孤立的共享步骤 Find shared steps in project <Contoso> that aren't referenced by any test cases
验证删除影响 Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it
删除旧的测试结果 Delete all test results older than 1 year from test plan <TestPlanName>
计划构件清理 What test artifacts in project <Contoso> can I safely delete to clean up the test data

注意

代理模式和 MCP 服务器使用自然语言,因此你可以调整这些提示或提出后续问题来优化结果。 在Azure DevOps Server中,测试项目删除是永久性的,无法还原,因此请仔细验证你的选择。