Importer un projet

Importez un fichier TMH à partir d'un système externe dans Test Manager en tant que projet nouveau ou existant, en migrant les exigences, les cas de test, les ensembles de tests et les pièces jointes.

Vous pouvez importer des projets à partir de sources externes pour effectuer des opérations de test via Test Manager. Utilisez cette fonctionnalité pour transférer des projets de test entiers de différents systèmes de gestion du cycle de vie des applications (ALM) vers Test Manager.

Mode de fonctionnement

L’importation du projet suit un schéma qui convertit les projets système externes (par ex. les applications de test) en un format pouvant être lu par Test Manager. Cela inclut des objets tels que les exigences, les cas de test, les ensembles de test, les résultats de test, les libellés, les champs personnalisés, les préconditions, les postconditions et les pièces jointes. Le processus d’importation s’effectue de façon asynchrone.

Considérations

• Les nouveaux ID d'objet (GUID) sont générés lors de l'importation dans Test Manager.
• Time stamps (Created Time, Updated Time) are maintained.
• Créé par et Mis à jour par fait référence à l'utilisateur qui a soumis la demande d'importation du projet. Nous ne conservons pas l’utilisateur d’origine qui a créé l’artefact dans le système ALM.
• Les pièces jointes dépassant les limites de taille (90 Mo) sont ignorées.
• Les liens d'automatisation ne sont pas transmis pendant l'importation, car la liaison dépend des ID d'automatisation qui sont uniques à chaque locataire.

Remarque :

Après avoir importé un projet dans un autre locataire, dissociez et reliez l'automatisation de chaque cas de test à l'automatisation correspondante dans l'Orchestrator du locataire de destination. Sinon, les exécutions automatisées de ce cas de test restent bloquées dans un état en attente.

Qui peut importer des projets

Tout utilisateur disposant d'une licence Test Manager valide peut importer des projets.

Pour plus d'informations, consultez Gestion des accès des utilisateurs et des groupes (User and Group Access Management).

Getting the schema version

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

Étapes

1. Accédez à Swagger à l'aide du point de terminaison Test Manager que vous utilisez actuellement. Pour connecter Swagger à votre Test Manager, consultez références de l'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.

Résultat

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

Le fichier ZIP contient les dossiers et fichiers suivants :

• 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

Lorsque vous préparez vos fichiers THM pour l'importation, nous vous recommandons d'utiliser une taille de fichier ne dépassant pas 2 Go. En maintenant la taille du fichier dans cette limite, vous pouvez éviter que le processus d'importation soit abandonné à mi-parcours.

Spécifiez tous les objets que vous souhaitez importer dans des fichiers JSON, en suivant les exemples de schémas à l'intérieur de chaque sous-dossier.

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

Assurez-vous de modifier les données entre parenthèses avec les données correspondant à votre cas de test.

1. Après avoir créé des fichiers JSON pour chaque objet d'un projet, ajoutez-les au sous-dossier correspondant dans le dossier des objets . Vous pouvez nommer les fichiers JSON comme vous le souhaitez, mais les noms des sous-dossiers doivent rester les mêmes Exemple: ajoutez les fichiers JSON qui contiennent des données sur les cas de test au sous-dossier testcases .
   Important :

   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 : remplacez-le par l'ID de l'objet associé.
   • file name : remplacez-le par le nom de la pièce jointe.

Importer un projet dans Test Manager

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

Important :

Lorsque vous préparez vos fichiers THM pour l'importation, nous vous recommandons d'utiliser une taille de fichier ne dépassant pas 2 Go. En maintenant la taille du fichier dans cette limite, vous pouvez éviter que le processus d'importation soit abandonné à mi-parcours.

Étapes

1. Connectez-vous à Test Manager.
2. Sélectionnez Importer un projet.
3. Ajoutez le fichier TMH. Les détails du projet sont automatiquement récupérés et répertoriés dans la section Objets du projet afin que vous puissiez les examiner avant de commencer le processus d’importation.
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. (Facultatif) Modifiez le nom, le préfixe et la description du projet.
8. Examinez les informations et sélectionnez Importer pour démarrer le processus.
   Remarque :

   L’importation du projet prend généralement environ 10 à 15 minutes, mais cela peut prendre plus de temps pour les grands projets.

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.
   Remarque :

   If the project import fails, contact UiPath® Support.

Résultat

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

Importation dans un projet existant dans 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.

Étapes

1. Connectez-vous à Test Manager.

2. Sélectionnez Importer un projet.

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. Sélectionnez Projet existant sous Cible.

8. Dans la liste déroulante Projet , sélectionnez le projet cible dans lequel les données sont importées.

   Astuce :

   • Si vous avez des fichiers TMH de plus grande taille, vous pouvez les diviser en plusieurs fichiers et les importer séparément dans le même projet cible.
   • Si vous exportez plusieurs projets, vous pouvez les réimporter dans un projet existant.

9. Examinez les informations et sélectionnez Importer pour démarrer le processus.

   Avertissement :

   Le champ Résultats des tests est toujours défini sur 0, car les résultats des tests ne sont pas exportés.

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. journaux des étapes de migration (fichier ZIP)
    2. journaux des objets migrés (fichier ZIP)
    3. résumé de l'importation (fichier TXT) : indique le nombre total d'entités et combien d'entre elles ont été importées ou ignorées.

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.

    Remarque :

    If the project import fails, contact UiPath® Support.

Résultat

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

Affichage des informations sur l'automatisation

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

Étapes

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.

   Figure 1. La liste déroulante Libellés affichant le libellé Automatisation effacé

   

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

Résultat

Les informations d'automatisation affichées dans l'onglet Détails incluent :

• Identifiant d’automatisation
• NomProjetAutomation
• NomCasTestAutomation

Articles associés

• Spécification du format de fichier TMH