Importar proyecto

Importe un archivo TMH desde un sistema externo a Test Manager como un proyecto nuevo o existente, migrando requisitos, casos de prueba, conjuntos de pruebas y archivos adjuntos.

Puede importar proyectos de fuentes externas para realizar operaciones de prueba a través de Test Manager. Usa esta característica para transferir proyectos de prueba completos desde diferentes sistemas de gestión del ciclo de vida de las aplicaciones (ALM) a Test Manager.

Cómo funciona

La importación del proyecto sigue un esquema que convierte los proyectos de sistemas externos (por ejemplo, aplicaciones de prueba) en un formato que Test Manager puede leer. Esto incluye objetos como requisitos, casos de prueba, conjuntos de pruebas, resultados de pruebas, etiquetas, campos personalizados, condiciones previas, condiciones posteriores y archivos adjuntos. El proceso de importación se realiza de forma asíncrona.

Consideraciones

• Se generan nuevos ID de objetos (GUID) durante la importación en Test Manager.
• Time stamps (Created Time, Updated Time) are maintained.
• Creado por y Actualizado por se refieren al usuario que envió la solicitud de importación del proyecto. No mantenemos el usuario original que creó el artefacto en el sistema ALM.
• Se omiten los archivos adjuntos que excedan el límite de tamaño (90 MB).
• Los enlaces de automatización no se transfieren durante la importación, porque la vinculación depende de los ID de automatización que son únicos para cada tenant.

Nota:

Después de importar un proyecto a un tenant diferente, desvincula y vuelve a vincular la automatización de cada caso de prueba a la automatización correspondiente en el Orchestrator del tenant de destino. De lo contrario, las ejecuciones automatizadas para ese caso de prueba permanecen bloqueadas en estado pendiente.

Quién puede importar proyectos

Cualquier usuario que tenga una licencia de Test Manager válida puede importar proyectos.

Para obtener más información consulta Gestión de acceso de usuarios y grupos.

Getting the schema version

The schema version is required to build the TMH file, and you retrieve it with API calls in Swagger.

Pasos

1. Ve a Swagger, utilizando el punto final de Test Manager que utilizas actualmente. Para conectar Swagger a tu Test Manager, consulta Referencias de 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.

Resultado

A ZIP file is downloaded. It contains the schema of the different testing artifacts in the TMH file.

El archivo ZIP contiene las siguientes carpetas y archivos:

• 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

Al preparar tus archivos TMH para la importación, se recomienda utilizar un tamaño de archivo no superior a 2 GB. Si mantienes el tamaño del archivo dentro de este límite, evitarás que el proceso de importación se cancele durante su transcurso.

Especifique todos los objetos que desea importar en archivos JSON, siguiendo los esquemas de muestra dentro de cada subcarpeta.

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

Asegúrate de cambiar los datos entre paréntesis por los datos correspondientes a tu caso de prueba.

1. Después de crear archivos JSON para cada objeto de un proyecto, añádelos a la subcarpeta correspondiente en la carpeta de objetos . Puedes nombrar los archivos JSON como quieras, pero los nombres de las subcarpetas deben ser los mismos. Ejemplo: añade los archivos JSON que contienen datos sobre casos de prueba a la subcarpeta testcases .
   Importante:

   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 : reemplaza esto con el ID del objeto asociado.
   • file name : reemplaza esto por el nombre del archivo adjunto.

Importar un proyecto en Test Manager

Importing a project creates a new Test Manager project from an exported TMH file.

Importante:

Al preparar tus archivos TMH para la importación, se recomienda utilizar un tamaño de archivo no superior a 2 GB. Si mantienes el tamaño del archivo dentro de este límite, evitarás que el proceso de importación se cancele durante su transcurso.

Pasos

1. Inicia sesión en Test Manager.
2. Selecciona Importar proyecto.
3. Añade el archivo TMH. Los detalles del proyecto se obtienen automáticamente y se enumeran en la sección Objetos en el proyecto para que puedas revisarlos antes de iniciar el proceso de importación.
4. Review the Objects in project section and check the data objects included in the project file.
5. (Optional) To include automation as part of your import, select the Include automation information for test cases check box.
6. (Optional) To include the project configuration as part of your import, select the Import project configuration check box.
7. (Opcional) Edita el nombre, el prefijo y la descripción del proyecto.
8. Revisa la información y selecciona Importar para iniciar el proceso.
   Nota:

   Importar el proyecto suele tardar entre 10 y 15 minutos, pero puede tardar más en proyectos más grandes.

9. 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.
   Nota:

   If the project import fails, contact UiPath® Support.

Resultado

The imported project shows up in the Projects page, grayed out until the process is completed. A Project Import Completed notification confirms the import.

Importar a un proyecto existente en Test Manager

Importing into an existing project merges the requirements, test cases, test sets, and other artifacts of a TMH file into the target project.

Pasos

1. Inicia sesión en Test Manager.

2. Selecciona Importar proyecto.

3. Add the TMH file that you downloaded here. Project details are automatically fetched and listed in the Objects in project file section so you can review before starting the import process.

4. Review the Objects in project file section and check the data objects included in the project file.

5. (Optional) To include automation as part of your import, select the Include automation information for test cases check box.

6. (Optional) To include the project configuration as part of your import, select the Import project configuration check box.

7. Selecciona Proyecto existente en Destino.

8. Selecciona el proyecto de destino, donde se importan los datos, en el menú desplegable Proyecto .

   Consejo:

   • Si tiene archivos TMH de tamaños más grandes, puede dividirlos en varios archivos e importarlos por separado dentro del mismo proyecto de destino.
   • Si exportas varios proyectos, puedes volver a importarlos dentro de un proyecto existente.

9. Revisa la información y selecciona Importar para iniciar el proceso.

   ADVERTENCIA:

   El campo Resultados de la prueba siempre es 0, porque los resultados de la prueba no se exportan.

10. When the process of importing an existing project is completed, you receive a Project Import Completed notification about the event.

    

11. Select the notification to go to the Attachments tab of the new project, where you can view:

    1. registros de los pasos de migración (archivo ZIP)
    2. registros de los objetos migrados (archivo ZIP)
    3. resumen de importación (archivo TXT): muestra el número total de entidades y cuántas de ellas se importaron u omitieron.

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

    Nota:

    If the project import fails, contact UiPath® Support.

Resultado

The data of the TMH file is imported into the selected project, and a Project Import Completed notification confirms the import.

Ver información de automatización

The Details tab of an imported test case shows the automation that generated it, provided that you included automation information in the import.

Pasos

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.

   Figura 1. La lista desplegable Etiquetas que muestra la etiqueta de automatización borrada

   

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

Resultado

La información de automatización que se muestra en la pestaña Detalles incluye:

• ID de automatización
• NombreDelProyectoDeAutomatización
• NombreDeCasoDePruebaDeAutomatización

Artículos relacionados

• Especificación del formato de archivo TMH