understanding variable scopes
Ce didacticiel couvrira différents types de variables prises en charge par l'outil Postman et comment elles peuvent être utilisées lors de la création et de l'exécution des demandes et des collections de facteur:
Nous aborderons également le concept de fichiers d'environnement et verrons comment ils peuvent être exploités lors de la création et de l'exécution de collections.
=> Consultez le guide de formation Perfect Postman ici.
Ce que vous apprendrez:
Quelles sont les variables dans Postman?
Les variables, comme tout autre langage de programmation, ne sont rien d'autre que des espaces réservés pour contenir une valeur ou un résultat de certaines expressions.
Par exemple , Considérez une déclaration de variable en C # / Javascript qui contient la valeur de chaîne «hello world!». Désormais, chaque fois que cette chaîne est requise, quelqu'un peut simplement utiliser le nom de la variable pour remplacer la valeur par la chaîne réelle.
var z='hello world!'
Essayons d'approfondir les variables de Postman.
Les variables ici sont généralement utilisées dans un contexte où vous devez remplacer des valeurs dans les corps de requête, faire des assertions pour le corps de la réponse et les utiliser dans des scripts de pré-requête pour gérer la logique de prétraitement si nécessaire.
Tout d'abord, essayons de comprendre les différentes portées de variables dans Postman. La portée n'est rien d'autre que la durée de vie et l'accessibilité d'une variable. C'est similaire au concept de portée que nous avons dans les langages de programmation comme Java.
Par exemple , une variable peut avoir une portée globale, c'est-à-dire que toute classe / méthode peut accéder / modifier la variable jusqu'à ce que la méthode ou le programme soit actif.
De même, il peut y avoir différents types qui ont une portée spécifique car les variables locales déclarées dans la méthode ne peuvent être utilisées que jusqu'au moment où cette fonction est en cours d'exécution. De même, les variables déclarées dans les boucles for ne peuvent être utilisées que pendant l'exécution de cette boucle.
Voici un didacticiel vidéo:
Postman propose 5 types différents de portées variables comme indiqué ci-dessous:
questions d'entrevue de services Web pour expérimentés
- Global
- Collection
- Environnement
- Données
- Local
Noter: Il est important de comprendre que tous les différents types de variables Postman peuvent être ajoutés / supprimés à l’aide de la console Postman et que la plupart d’entre eux sont également accessibles et mis à jour à l’aide de scripts.
Essayons de comprendre chacun de ces types de variables et leur portée en détail !!
Types de variables dans Postman
# 1) Mondial
Que sont les variables globales et quand doivent-elles être utilisées?
Les variables globales sont des variables à usage général et doivent être principalement évitées et utilisées uniquement pour les exigences de prototypage rapide. Ces variables sont disponibles pour toutes les demandes disponibles dans la console Postman, quelle que soit la collection à laquelle elles appartiennent.
Ces variables sont analogues aux variables de portée globale dans les langages de programmation comme Java, C #, etc., où les variables globales sont accessibles à toutes les parties du programme. Cependant, ces variables sont très peu fiables car chaque section de code peut accéder / modifier la valeur de la variable globale.
Travailler avec des variables globales
Pour travailler avec des variables globales, elles peuvent être contrôlées via la console Postman ainsi que les scripts des requêtes Postman.
Dans la console Postman, cliquez sur l'icône «Eye» près du sélecteur d'environnement, et cela ouvrira une fenêtre contextuelle / contextuelle avec des détails autour des variables globales actuelles.
Créez maintenant une nouvelle variable en entrant le nom de la variable et sa valeur initiale.
La valeur initiale est quelque chose qui est conservé par défaut pour cette variable et la valeur actuelle continue de changer à mesure qu'elle est définie ou mise à jour dans les demandes qui utilisent ces variables.
En utilisant le script, les variables d'environnement sont accessibles en utilisant «pm. globaux »
Utilisez la commande ci-dessous pour obtenir la valeur d’une variable globale nommée «testVar».
pm.globals.get('testVar');
Utilisez la commande ci-dessous pour définir la valeur d’une variable globale nommée «testVar».
pm.globals.set('testVar', 'Hello Postman tutorial!');
Si vous souhaitez supprimer une variable globale via un script, vous pouvez utiliser la fonction unset comme indiqué ci-dessous.
pm.globals.unset('testVar');
Pour effacer toutes les variables globales via le script, vous pouvez utiliser la fonction ci-dessous.
pm.globals.clear();
# 2) Collection
Que sont les variables de collection et quand doivent-elles être utilisées?
Les variables de collection sont utilisées pour définir des variables au niveau de la portée de la collection. Comme nous le savons, une collection dans Postman n'est rien d'autre qu'un groupe de requêtes Postman.
Les variables de collection ne changent pas pendant l'exécution d'une collection ou d'une requête à l'intérieur de la collection donnée. Essentiellement, les variables de collection peuvent être simplement récupérées et non mises à jour pendant l'exécution de la demande.
Veuillez noter que les variables de collection ne sont accessibles que par les requêtes qui font partie de la collection et non par d'autres requêtes.
Comment sont-ils créés?
Les variables de collection peuvent être créées et / ou supprimées uniquement à l'aide de la console d'application Postman.
#1) Sélectionnez la collection dans laquelle vous souhaitez ajouter une variable. Faites un clic droit et sélectionnez modifier.
#deux) Sélectionnez maintenant le 'Variables' tab et ajoutez les variables de collection qui doivent être ajoutées.
Utilisation des variables de collection
Pour une utilisation à l'intérieur d'une requête, les variables de collection peuvent être référencées à l'aide d'un script Postman générique et selon la règle de portée la plus proche, s'il n'y a pas d'autre variable plus proche que la portée de la collection, la variable de collection est renvoyée.
pm.variables.get('testCollectionVar');
Pour utiliser les variables Postman dans le cadre du générateur de requêtes, utilisez simplement la syntaxe des doubles accolades comme indiqué ci-dessous.
# 3) Environnement
Quelles sont les variables d'environnement?
Les variables d'environnement sont le type de variables le plus utilisé dans Postman.
Ils sont liés à un environnement sélectionné utilisé pour exécuter la demande. Elles ont une portée plus étroite que les variables globales mais plus large que les variables de collection.
Quand utiliser les variables d'environnement?
- Les variables d'environnement sont idéales lorsque vous travaillez avec différents serveurs. Par exemple , généralement, lorsque vous travaillez sur un projet, vous travaillez avec de nombreux environnements différents comme le développement, le test, la mise en scène et la production, etc.
Dans ce type de scénario, vous pouvez créer un fichier d'environnement correspondant aux différents environnements pris en charge par votre application. Par exemple, variables d'environnement pour différents environnements tels que dev, test, etc. - Lorsqu'il est nécessaire de transmettre des données ou des informations d'une demande à une autre, les variables d'environnement sont un bon choix, car elles ont une portée plus large que les variables locales et une portée plus étroite que les variables globales.
Comment sont-ils créés?
Contrairement aux variables de collection, les variables d'environnement peuvent être créées à la fois via la console et via le script lui-même.
Pour créer des variables d'environnement via la console, un environnement actif doit être créé qui n'est rien d'autre qu'un conteneur de variables d'environnement. Veuillez vous référer aux captures d'écran ci-dessous pour créer un nouvel environnement et y ajouter des variables d'environnement.
Maintenant vous pouvez cliquer 'Ajouter' pour sauver le nouvel environnement. Une fois enregistré, vous pouvez simplement cliquer sur le 'Réglages' icône pour gérer / ajouter de nouveaux environnements.
Afin d'utiliser l'environnement créé, vous devrez choisir l'environnement à utiliser, en sélectionnant le bon environnement dans la liste déroulante des environnements.
Utilisation des variables d'environnement
Semblable aux variables Collection & Global, les variables d'environnement peuvent être utilisées par programme via le script et peuvent être utilisées directement dans le cadre des URL ou du corps de la requête via la syntaxe des doubles accolades.
Lorsqu'un environnement approprié est sélectionné dans le sélecteur d'environnement, vous pouvez simplement utiliser la syntaxe des doubles accolades pour accéder à une variable d'environnement comme illustré dans la capture d'écran ci-dessous.
Pour utiliser les variables d'environnement via le script, vous pouvez utiliser pm.environment.get et pm.environment.set pour récupérer et ajouter / modifier des variables d'environnement respectivement.
pm.environment.get('testEnvVar') pm.environment.set('testEnvVar',10)
Veuillez noter qu'ici, nous utilisons pm.environment et non pm.variables, c'est-à-dire que la portée est toujours définie sur l'environnement et Postman essaiera de trouver la variable uniquement dans l'environnement sélectionné.
# 4) Local
Que sont les variables locales?
entretien de génie logiciel questions et réponses pdf
Les variables locales ne sont disponibles que dans le contexte d'une exécution de requête particulière. Ceci est en analogie avec les variables de niveau de fonction dans les langages de programmation modernes comme Java et C #. Celles-ci sont exactement similaires aux variables de fonction dans lesquelles les variables ont simplement accès dans le contexte de l'exécution de la fonction.
Un cas d'utilisation important des variables locales est qu'elles peuvent être utilisées lorsque vous souhaitez remplacer les valeurs d'une variable qui est définie dans toute autre portée telle que Global, Collection ou Environment.
Par exemple, supposons qu'il existe une variable globale nommée «testVar» et que vous souhaitez maintenant remplacer la valeur sans affecter la variable globale, vous pouvez créer une variable locale avec le même nom et l'utiliser avec la valeur que vous aimez.
Quand utiliser les variables locales?
Les variables locales peuvent être utilisées de la même manière que les variables de collection, globales et d'environnement dont nous avons parlé dans les sections précédentes de ce didacticiel.
Il est important de noter ici que, pour utiliser les variables locales par programmation, vous devez utiliser pm.variables.get / pm.variables.set contrairement à pm.environment ou pm.global qui a été utilisé pour les variables Environnement et Global.
pm.variables.get('testVar') pm.variables.set('testEnvVar',10)
# 5) Données
Que sont les variables de données?
Les variables de données viennent dans le contexte de l'exécution de la demande via le runner de collecte.
Postman nous permet d'exécuter des requêtes dans une collection via le runner de collecte et pendant l'exécution, nous pouvons fournir un ensemble de données sous la forme de JSON ou CSV qui sont utilisés lors de l'exécution des requêtes à l'intérieur de la collection.
Il est important de noter ici que la source des variables de données est le fichier de données fourni par l'utilisateur au format JSON ou CSV, et lors de l'exécution de la requête, les variables de données peuvent uniquement être récupérées mais pas mises à jour / modifiées ou ajoutées.
Quand utiliser les variables de données?
Les variables de données sont utilisées lorsque nous travaillons avec plusieurs ensembles de données et elles n'existent que pendant l'exécution d'une itération à partir du fichier de données.
Comment utiliser une variable de données?
Voyons un scénario de bout en bout d’exécution de requêtes via le runner de collecte et de fourniture d’un fichier de données dont la valeur est remplacée pendant l’exécution de la requête.
modèles de cycle de vie de développement logiciel pdf
Ajoutons une simple requête GET à une nouvelle collection pour illustrer le concept de variables de données. Nous utiliserons le même point de terminaison GET https://reqres.in/api/users/{userId}
Nous allons récupérer le {userId} via une variable Data qui sera sauvegardée par un fichier CSV contenant les valeurs de l'ID utilisateur.
Veuillez suivre les étapes ci-dessous pour comprendre le déroulement.
#1) Remplacez l'URL de la requête dans le générateur de requêtes Postman par https://reqres.in/api/users/{{testDataVar}}.
#deux) Ici, {{testDataVar}} est notre variable de données dont la valeur sera extraite de la source de données qui sera utilisée avec le runner de collecte.
# 3) Créez un nouveau fichier de données au format CSV avec le nom de la colonne «testDataVar».
Définissez les données dans le fichier CSV comme ci-dessous:
testDataVar 1 2 3 4 5
# 4) Enregistrez le fichier sur le système de fichiers local et utilisez ce fichier lors de l'exécution de la collection via le programme d'exécution de la collection.
# 5) Sélectionnez maintenant la collection et cliquez sur Exécuter pour exécuter les demandes de collection via le runner de collection.
# 6) Sélectionnez le fichier de données csv créé dans la configuration du runner de collecte et le type de fichier text / csv.
# 7) Cliquez maintenant sur «Run Postman collection» et reportez-vous à la fenêtre «Run Results». Il existe un détail d'exécution pour la requête configurée pour chaque itération effectuée. Le nombre d'itérations dépend du nombre d'entrées de données qui ont été configurées dans le fichier CSV.
Vous pouvez voir plus de détails sur les URL de demande, etc., dans les résultats de l'exécuteur de collecte, pour valider si les valeurs des variables de données ont été correctement transmises aux URL de demande. En règle générale, les variables de données sont utilisées lorsque les demandes de collecte doivent être exécutées sur plusieurs ensembles de données selon les valeurs configurées dans les fichiers de données.
Accéder aux variables du facteur
Les variables Postman sont accessibles de 2 manières, comme indiqué ci-dessous.
- Dans la demande, les variables de générateur sont accessibles à l'aide d'un format d'accolade double. Veuillez noter que lors de la résolution de la variable, la valeur de la variable de portée la plus proche sera remplacée avant que la requête ne soit exécutée.
- Dans le script, comme le script de pré-requête, les tests, les assertions, etc., les variables peuvent être consultées / modifiées en utilisant la syntaxe ci-dessous.
Pour récupérer une variable:
pm.variables.get( ‘variable-name’ )
Pour définir une valeur de variable.
pm.variables.set( ‘variable-name’ , ’variable-value’ )
Il est important de noter ici que lorsqu'une variable est définie, elle essaiera de trouver la variable de portée la plus proche et de définir ou de modifier cette variable. Dans le cas où il n'y a pas de variable trouvée pendant le set, le script Postman créera simplement une nouvelle variable locale.
Notes et astuces
#1) Il est conseillé d'avoir différents noms de variables dans différentes portées, pour éviter toute confusion car le sandbox Postman choisira la variable avec la portée la plus proche lorsqu'il essaiera de résoudre des variables dans le générateur de requêtes avec un format d'accolade double ou lorsque le pm.variables.get / Le script pm.variables.set est résolu.
#deux) Pour les variables d'environnement, seul l'environnement sélectionné est efficace, c'est-à-dire que lors de la résolution des variables, Postman examinera uniquement l'environnement sélectionné.
# 3) Veuillez noter une règle générale: une variable ayant la portée la plus proche a la priorité sur les autres. Par exemple, s'il existe une variable globale nommée «input1» et qu'il existe une variable locale avec le même nom et si la variable est référencée dans la portée d'une variable locale, la variable de la portée locale a plus de priorité par rapport à la variable globale.
Conclusion
Dans ce didacticiel, nous avons abordé de nombreux concepts liés aux variables dans Postman ainsi que les différentes façons de les utiliser. Nous avons discuté des types de variables telles que Global, Collection, Environment, Local & Data et quand utiliser chacune d'elles.
En un mot, les variables Postman ajoutent beaucoup de puissance à la manière dont l'outil peut être utilisé et configuré pour exécuter des requêtes et des tests de manière efficace. Peu de références de la documentation officielle du facteur ont pu être obtenues ici.
=> Visitez ici pour voir de A à Z des didacticiels de formation Postman ici.
lecture recommandée
- Variables en C ++
- Variables Python
- Variables VBScript: Comment déclarer et utiliser des variables - VBScript Dim
- Types de données et variables C # avec exemples
- Tutoriel POSTMAN: Test d'API avec POSTMAN
- Variables et fonctions JMeter
- Configuration de l'environnement de développement pour C ++
- Qualificateurs de type et classes de stockage en C ++