Skip to main content

Export project

You can export projects from Test Manager to a file to allow you to recreate the project later. Use this feature to:

  • Transfer entire testing projects to different tenants or instances of Test Manager.
  • Create backup copies of any of your projects.

How it works​

Exporting a project generates a TMH file that can be then imported in another Test Manager instance. This includes objects such as requirements, test cases, test sets, labels, custom fields, attachments, and automation information. The export process is done asynchronously, notifying when the export process is finished.

note

Users with a valid Test Manager license can export projects. For more information, check User and Group Access Management.

Considerations​

The export TMH file contains:

Exported objects Details
Test objects When you export a project, you can choose the export TMH file to contain one or all of the following:
  • Requirements
  • Preconditions
  • Test cases
  • Test sets (and their corresponding labels)
  • Object labels
  • Attachments
  • Custom field values (definitions are not exported)
  • Automation information for test cases
  • Test results (available only if you export test cases)
  • Defects (available only if you export test results, exports only references)
Assignments between objects
  • Assignments between requirements and test cases
  • Static assignments between test cases and test sets
  • Since dynamic assignments to test sets are only resolved at the time of execution, dynamically assigned test cases are not exported along with the test sets.
  • Assignments between test objects and labels
Project information
  • Name
  • Prefix
  • Description

Prerequisites​

To make sure that the export TMH file downloads successfully, set the buffer response setting in your API Management Gateway as false:

  1. Access your API Management Gateway system.
  2. Locate the API endpoints that finish with /download. You want to set the buffer response to False only for API endpoints that have download as the API response.
  3. Check out the official documentation for your API Management Gateway system. For example, if you use Microsoft Azure, check out the official documentation, to learn how to change the buffer-response setting from true to false.

Exporting a project from Test Manager​

  1. Sign in to Test Manager.
  2. Choose the project you want to export, and select More Optionsdocs image. The Export Project panel opens.
  3. Select the test objects that you want to include in the export file, and then select Export.
  4. Wait for the export process to finish and select the Project Export Completed notification that you receive via the notifications panel or via email. The export TMH file downloads automatically. In case the download doesn't start automatically, select Download.
warning

This download link expires in seven days.