- Getting started
- Project management
- Project operations and utilities
- Test Manager settings
- ALM tool integration
- API integration
Test Manager user guide
You can import projects from external sources to conduct testing operations through Test Manager. Use this feature to transfer entire testing projects from different Application Lifecycle Management (ALM) systems to Test Manager.
Importing the project follows a schema that converts external system projects (e.g., testing applications) into a format that can be read by Test Manager. This includes objects such as requirements, test cases, test sets, test results, labels, custom fields, and attachments. The import process is done asynchronously.
- New Object IDs (GUIDs) are generated during import in Test Manager.
- Time stamps (Created Time,Updated Time) are maintained.
- Created By, and Updated By refer to the user who submitted the project import request. We do not maintain the original user who created the artifact in the ALM system.
- File attachments exceeding the size limits (90 MB) are skipped.
Any user having a valid Test Manager License can import projects.
For more information see User and Group Access Management.
You need the schema version to build the TMH file. Retrieving the schema version involves using API calls in Swagger. To retrieve the schema version, follow the steps below:
- Go to Swagger, using the Test Manager endpoint that you currently use. To connect Swagger to your Test Manager, visit API References
- Go to the ProjectMigrationSchema request.
- Execute GET /api/v2/migration/schema/versions and copy the version generated in the Response Body.
- Input the copied schema version as a parameter for GET /api/v2/migration/schema/{schemaVersion} and execute the API.
- Select Download file from the Response body section.
Results: A ZIP file is downloaded, that has the schema of different testing artifacts in the TMH file. The ZIP file contains the following folders and files:
- An attachments folder - contains subfolders corresponding to the attachments associated with each object, object Id is folder name (test cases, test sets, requirements, test executions, etc.).
- An objects folder - contains subfolders corresponding to all types of objects available in Test Manager.
- A JSON manifest file - holds basic metadata about your WebExtension.
- A readme.txt file - contains instructions for preparing data that goes inside the folders.
Example: To specify a Test Case, use the sample schema below:
{
"testCases": [
{
"id": "string (100)",
"version": "string (100)",
"name": "string (100)",
"inputParams": "string",
"description": "string",
"automationId": "string (100)",
"automationTestCaseName": "string (100)",
"automationProjectName": "string (100)",
"foreignRef": "string",
"connectorTestCaseId": "string",
}
]
}{
"testCases": [
{
"id": "string (100)",
"version": "string (100)",
"name": "string (100)",
"inputParams": "string",
"description": "string",
"automationId": "string (100)",
"automationTestCaseName": "string (100)",
"automationProjectName": "string (100)",
"foreignRef": "string",
"connectorTestCaseId": "string",
}
]
}Make sure to change the data between parentheses with the data corresponding to your Test Case.
-
After creating JSON files for each object from a project, add them to the corresponding subfolder in the objects folder. You can name the JSON files however you want, but the names of the subfolders must stay the same
Example: Add the JSON files that contain data about Test Cases to the testcases subfolder.
Important: If you have a large number of objects to import, split them into multiple files, such astestcases-1.json, andtestcases-2.json. We recommend adding a maximum number of 500 files per subfolder. -
Add the attachment files associated with the objects under the attachments folder, using the following folder hierarchy:
/attachments/object-id/file name.object-id- replace this with the ID of the associated object.file name- replace this with the name of the attachment.
Any user having a valid Test Manager License can import projects.
For more information see User and Group Access Management.
The imported project shows up in the Projects page, grayed out until the process is completed.
Post-import steps
Review the import project report displayed in Test Manager as a notification after the process is completed. The import summary PDF file shows the status of the imported objects. You can investigate individual objects that haven't been imported in object migration log csv file. If the project import fails, contact UiPath® Support.
