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

La versión del esquema es necesaria para crear el archivo TMH y se recupera con llamadas a la API en 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

Se descarga un archivo ZIP. Contiene el esquema de los diferentes artefactos de prueba en el archivo TMH.

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

Al importar un proyecto se crea un nuevo proyecto de Test Manager a partir de un archivo TMH exportado.

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. Revisa la sección Objetos en el proyecto y comprueba los objetos de datos incluidos en el archivo del proyecto.
5. (Opcional) Para incluir la automatización como parte de tu importación, selecciona la casilla de verificación Incluir información de automatización para casos de prueba .
6. (Opcional) Para incluir la configuración del proyecto como parte de tu importación, selecciona la casilla de verificación Importar configuración del proyecto .
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. Revisa el informe de importación del proyecto que se muestra en Test Manager como notificación después de que se complete el proceso. El archivo PDF de resumen de importación muestra el estado de los objetos importados. Puedes investigar objetos individuales que no se hayan importado en el archivo csv del registro de migración de objetos.
   Nota:

   Si la importación del proyecto falla, ponte en contacto con el soporte de UiPath®.

Resultado

El proyecto importado aparece en la página Proyectos , en gris hasta que se completa el proceso. Una notificación de Importación de proyecto completada confirma la importación.

Importar a un proyecto existente en Test Manager

La importación a un proyecto existente fusiona los requisitos, casos de prueba, conjuntos de pruebas y otros artefactos de un archivo TMH en el proyecto de destino.

Pasos

1. Inicia sesión en Test Manager.

2. Selecciona Importar proyecto.

3. Añade el archivo TMH que descargaste aquí. Los detalles del proyecto se obtienen automáticamente y se enumeran en la sección Objetos en el archivo del proyecto para que puedas revisarlos antes de iniciar el proceso de importación.

4. Revisa la sección Objetos en el archivo del proyecto y comprueba los objetos de datos incluidos en el archivo del proyecto.

5. (Opcional) Para incluir la automatización como parte de tu importación, selecciona la casilla de verificación Incluir información de automatización para casos de prueba .

6. (Opcional) Para incluir la configuración del proyecto como parte de tu importación, selecciona la casilla de verificación Importar configuración del proyecto .

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. Cuando se completa el proceso de importación de un proyecto existente, recibes una notificación de Importación de proyecto completada sobre el evento.

    

11. Selecciona la notificación para ir a la pestaña Archivos adjuntos del nuevo proyecto, donde puedes ver:

    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. Revisa el informe de importación del proyecto que se muestra en Test Manager como notificación después de que se complete el proceso. El archivo PDF de resumen de importación muestra el estado de los objetos importados. Puedes investigar objetos individuales que no se hayan importado en el archivo csv del registro de migración de objetos.

    Nota:

    Si la importación del proyecto falla, ponte en contacto con el soporte de UiPath®.

Resultado

Los datos del archivo TMH se importan al proyecto seleccionado, y una notificación de Importación de proyecto completada confirma la importación.

Ver información de automatización

La pestaña Detalles de un caso de prueba importado muestra la automatización que lo generó, siempre que hayas incluido información de automatización en la importación.

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