Importer un projet

You can import projects from external sources to conduct testing operations through Test Manager. Use this feature to transfer entire testing projects from different Application Lifecycle Management (ALM) systems to Test Manager.

Mode de fonctionnement

Importing the project follows a schema that converts external system projects (e.g., testing applications) into a format that can be read by Test Manager. This includes objects such as requirements, test cases, test sets, test results, labels, custom fields, preconditions, postconditions, and attachments. The import process is done asynchronously.

Considérations

• New Object IDs (GUIDs) are generated during import in 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

Any user having a valid Test Manager License can import projects.

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. Go to Swagger, using the Test Manager endpoint that you currently use. To connect Swagger to your Test Manager, visit API References
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.).
• An objects folder - contains subfolders corresponding to all types of objects available in 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

Any user having a valid Test Manager License can import projects.

Pour plus d'informations, consultez Gestion des accès des utilisateurs et des groupes.

Importing a project in Test Manager

Prepare the exported TMH file and then review the project import details in 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. Sign in to 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. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.
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é.

Importing into an existing project in Test Manager

1. Sign in to 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. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.
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

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. If the project import fails, contact UiPath® Support.

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