Importer un projet

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.
• Les horodatages (Heure de création,Heure de mise à jour) sont conservés.
• 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.

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

Vous avez besoin de la version du schéma pour créer le fichier TMH. La récupération de la version du schéma implique l’utilisation d’appels d’API dans Swagger. Pour récupérer la version du schéma, suivez les étapes ci-dessous :

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ésultats: un fichier ZIP est téléchargé, qui présente le schéma des différents artefacts de test dans le fichier TMH.

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

• Un dossier d’objets : contient des sous-dossiers correspondant à tous les types d’objets disponibles dans Test Manager. * Un fichier manifeste JSON - contient les métadonnées de base sur votre WebExtension. * Un fichier readme.txt - contient des instructions pour la préparation des données qui se trouvent dans les dossiers.

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:

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.

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

Importer un projet dans Test Manager

Préparez le fichier TMH exporté, puis examinez les détails de l'importation du projet dans Test Manager.

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.

1. Connectez-vous à Test Manager.
2. Sélectionnez Importer un projet.
3. Ajoutez le fichier THM. 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 démarrer le processus d'importation. 3a. Examinez les objets dans le fichier de projet. Sous Objets dans le fichier de projet, vérifiez les objets de données inclus dans le fichier de projet. Pour inclure l'automatisation dans le cadre de votre importation, cochez la case Inclure les informations d'automatisation pour les cas de test . Pour inclure la configuration du projet dans le cadre de votre importation, cochez la case Importer la configuration du projet .
4. (Facultatif) Modifiez le nom, le préfixe et la description du projet.
5. 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.

Le projet importé est affiché sur la page Projets , grisé jusqu’à ce que le processus soit terminé.

Importation dans un projet existant dans Test Manager

Importez un fichier TMH dans un projet Test Manager existant afin de fusionner des artéfacts de test externes (exigences, cas de test, ensembles de test, etc.) dans le projet cible.

1. Connectez-vous à Test Manager.
2. Sélectionnez Importer un projet.
3. Ajoutez icile fichier THM que vous avez téléchargé

Les détails du projet sont automatiquement récupérés et répertoriés dans la section Objets du fichier de projet afin que vous puissiez les examiner avant de démarrer le processus d'importation. 3a. Examinez les objets dans le fichier de projet. Sous Objets dans le fichier de projet, vérifiez les objets de données inclus dans le fichier de projet.

Pour inclure l'automatisation dans le cadre de votre importation, cochez la case Inclure les informations d'automatisation pour les cas de test . Pour inclure la configuration du projet dans le cadre de votre importation, cochez la case Importer la configuration du projet . 4. Sélectionnez Projet existant sous Cible. 5.

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

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

6. Examinez les informations et sélectionnez Importer pour démarrer le processus. :::avertissement Le champ Résultats de tests est toujours 0, car les résultats de test ne sont pas exportés. :::

Lorsque le processus d’importation d’un projet existant sera terminé, vous recevrez une notification Importation du projet terminée à propos de l’événement.

8. Sélectionnez la notification afin d'accéder à l'onglet Pièces jointes du nouveau projet, où vous pourrez afficher:

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.

Étapes post-importation

Étapes post-importation

Examinez le rapport de projet d’importation qui s’affiche sous forme de notification dans Test Manager une fois le processus terminé. Le fichier PDF qui récapitule l’importation indique le statut des objets importés. Vous pouvez enquêter sur des objets individuels n’ayant pas été importés dans le fichier csv du journal de migration des objets. Si l’importation du projet échoue, contactez l’ assistance UiPath®.

Affichage des informations sur l'automatisation

Pour afficher des informations sur l'automatisation qui a généré un cas de test spécifique :

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.
3. Open every returned test case, and go to the Details tab to retrieve the information about the automation that generated the test case.

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

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

• Identifiant d’automatisation

• NomProjetAutomation

• NomCasTestAutomation

  

Voir aussi: Spécification du format de fichier TMH

Résultat

Le projet est importé dans Test Manager et s'affiche sur la page Projets une fois le processus terminé. Une notification Importation de projet terminée confirme l'importation.