导入项目

将 TMH 文件从外部系统导入 Test Manager，作为新项目或现有项目，从而迁移需求、测试用例、测试集和附件。

您可以从外部来源导入项目，以通过 Test Manager 执行测试操作。 使用此功能可将整个测试项目从不同的 Application Lifecycle Management (ALM) 系统传输到 Test Manager。

工作方式

项目导入时遵循的架构可将外部系统项目（例如，测试应用程序）转换为 Test Manager 可以读取的格式。这包括需求、测试用例、测试集、测试结果、标签、自定义字段、先决条件、后置条件和附件等对象。导入过程是异步完成的。

注意事项

• 在 Test Manager 中导入期间会生成新的对象 ID (GUID)。
• Time stamps (Created Time, Updated Time) are maintained.
• 创建人和更新者是指提交项目导入请求的用户。我们不会在 ALM 系统中维护创建工件的原始用户。
• 超出大小限制 (90 MB) 的文件附件将被跳过。
• 自动化链接在导入过程中不会继承，因为链接取决于每个租户唯一的自动化 ID。

备注：

将项目导入其他租户后，请取消链接每个测试用例的自动化，然后将其重新链接到目标租户的 Orchestrator 中的相应自动化。否则，该测试用例的自动执行将卡在待处理状态。

谁可以导入项目

任何拥有有效 Test Manager 许可证的用户都可以导入项目。

有关更多信息，请参阅“用户和组访问管理”。

Getting the schema version

构建 TMH 文件需要架构版本，您可以在 Swagger 中使用 API 调用来检索该文件。

步骤

1. 使用您当前使用的 Test Manager 端点转到 Swagger。要将 Swagger 连接到 Test Manager，请访问API 参考。
2. Go to the ProjectMigrationSchema request.
3. Execute GET /api/v2/migration/schema/versions and copy the version generated in the Response Body.
4. Input the copied schema version as a parameter for GET /api/v2/migration/schema/{schemaVersion} and execute the API.
5. Select Download file from the Response body section.

结果

系统将下载 ZIP 文件。它包含 TMH 文件中不同测试工件的架构。

ZIP 文件包含以下文件夹和文件：

• 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.

Preparing the TMH file

准备要导入的 TMK 文件时，我们建议使用不超过 2GB 的文件。将文件大小保持在此限制内可以避免导入过程中途中止。

按照每个子文件夹中的示例架构，指定要导入 JSON 文件的所有对象。

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"
    }
  ]
}

请务必使用与您的“测试用例”相对应的数据更改括号之间的数据 。

1. 为项目中的每个对象创建 JSON 文件后，将其添加到对象文件夹中的相应子文件夹中。您可以根据需要命名 JSON 文件，但子文件夹的名称必须保持不变示例：将包含测试用例相关数据的 JSON 文件添加到测试用例子文件夹中。
   重要提示：

   If you have a large number of objects to import, split them into multiple files, such as testcases-1.json, and testcases-2.json. We recommend adding a maximum number of 500 files per subfolder.

2. Add the attachment files associated with the objects under the attachments folder, using the following folder hierarchy: /attachments/object-id/file name.
   • object-id - 将其替换为关联对象的 ID。
   • file name - 将其替换为附件的名称。

在 Test Manager 中导入项目

导入项目将从导出的 TMH 文件创建一个新的 Test Manager 项目。

重要提示：

准备要导入的 TMK 文件时，我们建议使用不超过 2GB 的文件。将文件大小保持在此限制内可以避免导入过程中途中止。

步骤

1. 登录到 Test Manager。
2. 选择“导入项目” 。
3. 添加 TMH 文件。系统会自动获取项目详细信息，并将其列在“项目中的对象”部分中，以便您在开始导入流程之前进行查看。
4. 查看“项目中的对象”部分，并选中项目文件中包含的数据对象。
5. （可选）要将自动化纳入导入的一部分，请选中“包括测试用例的自动化信息”复选框。
6. （可选）要在导入中包括项目配置，请选中“导入项目配置”复选框。
7. （可选）编辑项目名称、前缀和说明。
8. 查看信息，然后选择“导入”以开始流程。
   备注：

   导入项目通常需要大约 10 到 15 分钟，但较大的项目可能需要更长时间。

9. 流程完成后，查看 Test Manager 中显示为通知的导入项目报告。导入摘要 PDF 文件以显示导入对象的状态。您可以调查对象迁移日志 csv 文件中尚未导入的单个对象。
   备注：

   如果项目导入失败，请联系UiPath™ 支持团队。

结果

导入的项目将显示在“项目”页面中，在流程完成之前显示为灰色。“项目导入完成”通知会确认导入。

导入到 Test Manager 中的现有项目

如果导入到现有项目，系统会将 TMH 文件的需求、测试用例、测试集和其他工件合并到目标项目中。

步骤

1. 登录到 Test Manager。

2. 选择“导入项目” 。

3. 在此处添加您下载的 TMH 文件。系统会自动获取项目详细信息，并在“项目文件中的对象”部分中列出，以便您在开始导入流程之前查看。

4. 查看“项目文件中的对象”部分，并检查项目文件中包含的数据对象。

5. （可选）要将自动化纳入导入的一部分，请选中“包括测试用例的自动化信息”复选框。

6. （可选）要在导入中包括项目配置，请选中“导入项目配置”复选框。

7. 在“目标”下选择“现有项目” 。

8. 从“项目”下拉列表中选择导入数据的目标项目。

   提示：

   • 如果您有较大的 TMH 文件，则可以将其拆分为多个文件，并在同一目标项目中分别导入。
   • 如果导出多个项目，则可以将其重新导入现有项目中。

9. 查看信息，然后选择“导入”以开始流程。

   警告：

   “测试结果”字段始终为0 ，因为不会导出测试结果。

10. 现有项目的导入流程完成后，您会收到有关该事件的“项目导入已完成”通知。

    

11. 选择该通知，转到新项目的“附件”选项卡，您可以在其中查看：

    1. 迁移步骤日志（ZIP 文件）
    2. 已迁移对象的日志（ZIP 文件）
    3. 导入摘要（TXT 文件）- 显示实体的总数，以及导入或跳过的实体数量。

12. 流程完成后，查看 Test Manager 中显示为通知的导入项目报告。导入摘要 PDF 文件以显示导入对象的状态。您可以调查对象迁移日志 csv 文件中尚未导入的单个对象。

    备注：

    如果项目导入失败，请联系UiPath™ 支持团队。

结果

TMH 文件的数据将导入到选定的项目中，系统将显示“项目导入已完成”通知确认导入。

查看自动化信息

如果您在导入中包含了自动化信息，则导入测试用例的“详细信息”选项卡会显示生成该测试用例的自动化。

步骤

1. In the Import project page, select Include automation information for test cases at the bottom.

2. Finish the import, and filter through the imported test cases, applying the automationcleared label filter.

   图 1.显示自动化已清除标签的“标签”下拉列表

   

3. Open every returned test case, and go to the Details tab to retrieve the information about the automation that generated the test case.

结果

“详细信息”选项卡中显示的自动化信息包括：

• 自动化 ID
• 自动化项目名称
• 自动化测试用例名称

相关文章

• TMH 文件格式规范