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