Delete test artifacts

Azure Boards | Azure Test Plans | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

While test artifacts such as test plans, test suites, test cases, and so on are types of work items, the method for deleting them differs from deleting non-test work items.

Important

We only support permanent deletion of test artifacts such as test plans, test suites, test cases, shared steps and shared parameters. Deleted test artifacts won't appear in the recycle bin and cannot be restored. Deletion of test artifacts not only deletes the selected test artifact but also all its associated child items such as child test suites, test points across all configurations, testers (the underlying test case work item doesn't get deleted), test results history, and other associated history.

When you delete test artifacts, the following actions occur:

  1. Removes the deleted test artifact from the test case management (TCM) data store and deletes the underlying work item
  2. Runs a job to delete all the child items both from the TCM side and the underlying work items. This action may take time (up to a few minutes) depending on the number of artifacts to be deleted.
  3. Causes all information in the work item tracking data store and TCM data store to be deleted and cannot be reactivated nor restored.

Prerequisites

  • You must be a member of the Project Administrators group or have the Delete test artifacts permission set to Allow.
  • You must also have your access level set to Advanced, which provides access to the full Test feature set. Users with Basic access and with permissions to permanently delete work items and manage test artifacts can only delete orphaned test cases. That is, they can delete test cases created from Work that aren't linked to any test plans or test suites.
  • You must be a member of the Project Administrators group or have the Delete test artifacts permission set to Allow.
  • You must also have your access level set to Basic + Test Plans or Visual Studio Enterprise, which provides access to the full Test feature set. Users with Basic access and with permissions to permanently delete work items and manage test artifacts can only delete orphaned test cases. That is, they can delete test cases created from Work that aren't linked to any test plans or test suites.

To delete test artifacts, the following restrictions and operations apply:

  • Users with Basic access and with permissions to permanently delete work items and manage test artifacts can only delete orphaned test cases. That is, they can delete test cases created from Work that aren't linked to any test plans or test suites.
  • When you delete a test plan, test suite, test case, shared steps, or shared parameters, you not only permanently delete them, you also delete all associated test artifacts such as test results.
  • You can't bulk delete test artifacts. If test artifacts are part of a bulk selection to be deleted, all other work items except the test artifact(s) will get deleted.

Note

The permanently delete feature of test artifacts is available for TFS 2017.1 and later versions.

Work item types that support the test experience

The following image illustrates the set of work item types that support the test experience and work with Microsoft Test Manager. These work item types are linked together using the link types shown.

Test management work item types

From the web portal or Microsoft Test Manager, you can view which test cases are defined for a test suite, and which test suites are defined for a test plan. However, these objects aren't connected to each other through link types. For definitions of each field used in these work item types, see Query based on build and test integration fields.

Delete a test case

  1. To delete a test case, open it from the web portal and choose the** Permanently delete** option from the actions menu. (Bulk deletion is not supported from a query results page.)

    Delete a test case and associated test artifacts from the web form

    Note

    You'll only see the Permanently delete option if you have the necessary permissions and access.

  2. Confirm you want to actually delete the item.

    Confirm delete of test artifacts

  3. You can also delete test plans and test suites directly from Test.

    Delete test plans and artifacts from Test pages

  4. To delete shared steps and shared parameters you need to first manually remove all references to them before you can delete them.

    Delete shared steps from form