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.

   
   

   

   
   

Using a Swagger file or link

This example shows how to perform API Test Automation by loading either a Swagger JSON file in Studio or a Swagger link.

Prérequis

To follow this example, you need to have one of the following resources available:

• A JSON file exported from Swagger, that is located on your machine.
• A link to a Swagger file.

Étapes

1. In your library project, from the Design ribbon, select New Service.

   The Service Editor window is displayed.

2. Choose a Swagger resource you want to use:
   • For a local JSON Swagger file, select the More Options menu adjacent to the File or Link field. Browse and open the desired Swagger file to import.
   • If you are using a link to a Swagger file, enter the Swagger link directly into the File or Link field.
3. In the Service Editor, select Load.

   All defined endpoints from the Swagger file are now loaded in the Service Editor.

4. Type in the method or operation you need in the Search Operations search box and view the returned results.

   For Swagger files, the methods are marked with different colors for each endpoint that you want to load.

   The namespace is generated automatically, but you can edit it.

5. Select Save to integrate the service into your library.

Figure 1. A loaded Swagger file in the Service Editor