Importer un projet

Vous pouvez importer des projets à partir de sources externes afin d’effectuer des opérations de test via Test Manager. Utilisez cette fonctionnalité afin de transférer des projets de test complets depuis 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 (des applications de test, par exemple) 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

• De nouveaux ID d’objet (GUID) sont générés au cours de l’importation dans Test Manager.
• Les horodatages (Heurede création ,Heure de miseà jour ) sont conservés.
• Créé paret Mis à jour par font référence à l'utilisateur qui a soumis la demande d'importation de 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. Accédez à la requête ProjectMigrationSchema .
3. Exécutez GET /api/v2/migration/schema/versions et copiez la version générée dans le corps de la réponse.
4. Saisissez la version du schéma copiée en tant que paramètre pour GET /api/v2/migration/schema/{schemaVersion} et exécutez l'API.
5. Sélectionnez Télécharger le fichier dans la section Corps de la réponse .

Résultats: un fichier ZIP est téléchargé, qui contient le schéma des différents artefacts de test dans le fichier TMH. Le fichier ZIP contient les dossiers et fichiers suivants :

• Un dossier des pièces jointes - contient des sous-dossiers correspondant aux pièces jointes associées à chaque objet, l'ID de l'objet est le nom du dossier (cas de test, ensembles de test, exigences, exécutions de test, etc.).
• Un dossier d’objets : contient des sous-dossiers correspondant à tous les types d’objets disponibles dans Test Manager.
• Un fichier manifeste JSON - contient des métadonnées de base sur votre WebExtension.
• Un fichier readme.txt - contient des instructions pour préparer les données qui vont à l'intérieur des 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.

Exemple: pour spécifier un cas de test, utilisez l'exemple de schéma ci-dessous :

{
  "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 remplacer les données entre parenthèses par 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 : si vous avez un grand nombre d'objets à importer, divisez-les en plusieurs fichiers, tels que testcases-1.json et testcases-2.json . Nous vous recommandons d'ajouter un nombre maximum de 500 fichiers par sous-dossier.
2. Ajoutez les fichiers de pièces jointes associés aux objets sous le dossier des pièces jointes , en utilisant la hiérarchie de dossiers suivante : /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.

Importer un projet dans Test Manager

Préparez le fichier TMH exporté, puis vérifiez les détails d’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. Cliquez sur Importer le projet (Import project).
3. Ajoutez le fichier TMH. Les détails du projet sont automatiquement récupérés et répertoriés dans la section Objets dans le projet afin que vous puissiez les examiner avant de démarrer le processus d'importation.
4. (Facultatif) Modifiez le nom, le préfixe et la description du projet.
5. L’option Inclure des informations d’automatisation pour les cas de test est automatiquement sélectionnée afin que vous puissiez importer les informations des automatisations ainsi que d’autres informations pertinentes. Par exemple, une automatisation liée à un cas de test sera importée dans Test Manager avec tous les détails et toutes les étapes du cas de test.
6. Examinez les informations et cliquez sur Importer ( Import ) 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 projets plus importants.

Le projet importé apparaît sur la page Projets (Projects), en grisé jusqu'à ce que le processus soit terminé.

Importer dans un projet existant dans Test Manager

1. Connectez-vous à Test Manager.
2. Sélectionnez Importer un projet.
3. Ajoutez ici le 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 dans le fichier de projet afin que vous puissiez les examiner avant de démarrer le processus d'importation.

4. Sélectionnez Projet existant sous Cible.
5. Sélectionnez le projet cible, dans lequel les données sont importées, dans la liste déroulante Projet (Project) .
   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.
6. L’option Inclure des informations d’automatisation pour les cas de test est automatiquement sélectionnée afin que vous puissiez importer les informations des automatisations ainsi que d’autres informations pertinentes. Par exemple, une automatisation liée à un cas de test sera importée dans Test Manager avec tous les détails et toutes les étapes du cas de test.
7. Examinez les informations et sélectionnez Importer pour démarrer le processus.
   Avertissement : le champ Résultats des tests ( Test Results ) est toujours 0, car les résultats des tests ne sont pas exportés.

   Lorsque le processus d'importation d'un projet existant est terminé, vous recevrez une notification Importation de projet terminée ( Project Import Completed) concernant l'événement.

   
   

   

   
   
8. Sélectionnez la notification pour 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’ assistanceUiPath® .

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. Dans la page Importer le projet (Import project), sélectionnez Inclure les informations d'automatisation pour les cas de test en bas.
2. Terminez l'importation et filtrez les cas de test importés, en appliquant le filtre de libellé automationcleared .
3. Ouvrez chaque cas de test renvoyé et accédez à l'onglet Détails (Details) pour récupérer les informations sur l'automatisation qui a généré le cas de test.
   Figure 1. La liste déroulante Étiquettes (Labels) affichant le libellé défini par automatisation
   

   

   
   

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

• Identifiant d’automatisation
• NomProjetAutomation

• NomCasTestAutomation