test-suite
latest
false
UiPath logo, featuring letters U and I in white
Test Suite 用户指南
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 2024年11月20日

导入项目

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, preconditions, postconditions, and attachments. The import process is done asynchronously.

注意事项

  • New Object IDs (GUIDs) are generated during import in Test Manager.
  • 将维护时间戳(“创建时间”、“更新时间”)。
  • “创建者” 和“ 更新 者” 是指提交项目导入请求的用户。 我们不会维护在 ALM 系统中创建项目的原始用户。
  • 超出大小限制 (90 MB) 的文件附件将被跳过。

谁可以导入项目

Any user having a valid Test Manager License can import projects.

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

Getting the schema version

您需要 架构版本 来构建 TMH 文件。 检索架构版本涉及在 Swagger 中使用 API 调用。 要检索架构版本,请按照以下步骤操作:

  1. Go to Swagger, using the Test Manager endpoint that you currently use. To connect Swagger to your Test Manager, visit API References
  2. 转到“项目迁移 架构 ”请求。
  3. 执行 GET /api/v2/migration/schema/versions 并复制在 Response Body中生成的版本。
  4. 输入复制的架构版本作为 GET /api/v2/migration/schema/{schemaVersion} 的参数,然后执行 API。
  5. 从“ 响应正文 ”部分中选择“下载文件”。

结果:下载了一个 ZIP 文件,其中包含 TMH 文件中不同测试工件的架构。 ZIP 文件包含以下文件夹和文件:

  • 附件 文件夹 - 包含与每个对象关联的附件对应的子文件夹,对象 ID 是文件夹名称(测试用例、测试集、需求、测试执行等)。
  • An objects folder - contains subfolders corresponding to all types of objects available in Test Manager.
  • JSON 清单 文件 - 包含有关 WebExtension 的基本元数据。
  • readme.txt 文件 - 包含有关准备进入文件夹的数据的说明。

Preparing the TMH file

准备要导入的 TMK 文件时,我们建议使用不超过 2GB 的文件。将文件大小保持在此限制内可以避免导入过程中途中止。
按照每个子文件夹中的示例架构,指定要导入 JSON 文件的所有对象。

示例:要指定测试用例,请使用以下示例架构:

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

确保将括号内的数据更改为与 测试用例对应的数据。

  1. 为项目中的每个对象创建 JSON 文件后,将其添加到 objects 文件夹中的相应子文件夹。 您可以根据需要为 JSON 文件命名,但子文件夹的名称必须保持不变

    示例:将包含有关测试用例的数据的 JSON 文件添加到 testcases 子文件夹。

    重要提示: 如果要导入大量对象,请将其拆分为多个文件,例如testcases-1.jsontestcases-2.json 。 我们建议每个子文件夹最多添加 500 个文件。
  2. 使用以下文件夹层次结构添加与附件文件夹下的对象关联的 附件 文件: /attachments/object-id/file name
    • object-id - 将其替换为关联对象的 ID。
    • file name - 将其替换为附件的名称。

谁可以导入项目

Any user having a valid Test Manager License can import projects.

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

Importing a project in Test Manager

Prepare the exported TMH file and then review the project import details in Test Manager.
重要提示:准备要导入的 TMK 文件时,我们建议使用不超过 2GB 的文件。将文件大小保持在此限制内可以避免导入过程中途中止。
  1. Sign in to Test Manager.
  2. 单击 “导入项目”
  3. 添加 TMH 文件。 系统会自动获取项目详细信息,并将其列在“ 项目中的对象” 部分中,以便您在开始导入流程之前进行查看。
  4. (可选)编辑项目名称、前缀和说明。
  5. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.
  6. 查看信息,然后单击“ 导入 ”以启动流程。
    注意: 导入项目通常需要大约 10 到 15 分钟,但对于较大的项目,可能需要更长时间。

导入的项目将显示在“ 项目 ” 页面中,并显示为灰色,直到流程完成。



Importing into an existing project in Test Manager

  1. Sign in to Test Manager.
  2. 选择 “导入项目”
  3. 此处添加您下载的 TMH 文件

    系统会自动获取项目详细信息,并将其列在“ 项目文件中的对象” 部分中,以便您在开始导入流程之前进行查看。

  4. 在“ 目标”下选择“现有项目”。
  5. 从“ 项目” 下拉列表中选择要导入数据的目标项目。
    提示:
    • 如果您有较大的 TMH 文件,则可以将其拆分为多个文件,并在同一目标项目中分别导入。
    • 如果导出多个项目,则可以将其重新导入现有项目中。
  6. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.
  7. 查看信息,然后选择“ 导入 ”以启动流程。
    警告:测试结果 ” 字段始终为 0,因为未导出测试结果。

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



  8. 选择通知以转到新项目的“ 附件 ” 选项卡,您可以在其中查看:
    1. 迁移步骤日志(ZIP 文件)
    2. 已迁移对象的日志(ZIP 文件)
    3. 导入摘要(TXT 文件)- 显示实体的总数,以及导入或跳过的实体数量。

导入后步骤

导入后步骤

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.

查看自动化信息

要查看有关生成特定测试用例的自动化的信息,请执行以下操作:
  1. 在“ 导入项目 ” 页面中,选择底部的“ 包括测试用例的自动化信息 ”。
  2. 完成导入,并筛选导入的测试用例,应用 自动化 清除标签筛选器。
  3. 打开每个返回的测试用例,然后转到“ 详细信息 ” 选项卡以检索有关生成测试用例的自动化的信息。
    图 1.显示 自动化 已清除标签的“ 标签”下拉列表

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

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



此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。