Automatisation de test d'API

Studio prend en charge les projets d’automatisation de test d'API grâce à son intégration avec Postman, un outil de développement logiciel pour effectuer des appels de test vers les API. Cette intégration inclut également Newman, un exécuteur de collection de ligne de commande pour Postman pour exécuter et tester une collection directement à partir de la ligne de commande.

Pour importer une collection Postman dans Studio, utilisez l'assistant Nouveau service pour les bibliothèques et accédez à la collection Postman à l'aide d'une clé API générale, que vous pouvez générer à partir de la section Clés API.

Les collections importées peuvent être utilisées pour tester des projets. Des détails sur les conditions préalables de Postman sont disponibles ici.

Dans le contexte des tests, les collections Postman importées dans les bibliothèques Studio peuvent être publiées sous forme de package .nupkg localement ou dans Orchestrator, puis installées en tant que dépendances dans des projets d’automatisation de test.

Exemple d’automatisation des tests d'API

L’exemple suivant utilise une collecte de données définie dans Postman, l’importe dans une bibliothèque Studio, publie la bibliothèque avec la collection, l’installe dans un projet de test et utilise des activités de test faisant partie du module UiPath.Testing.Activities pour vérifier l’utilisation des données.

Les cas de test sont conçus pour un workflow qui s’applique automatiquement aux prêts et récupère les données de prêt pour les clients des banques.

Pour vérifier les conditions préalables d’installation de Postman et Newman, lisez cette page.

Décrivez une collecte de données

Dans Postman, définissez une collection de données ou importez-en une existante dans votre espace de travail actuel. Nous avons créé une collecte de données pour demander un prêt, récupérer et supprimer les détails du prêt. Lorsqu’elle est utilisée dans un projet de test d'API, cette collection vérifie si la logique de notre workflow est correcte.

Importer des collectes

Pour importer une collection dans Studio, créez un projet de bibliothèque et utilisez la fenêtre Nouveau service (New Service). L'accès à la collection est accordé par l'intermédiaire de la clé d'API Postman. Ajoutez cette clé dans le champ Fichier ou Lien (File or Link) et cliquez sur Charger (Load).

Sélectionnez uniquement les points de terminaison que vous souhaitez charger dans votre projet et ajoutez un nouvel espace de noms si nécessaire.

Cochez la case Collections liées afin d'utiliser un lien pour que la nouvelle version de votre collection soit exécutée dans le runtime, au lieu d’une version stockée localement. Cliquez sur Enregistrer une fois que vous avez terminé.

Utilisation des collectes de données

Une fois la collection importée dans la bibliothèque Studio, ses points de terminaison sont automatiquement transformés en activités, disponibles dans l’onglet Activités, dans l’espace de noms que vous avez précédemment défini.

Dans notre exemple, un fichier séquence distinct a été créé pour chaque activité générée à partir des points de terminaison.

Après avoir ajouté une activité, ajoutez l’environnement Postman (entre guillemets "") dans le panneau Propriétés.

Les valeurs de données définies dans la collection Postman sont importées sous forme d’arguments :

Les bibliothèques peuvent être publiées localement ou dans Orchestrator sous forme de package .nupkg.

Charger la bibliothèque dans le projet de test d'API

1. Créez un projet de test dans Studio en utilisant le type de projet Automatisation de test.
   
   

   

   
   
2. Installez la bibliothèque publiée en tant que dépendance à l’aide de la fenêtre Gérer les packages.
   
   

   

   
   
3. Les fichiers de séquence précédemment définis dans la bibliothèque sont maintenant disponibles dans le panneau Activités dans l’espace de noms de la bibliothèque, ainsi que les activités générées par l’importation Postman.
   
   

   

   
   
4. Utilisez ces activités dans votre projet d’automatisation des tests d'API, combinées à des activités faisant partie du pack UiPath.Testing.Activities. Nous avons créé un projet de test pour vérifier les données saisies lors de la demande de prêt dans notre application de démonstration. Ce petit test utilise un ensemble de variables codées en dur, visibles ici dans le panneau Propriétés :
   
   

   

   
   

   Ce processus de test simple a été utilisé comme un test de fumée, pour vérifier si l'application a répondu correctement. Plusieurs de ces tests peuvent être créés dans Studio, en fonction de vos besoins d'automatisation.

5. Pour vérifier plusieurs scénarios dans un projet de test, allez au ruban, Nouveau > Cas de test centré sur les données. Importez l’ensemble de données, comme expliqué ici. Voici un exemple de ce cas de test. Les valeurs sont maintenant stockées dans des arguments, mappés dans l’activité.
   
   

   

   
   
6. Sélectionnez Exécuter le fichier ou Déboguer le fichier avec des variations de données et choisissez les données à utiliser. Ceci est utile quand vous testez plusieurs scénarios avec plusieurs ensembles de données.
   
   

   

   
   

7. Après l’exécution du processus, les résultats sont visibles dans le panneau Sortie.

   
   

   

   
   

Utilisation d’un fichier ou d’un lien Swagger

Cet exemple montre comment effectuer l'automatisation de test d'API en chargeant un fichier Swagger JSON dans Studio ou un lien Swagger.

Prérequis

Pour suivre cet exemple, vous devez disposer de l'une des ressources suivantes :

• Un fichier JSON exporté depuis Swagger, qui se trouve sur votre machine.
• Lien vers un fichier Swagger.

Étapes

1. Dans votre projet de bibliothèque, dans le ruban Conception (Design), sélectionnez Nouveau service (New Service).

   La fenêtre Éditeur de service ( Service Editor) s'affiche.

2. Choisissez une ressource Swagger que vous souhaitez utiliser :
   • Pour un fichier Swagger JSON local, sélectionnez le menu Plus d'options adjacent au champ Fichier ou Lien . Recherchez et ouvrez le fichier Swagger souhaité à importer.
   • Si vous utilisez un lien vers un fichier Swagger, saisissez le lien Swagger directement dans le champ Fichier ou Lien (File or Link ).
3. Dans l' éditeur de service, sélectionnez Charger.

   Tous les points de terminaison définis à partir du fichier Swagger sont désormais chargés dans l ' éditeur de service.

4. Entrez la méthode ou l'opération dont vous avez besoin dans la zone de recherche Opérations de recherche (Search Operations) et affichez les résultats renvoyés.

   Pour les fichiers Swagger, les méthodes sont marquées de couleurs différentes pour chaque point de terminaison que vous souhaitez charger.

   L'espace de noms est généré automatiquement, mais vous pouvez le modifier.

5. Sélectionnez Enregistrer ( Save ) pour intégrer le service dans votre bibliothèque.

Figure 1. Un fichier Swagger chargé dans l' éditeur de service