导入项目
您可以从外部来源导入项目,以通过 Test Manager 执行测试操作。使用此功能将整个测试项目从不同的应用程序生命周期管理 (ALM) 系统转移到 Test Manager。
项目导入时遵循的架构可将外部系统项目(例如,测试应用程序)转换为 Test Manager 可以读取的格式。这包括需求、测试用例、测试集、测试结果、标签、自定义字段和附件等对象。导入过程是异步完成的。
- 在 Test Manager 中导入期间会生成新的对象 ID (GUID)。
- 将维护时间戳(“创建时间”、“更新时间”)。
- “创建者” 和“ 更新 者” 是指提交项目导入请求的用户。 我们不会维护在 ALM 系统中创建项目的原始用户。
- 超出大小限制 (90 MB) 的文件附件将被跳过。
您需要 架构版本 来构建 TMH 文件。 检索架构版本涉及在 Swagger 中使用 API 调用。 要检索架构版本,请按照以下步骤操作:
- 使用您当前使用的 Test Manager 端点转到 Swagger。要将 Swagger 连接到 Test Manager,请访问 API 参考
- 转到“项目迁移 架构 ”请求。
- 执行 GET /api/v2/migration/schema/versions 并复制在 Response Body中生成的版本。
- 输入复制的架构版本作为 GET /api/v2/migration/schema/{schemaVersion} 的参数,然后执行 API。
- 从“ 响应正文 ”部分中选择“下载文件”。
结果:下载了一个 ZIP 文件,其中包含 TMH 文件中不同测试工件的架构。 ZIP 文件包含以下文件夹和文件:
- 附件 文件夹 - 包含与每个对象关联的附件对应的子文件夹,对象 ID 是文件夹名称(测试用例、测试集、需求、测试执行等)。
- 对象文件夹 - 包含与 Test Manager 中可用的所有对象类型相对应的子文件夹。
- JSON 清单 文件 - 包含有关 WebExtension 的基本元数据。
- readme.txt 文件 - 包含有关准备进入文件夹的数据的说明。
示例:要指定测试用例,请使用以下示例架构:
{
"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",
}
]
}
确保将括号内的数据更改为与 测试用例对应的数据。
-
为项目中的每个对象创建 JSON 文件后,将其添加到 objects 文件夹中的相应子文件夹。 您可以根据需要为 JSON 文件命名,但子文件夹的名称必须保持不变
示例:将包含有关测试用例的数据的 JSON 文件添加到 testcases 子文件夹。
重要提示: 如果要导入大量对象,请将其拆分为多个文件,例如testcases-1.json
和testcases-2.json
。 我们建议每个子文件夹最多添加 500 个文件。 -
使用以下文件夹层次结构添加与附件文件夹下的对象关联的 附件 文件:
/attachments/object-id/file name
。object-id
- 将其替换为关联对象的 ID。file name
- 将其替换为附件的名称。
任何拥有有效 Test Manager 许可证的用户都可以导入项目。
有关更多信息,请参阅“用户和组访问管理”。
导入的项目将显示在“ 项目 ” 页面中,并显示为灰色,直到流程完成。
导入后步骤
流程完成后,查看 Test Manager 中显示为通知的导入项目报告。导入摘要 PDF 文件以显示导入对象的状态。您可以调查对象迁移日志 csv 文件中尚未导入的单个对象。如果项目导入失败,请联系 UiPath™ 支持团队。