Test Suite User Guide

DELIVERY:

Last updated May 14, 2025

Export project

You can export projects from a Test Manager instance to another (regardless of the delivery option) to standardize operations through Test Manager. 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, see 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 Test Cases Test Sets Object labels Attachments Custom field definitions (only the values) Automation information for Test Cases
Assignments between objects	Assignments between Requirements and Test Cases Assignments between Test Cases and Test Sets Assignments between test objects and labels
Project information	Name Prefix Description

Prerequisites

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

Access your API Management Gateway system.
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.
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 - Standalone

Enable email notifications for your Test Manager instance:

Select More Options in the Test Manager header > Application Settings.
Inside the Email tab select Enable email notifications.
Configure the values for the email notification event:
1. Host (Required) - The SMTP server address (for example, smtp-mail.outlook.com).
2. Port (Required) - The port of the SMTP server.
3. Username - The username that you use for server authentication.
4. Password - The password associated with the username that you use for server authentication.
5. Domain - The domain of Username.
6. From Address (Required) - The email address to send the emails from.
7. From Display Name (Required) - The display name of the sender.
Select Save.

To export an existing project in Test Manager:

Sign in to Test Manager. Choose the project you want to export, and select More Options. The Export Project panel opens.
Warning: Test Results aren't included in the export file.
Select the test objects that you want to include in the export file, and then select Export.
Wait for the export process to finish and open the Project Export Completed notification that you receive via email.
Select Download. You are redirected to the Test Manager instance from where you exported, and the export TMH file downloads automatically. In case the download doesn't start automatically, select Download.
Note: If you have not enabled email notifications for your Test Manager instance, you can search for your exported TMH file in the local folder where Test Manager is installed. Follow these steps to find the TMH file:
1. Open the Test Manager local folder.
2. Go to the Storage folder.
3. Open the folder that begins with TMH, followed by a specific tenant ID.
  This folder stores all attachments found in that particular tenant.
4. Navigate to the User folder, and then the Project folder.
5. Open the file titled with the ID of your desired project.
  You can get the ID of your project using the Test Manager APIs.
6. In the Export folder you can find all the exported TMH files. The complete path would look like this: ...\UiPath TestManager/Storage/TMH-<tenantID>/User/Project/<projectID>/Export.