Menu

Comprensione degli ambiti variabili e dei file di ambiente in Postman

  • Principale
  • Altro
  • Comprensione degli ambiti variabili e dei file di ambiente in Postman

understanding variable scopes

Prova Il Nostro Strumento Per Eliminare I Problemi

Questo tutorial tratterà diversi tipi di variabili supportate dallo strumento Postman e come possono essere utilizzate durante la creazione e l'esecuzione di richieste e raccolte di Postman:

Tratteremo anche il concetto di file di ambiente e vedremo come possono essere sfruttati durante la creazione e l'esecuzione delle raccolte.

=> Dai un'occhiata alla guida alla formazione del postino perfetto qui.

Ambiti variabili e file di ambiente

Cosa imparerai:

Cosa sono le variabili in Postman?

Le variabili, come qualsiasi altro linguaggio di programmazione, non sono altro che segnaposto per contenere un valore o un risultato di alcune espressioni.

Per esempio Si consideri una dichiarazione di variabile in C # / Javascript che contiene il valore di stringa 'ciao mondo!'. Ora, ogni volta che questa stringa è richiesta, qualcuno può semplicemente usare il nome della variabile per ottenere il valore sostituito come stringa effettiva.

var z='hello world!'

Proviamo ad approfondire le variabili in Postman.

Le variabili qui vengono in genere utilizzate in un contesto in cui è necessario sostituire i valori nei corpi della richiesta, fare asserzioni per il corpo della risposta e utilizzarle negli script di pre-richiesta per gestire la logica di pre-elaborazione come richiesto.

In primo luogo, proviamo a comprendere i diversi ambiti delle variabili in Postman. L'ambito non è altro che la durata e l'accessibilità di una variabile. È simile al concetto di ambito che abbiamo nei linguaggi di programmazione come Java.

Per esempio , una variabile può avere un ambito globale, ovvero qualsiasi classe / metodo può accedere / modificare la variabile fino a quando il metodo o il programma non è attivo.

Allo stesso modo, possono esserci vari tipi che hanno uno scopo specifico poiché le variabili locali dichiarate nel metodo possono essere utilizzate solo fino al momento in cui quella funzione è in esecuzione. Allo stesso modo, le variabili dichiarate nei cicli for possono essere utilizzate solo mentre quel ciclo è in esecuzione.

Ecco un video tutorial:

Postman offre 5 diversi tipi di ambiti variabili come indicato di seguito:

miglior software desktop remoto per Windows
  1. Globale
  2. Collezione
  3. Ambiente
  4. Dati
  5. Locale

Nota: È importante capire che tutti i diversi tipi di variabili di Postman possono essere aggiunti / rimossi utilizzando la console di Postman e la maggior parte di essi è accessibile e aggiornata anche tramite script.

Proviamo a comprendere in dettaglio ciascuno di questi tipi di variabili e ambito !!

Tipi di variabili in Postman

# 1) Globale

Cosa sono le variabili globali e quando dovrebbero essere utilizzate?

Le variabili globali sono variabili di uso generale e dovrebbero essere per lo più evitate e utilizzate solo per requisiti di prototipazione rapida. Queste variabili sono disponibili per tutte le richieste disponibili nella console di Postman, indipendentemente dalla raccolta a cui appartengono.

Queste variabili sono analoghe alle variabili di ambito globale nei linguaggi di programmazione come Java, C # e così via, dove le variabili globali sono accessibili a tutte le parti del programma. Tuttavia, queste variabili sono altamente inaffidabili poiché ogni sezione di codice può accedere / modificare il valore della variabile globale.

Lavorare con variabili globali

Per lavorare con le variabili globali, è possibile controllarle tramite la console di Postman e gli script nelle richieste di Postman.

Attraverso la console di Postman, fare clic sull'icona 'Occhio' vicino al selettore di ambiente, e si aprirà una finestra popup / contesto con i dettagli attorno alle variabili globali correnti.

Console Vars globale

Ora crea una nuova variabile inserendo il nome della variabile e il suo valore iniziale.

Il valore iniziale è qualcosa che viene mantenuto per impostazione predefinita per quella variabile e il valore corrente continua a cambiare mentre viene impostato o aggiornato nelle richieste che utilizzano queste variabili.

Imposta variabili globali tramite script

Utilizzando lo script, è possibile accedere alle variabili di ambiente utilizzando 'pm. globali '

Utilizza il comando seguente per ottenere il valore di una variabile globale denominata 'testVar'.

pm.globals.get('testVar');

Utilizza il comando seguente per impostare il valore di una variabile globale denominata 'testVar'.

pm.globals.set('testVar', 'Hello Postman tutorial!');

Se desideri rimuovere una variabile globale tramite script, puoi utilizzare la funzione unset come indicato di seguito.

pm.globals.unset('testVar');

Per cancellare tutte le variabili globali tramite lo script, è possibile utilizzare la funzione seguente.

pm.globals.clear();

# 2) Collezione

Cosa sono le variabili di raccolta e quando dovrebbero essere utilizzate?

Le variabili di raccolta vengono utilizzate per definire le variabili nell'ambito della raccolta. Come sappiamo, una raccolta in Postman non è altro che un gruppo di richieste di Postman.

Le variabili di raccolta non cambiano durante l'esecuzione di una raccolta o di una richiesta all'interno della raccolta data. In sostanza, le variabili di raccolta potrebbero essere semplicemente recuperate e non aggiornate durante l'esecuzione della richiesta.

Si noti che è possibile accedere alle variabili della raccolta solo dalle richieste che fanno parte della raccolta e non da altre richieste.

Come vengono creati?

Le variabili di raccolta possono essere create e / o rimosse solo utilizzando la console dell'applicazione Postman.

# 1) Seleziona la raccolta in cui desideri aggiungere una variabile. Fare clic con il tasto destro e selezionare Modifica.

Menu Modifica raccolta

#Due) Ora seleziona il file 'Variabili' scheda e aggiungere le variabili di raccolta che devono essere aggiunte.

Aggiungi variabili di raccolta

Lavorare con le variabili di raccolta

Per l'utilizzo all'interno di una richiesta, è possibile fare riferimento alle variabili di raccolta utilizzando lo script Postman generico e, a seconda della regola dell'ambito più vicino, se non sono presenti altre variabili più vicine dell'ambito di raccolta, viene restituita la variabile di raccolta.

pm.variables.get('testCollectionVar');

Per utilizzare le variabili Postman come parte del generatore di richieste, è sufficiente utilizzare la sintassi delle doppie parentesi graffe come mostrato di seguito.

Generatore di richieste di variabili di raccolta

# 3) Ambiente

Quali sono le variabili d'ambiente?

Le variabili di ambiente sono il tipo di variabili più utilizzato in Postman.

Sono legati a un ambiente selezionato che viene utilizzato per eseguire la richiesta. Hanno un ambito più ristretto rispetto alle variabili globali ma più ampio rispetto alle variabili Collection.

Quando utilizzare le variabili d'ambiente?

  1. Le variabili d'ambiente sono ideali quando si lavora con diversi server. Per esempio , in genere, mentre lavori su un progetto lavori con molti ambienti diversi come dev, test, stage e prod, ecc. che differiscono principalmente solo per URL e il resto delle cose nell'URL di richiesta dell'endpoint API rimane lo stesso.
    In questo tipo di scenario, è possibile creare un file di ambiente corrispondente ai diversi ambienti supportati dall'applicazione. Per esempio, variabili di ambiente per diversi ambienti come dev, test, ecc.
  2. Quando è necessario trasferire dati o informazioni da una richiesta a un'altra, le variabili di ambiente sono una buona scelta, poiché hanno un ambito più ampio rispetto alle variabili locali e un ambito più ristretto rispetto alle variabili globali.

Come vengono creati?

A differenza delle variabili Collection, le variabili di ambiente possono essere create sia tramite la console che tramite lo script stesso.

Per creare variabili di ambiente tramite la console, è necessario creare un ambiente attivo che non sia altro che un contenitore di variabili di ambiente. Fare riferimento alle schermate seguenti per creare un nuovo ambiente e aggiungervi variabili di ambiente.

Visualizza variabili d

Ora puoi fare clic 'Inserisci' per salvare il nuovo ambiente. Una volta salvato, puoi semplicemente fare clic su 'Impostazioni' icona per gestire / aggiungere nuovi ambienti.

Gestisci gli ambienti

Per utilizzare l'ambiente creato, sarà necessario scegliere l'ambiente da utilizzare, selezionando l'ambiente corretto dal menu a discesa dell'elenco degli ambienti.

strumenti di test di automazione per applicazioni web

Selettore dell

Lavorare con le variabili d'ambiente

Analogamente alle variabili Collection e globali, le variabili di ambiente possono essere gestite in modo programmatico tramite lo script e possono essere utilizzate direttamente come parte degli URL o del corpo della richiesta tramite la sintassi delle doppie parentesi graffe.

Quando viene selezionato un ambiente appropriato nel selettore dell'ambiente, è possibile utilizzare semplicemente la sintassi delle doppie parentesi graffe per accedere a una variabile di ambiente come illustrato nello screenshot sottostante.

Seleziona Variabile d

Per utilizzare le variabili d'ambiente attraverso lo script, puoi usare pm.environment.get e pm.environment.set per recuperare e aggiungere / modificare le variabili d'ambiente rispettivamente.

pm.environment.get('testEnvVar') pm.environment.set('testEnvVar',10)

Tieni presente che qui stiamo utilizzando pm.environment e non pm.variables, ovvero l'ambito è sempre impostato sull'ambiente e Postman proverà a trovare la variabile solo nell'ambiente selezionato.

# 4) Locale

Cosa sono le variabili locali?

Le variabili locali sono disponibili solo nel contesto di una particolare esecuzione della richiesta. Ciò è in analogia alle variabili a livello di funzione nei moderni linguaggi di programmazione come Java e C #. Queste sono esattamente simili alle variabili di funzione in cui le variabili hanno accesso solo nel contesto dell'esecuzione della funzione.

Un caso d'uso importante delle variabili locali è che possono essere utilizzate quando si desidera sovrascrivere i valori di una variabile definita in qualsiasi altro ambito come Globale, Raccolta o Ambiente.

Ad esempio, supponiamo che ci sia una variabile globale denominata 'testVar' e ora che desideri sovrascrivere il valore senza influire sulla variabile globale, puoi creare una variabile locale con lo stesso nome e usarla con il valore che ti piace.

Quando utilizzare le variabili locali?

Le variabili locali possono essere utilizzate allo stesso modo delle variabili Collection, Global e Environment che abbiamo discusso nelle sezioni precedenti di questo tutorial.

È importante notare qui che, per utilizzare le variabili locali a livello di codice, è necessario utilizzare pm.variables.get / pm.variables.set diversamente da pm.environment o pm.global che è stato utilizzato per le variabili Environment e Global.

cos'è il repository di oggetti in qtp
pm.variables.get('testVar') pm.variables.set('testEnvVar',10)

# 5) Dati

Cosa sono le variabili di dati?

Le variabili di dati vengono nel contesto dell'esecuzione della richiesta tramite il runner di raccolta.

Postman ci consente di eseguire le richieste in una raccolta tramite il runner della raccolta e durante l'esecuzione possiamo fornire un set di dati sotto forma di JSON o CSV che vengono utilizzati durante l'esecuzione delle richieste all'interno della raccolta.

È importante notare qui che l'origine delle variabili di dati è il file di dati fornito dall'utente in formato JSON o CSV e durante l'esecuzione della richiesta, le variabili di dati possono essere solo recuperate ma non aggiornate / modificate o aggiunte.

Quando utilizzare le variabili di dati?

Le variabili di dati vengono utilizzate mentre lavoriamo con più set di dati ed esistono solo durante l'esecuzione di un'iterazione dal file di dati.

Come utilizzare una variabile di dati?

Vediamo uno scenario end-to-end di esecuzione delle richieste tramite collection runner e fornitura di un file di dati il ​​cui valore viene sostituito mentre la richiesta viene eseguita.

Aggiungiamo una semplice richiesta GET a una nuova raccolta per illustrare il concetto di variabili di dati. Useremo lo stesso endpoint GET https://reqres.in/api/users/{userId}

Recupereremo {userId} tramite una variabile Data che sarà supportata da un file CSV contenente i valori per userId.

Si prega di seguire i passaggi seguenti per comprendere il flusso.

# 1) Modifica l'URL della richiesta nel generatore di richieste di Postman in https://reqres.in/api/users/{{testDataVar}}.

Variabili di dati

#Due) Qui, {{testDataVar}} è la nostra variabile di dati il ​​cui valore verrà recuperato dall'origine dati che verrà utilizzata con il runner della raccolta.

# 3) Crea un nuovo file di dati in formato CSV con il nome della colonna 'testDataVar'.

Imposta i dati nel file CSV come di seguito:

testDataVar 1 2 3 4 5

# 4) Salvare il file nel file system locale e utilizzare questo file durante l'esecuzione della raccolta tramite il runner della raccolta.

# 5) Ora seleziona la raccolta e fai clic su Esegui per eseguire le richieste di raccolta tramite il corridore della raccolta.

Collezione Runner

# 6) Seleziona il file di dati csv creato nella configurazione del runner della raccolta e il tipo di file come testo / csv.

Selezione delle opzioni variabili

# 7) Ora premi 'Esegui raccolta Postino' e fai riferimento alla finestra 'Esegui risultati'. C'è un dettaglio di esecuzione per la richiesta configurata per ogni iterazione che è stata eseguita. Il numero di iterazioni dipende dal numero di input di dati che sono stati configurati nel file CSV.

Risultati del corridore della raccolta

È possibile visualizzare ulteriori dettagli sugli URL di richiesta e così via nei risultati del runner della raccolta per verificare se i valori delle variabili di dati sono stati passati correttamente agli URL di richiesta. In genere, le variabili di dati vengono utilizzate quando le richieste di raccolta devono essere eseguite su più set di dati secondo i valori configurati nei file di dati.

Accesso alle variabili di Postman

È possibile accedere alle variabili Postman in 2 modi come indicato di seguito.

  1. Nella richiesta, è possibile accedere alle variabili del builder utilizzando un formato di parentesi graffa doppia. Si noti che durante la risoluzione della variabile, il valore della variabile di ambito più vicino verrà sostituito prima che la richiesta venga eseguita.
  2. Nello script, come lo script di pre-richiesta, i test, le asserzioni, ecc., È possibile accedere / modificare le variabili utilizzando la sintassi seguente.

Per recuperare una variabile:

pm.variables.get( ‘variable-name’ )

Per impostare un valore variabile.

pm.variables.set( ‘variable-name’ , ’variable-value’ )

È importante notare qui che quando una variabile è impostata, cercherà di trovare la variabile di ambito più vicina e di impostare o modificare quella variabile. Nel caso in cui non sia stata trovata alcuna variabile durante il set, lo script Postman creerà semplicemente una nuova variabile locale.

Note e suggerimenti

# 1) Si consiglia di avere nomi di variabili diversi in ambiti diversi, per evitare confusione poiché il sandbox di Postman sceglierà la variabile con l'ambito più vicino quando tenta di risolvere le variabili nel generatore di richieste con il formato doppia parentesi graffa o quando pm.variables.get / Lo script pm.variables.set è stato risolto.

#Due) Per le variabili di ambiente, è efficace solo l'ambiente selezionato, ovvero durante la risoluzione delle variabili, Postman esaminerà solo l'ambiente selezionato.

# 3) Si prega di notare una regola pratica generale: una variabile con l'ambito più vicino ha la precedenza sulle altre. Per esempio, se è presente una variabile globale denominata 'input1' e una variabile locale con lo stesso nome e se si fa riferimento alla variabile nell'ambito di una variabile locale, la variabile nell'ambito locale ha più precedenza rispetto alla variabile globale.

Conclusione

In questo tutorial, abbiamo toccato molti concetti relativi alle variabili in Postman insieme ai diversi modi per usarli. Abbiamo discusso i tipi di variabili come Globale, Raccolta, Ambiente, Locale e Dati e quando utilizzarle.

In poche parole, le variabili Postman aggiungono molta potenza al modo in cui lo strumento può essere utilizzato e configurato per eseguire richieste e test in modo efficace. È stato possibile ottenere pochi riferimenti dalla documentazione ufficiale del postino Qui.

=> Visita qui per vedere i tutorial di formazione dalla A alla Z dei postini qui.

Lettura consigliata

^