Menu

Pochopenie variabilných rozsahov a súborov prostredia v službe Postman

  • Hlavná
  • Iné
  • Pochopenie variabilných rozsahov a súborov prostredia v službe Postman

understanding variable scopes

Vyskúšajte Náš Nástroj Na Odstránenie Problémov

Tento výukový program sa bude zaoberať rôznymi typmi premenných podporovaných nástrojom Poštár a ako je možné ich použiť pri vytváraní a vykonávaní požiadaviek a zbierok poštárov:

Dotkneme sa tiež koncepcie súborov prostredia a uvidíme, ako ich možno využiť pri vytváraní a vykonávaní zbierok.

=> Vyskúšajte tu príručku The Perfect Postman Training Guide.

Variabilné rozsahy a súbory prostredia

Čo sa dozviete:

Čo sú premenné v poštárovi?

Premenné, ako každý iný programovací jazyk, nie sú ničím iným ako zástupnými symbolmi, ktoré udržujú určitú hodnotu alebo výsledok niektorých výrazov.

Napríklad , Zvážte deklaráciu premennej v C # / Javascript, ktorá obsahuje hodnotu reťazca „ahoj svet!“. Teraz, kedykoľvek je tento reťazec požadovaný, niekto môže jednoducho použiť názov premennej, aby bola hodnota nahradená skutočným reťazcom.

var z='hello world!'

Skúsme sa podrobnejšie zaoberať premennými v Postmani.

Premenné sa tu zvyčajne používajú v kontexte, keď potrebujete nahradiť hodnoty v telách žiadosti, urobiť tvrdenia pre telo odpovede a použiť ich v skriptoch pred požiadavkou na spracovanie logiky predbežného spracovania podľa potreby.

Najprv sa pokúsime porozumieť rôznym rozsahom premenných v službe Postman. Rozsah nie je nič iné ako životnosť a dostupnosť premennej. Je to podobné ako koncept rozsahu, ktorý máme v programovacích jazykoch, ako je Java.

Napríklad , premenná môže mať globálny rozsah, t. j. ktorákoľvek trieda / metóda môže pristupovať / upravovať premennú, kým nie je metóda alebo program aktívny.

Podobne môžu existovať rôzne typy, ktoré majú konkrétny rozsah, pretože lokálne premenné deklarované v metóde je možné používať iba do času vykonania tejto funkcie. Rovnako aj premenné deklarované v cykloch smyčky je možné použiť iba počas vykonávania tejto slučky.

Tu je videonávod:

Poštár ponúka 5 rôznych typov variabilných rozsahov, ako je uvedené nižšie:

spoločnosti, kde pracujú s videohrami
  1. Globálne
  2. Zbierka
  3. Životné prostredie
  4. Údaje
  5. Miestne

Poznámka: Je dôležité si uvedomiť, že všetky rôzne typy premenných Postmana je možné pridávať / odstraňovať pomocou konzoly Postman a väčšina z nich je prístupná a aktualizovaná aj pomocou skriptov.

Pokúsme sa podrobne porozumieť každému z týchto typov premenných a rozsahu !!

Variabilné typy v poštárovi

# 1) Globálne

Čo sú globálne premenné a kedy by sa mali použiť?

Globálne premenné sú univerzálne premenné, ktorým by ste sa mali vyhnúť a mali by sa používať len na účely rýchlych prototypov. Tieto premenné sú k dispozícii pre všetky požiadavky dostupné v konzole Postman, bez ohľadu na to, do akej zbierky patria.

Tieto premenné sú analogické s premennými globálneho rozsahu v programovacích jazykoch ako Java, C # atď., Kde sú globálne premenné prístupné pre všetky časti programu. Tieto premenné sú však veľmi nespoľahlivé, pretože každá časť kódu môže pristupovať / meniť hodnotu globálnej premennej.

Práca s globálnymi premennými

Na prácu s globálnymi premennými je možné ich ovládať prostredníctvom konzoly Postman, ako aj skriptov v požiadavkách Postmana.

Prostredníctvom konzoly Postman kliknite na ikonu „Oko“ v blízkosti selektora prostredia. Otvorí sa kontextové alebo kontextové okno s podrobnosťami o aktuálnych globálnych premenných.

Globálna konzola Vars

Teraz vytvorte novú premennú zadaním názvu premennej a jej počiatočnej hodnoty.

Počiatočná hodnota je niečo, čo sa pre túto premennú predvolene zachováva, a aktuálna hodnota sa neustále mení, keď je nastavená alebo aktualizovaná v požiadavkách, ktoré používajú tieto premenné.

Nastaviť globálne zmeny pomocou skriptu

Pomocou skriptu je možné k premenným prostredia pristupovať pomocou „pm. globáli “

Pomocou nižšie uvedeného príkazu získate hodnotu globálnej premennej s názvom „testVar“.

pm.globals.get('testVar');

Pomocou nižšie uvedeného príkazu nastavte hodnotu globálnej premennej s názvom „testVar“.

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

Ak chcete odstrániť globálnu premennú pomocou skriptu, môžete použiť funkciu deaktivácie uvedenú nižšie.

pm.globals.unset('testVar');

Na vymazanie všetkých globálnych premenných pomocou skriptu môžete použiť nasledujúcu funkciu.

pm.globals.clear();

# 2) Zbierka

Čo sú to premenné kolekcie a kedy by sa mali použiť?

Premenné kolekcie sa používajú na definovanie premenných v rozsahu kolekcie. Ako vieme, zbierka v Poštárovi nie je nič iné ako skupina žiadostí Poštárov.

Premenné kolekcie sa počas vykonávania kolekcie alebo požiadavky vnútri danej kolekcie nemenia. Premenné v zásade je možné iba načítať a nie aktualizovať počas vykonávania požiadavky.

Upozorňujeme, že k premenným kolekcie je možné pristupovať iba z požiadaviek, ktoré sú súčasťou kolekcie, a nemôžu to byť žiadne ďalšie požiadavky.

Ako sa vytvárajú?

Premenné kolekcie je možné vytvárať a / alebo odstraňovať iba pomocou konzoly aplikácie Postman.

# 1) Vyberte kolekciu, do ktorej chcete pridať premennú. Kliknite pravým tlačidlom myši a vyberte možnosť Upraviť.

Ponuka Upraviť zbierku

#dva) Teraz vyberte ikonu „Premenné“ kartu a pridajte premenné kolekcie, ktoré sa majú pridať.

Pridajte premenné kolekcie

Práca s premennými kolekcie

Na použitie vo vnútri požiadavky je možné premenné kolekcie odkázať pomocou generického Postmanovho skriptu a v závislosti od pravidla najbližšieho rozsahu, ak neexistuje iná iná premenná, ktorá je bližšie ako rozsah kolekcie, vráti sa premenná kolekcie.

pm.variables.get('testCollectionVar');

Ak chcete použiť premenné Postmana ako súčasť nástroja na tvorbu požiadaviek, jednoducho použite syntax dvojitej zloženej zátvorky, ako je uvedené nižšie.

Zostavovač žiadostí o premenné kolekcie

# 3) Životné prostredie

Čo sú to premenné prostredia?

Premenné prostredia sú najbežnejšie používaným druhom premenných v Postmani.

Sú viazané na vybrané prostredie, ktoré sa používa na vykonanie žiadosti. Majú užší rozsah ako globálne premenné, ale širšie ako premenné kolekcie.

Kedy použiť premenné prostredia?

  1. Premenné prostredia sú ideálne pri práci s rôznymi servermi. Napríklad Všeobecne platí, že pri práci na projekte pracujete s mnohými rôznymi prostrediami, ako sú dev, test, stage a prod, atď., ktoré sa líšia väčšinou iba adresou URL a zvyšok vecí v požiadavke na koncový bod API zostáva rovnaký.
    V tomto druhu scenára môžete vytvoriť súbor prostredia, ktorý zodpovedá rôznym prostrediam, ktoré vaša aplikácia podporuje. Napríklad, premenné prostredia pre rôzne prostredia ako dev, test, atď.
  2. Ak je potrebné odovzdať údaje alebo informácie z jednej žiadosti na druhú, premenné prostredia sú dobrou voľbou, pretože majú širší rozsah ako miestne premenné a užší rozsah ako globálne premenné.

Ako sa vytvárajú?

Na rozdiel od kolekčných premenných je možné premenné prostredia vytvárať prostredníctvom konzoly aj prostredníctvom samotného skriptu.

Na vytváranie premenných prostredia prostredníctvom konzoly je potrebné vytvoriť aktívne prostredie, ktoré nie je ničím iným ako kontajnerom premenných prostredia. Ak chcete vytvoriť nové prostredie a pridať doňho premenné prostredia, pozrite si snímky obrazovky nižšie.

Zobraziť premenné prostredia

Teraz môžete kliknúť „Pridať“ zachrániť nové prostredie. Po uložení môžete jednoducho kliknúť na ikonu 'Nastavenie' ikona na správu / pridanie nových prostredí.

Správa prostredí

Ak chcete použiť vytvorené prostredie, budete si musieť zvoliť prostredie, ktoré chcete použiť, a to výberom správneho prostredia z rozbaľovacej ponuky zoznamu prostredí.

Výber prostredia

Práca s premennými prostredia

Podobne ako v prípade premenných Zbierka a Globálne, na premenné prostredia sa dá programovo pôsobiť prostredníctvom skriptu a môžu sa použiť priamo ako súčasť adries URL alebo tela žiadosti prostredníctvom syntaxe dvojitých zložených zátvoriek.

Keď je v selektore prostredia vybraté vhodné prostredie, môžete jednoducho použiť syntax dvojitej zloženej zátvorky na prístup k premennej prostredia, ako je to znázornené na nasledujúcom obrázku.

Vyberte premennú prostredia

Ak chcete pomocou skriptu používať premenné prostredia, môžete použiť pm.environment.get a pm.environment.set načítať a pridávať / upravovať premenné prostredia.

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

Upozorňujeme, že tu používame pm.environment a nie pm.variables, tzn. Rozsah je vždy nastavený na prostredie a Postman sa pokúsi zistiť premennú iba vo vybranom prostredí.

# 4) Miestne

Čo sú miestne premenné?

Lokálne premenné sú k dispozícii iba v kontexte vykonania konkrétnej požiadavky. Je to analogické s premennými na úrovni funkcií v moderných programovacích jazykoch, ako sú Java a C #. Sú to presne podobné premenné funkcií, v ktorých majú premenné prístup iba v rámci vykonávania funkcie.

návod pre Microsoft Dynamics Axe pre začiatočníkov

Jedným dôležitým prípadom použitia miestnych premenných je, že sa dajú použiť, keď chcete prepísať hodnoty premennej, ktorá je definovaná v akomkoľvek inom rozsahu, ako je globálny, kolekčný alebo environmentálny.

tj. Predpokladajme, že existuje globálna premenná s názvom „testVar“. Teraz chcete prepísať hodnotu bez ovplyvnenia globálnej premennej, môžete vytvoriť lokálnu premennú s rovnakým názvom a použiť ju s požadovanou hodnotou.

Kedy použiť lokálne premenné?

Lokálne premenné sa dajú použiť rovnakým spôsobom ako premenné Collection, Global a Environment, o ktorých sme hovorili v predchádzajúcich častiach tohto tutoriálu.

Tu je dôležité poznamenať, že ak chcete programovo použiť lokálne premenné, musíte použiť pm.variables.get / pm.variables.set na rozdiel od pm.environment alebo pm.global, ktorý bol použitý pre premenné prostredia a globálne premenné.

pm.variables.get('testVar') pm.variables.set('testEnvVar',10)

# 5) Údaje

Čo sú premenné údajov?

Dátové premenné prichádzajú v kontexte vykonávania požiadavky prostredníctvom bežca kolekcie.

Poštár nám umožňuje uskutočňovať požiadavky v zbierke prostredníctvom bežca zbierky a počas vykonávania môžeme poskytnúť množinu údajov vo forme JSON alebo CSV, ktoré sa používajú pri spúšťaní požiadaviek vo vnútri zbierky.

Tu je dôležité poznamenať, že zdrojom dátových premenných je dátový súbor poskytovaný používateľom vo formáte JSON alebo CSV a počas vykonávania žiadosti je možné dátové premenné iba načítať, ale nie ich aktualizovať, upravovať alebo pridávať.

Kedy použiť premenné údajov?

Údajové premenné sa používajú, keď pracujeme s viacerými množinami údajov, a existujú iba počas vykonávania iterácie z údajového súboru.

Ako používať premennú údajov?

Pozrime sa na komplexný scenár vykonávania požiadaviek prostredníctvom bežca zhromažďovania a poskytovania dátového súboru, ktorého hodnota je počas vykonávania žiadosti nahradená.

Poďme pridať novú požiadavku GET do novej kolekcie, aby sme ilustrovali koncept dátových premenných. Použijeme rovnaký koncový bod GET https://reqres.in/api/users/{userId}

ručné testovanie pokračuje po dobu 3 rokov skúseností

Načítame {userId} prostredníctvom premennej Data, ktorá bude podporená súborom CSV obsahujúcim hodnoty pre userId.

Postupujte podľa nasledujúcich krokov, aby ste pochopili priebeh.

# 1) Zmeňte webovú adresu žiadosti v nástroji na tvorbu poštových zásielok na adresu https://reqres.in/api/users/{{testDataVar}}.

Premenné údajov

#dva) Tu, {{testDataVar}} je naša premenná údajov, ktorej hodnota sa získa zo zdroja údajov, ktorý sa použije s bežcom zhromažďovania.

# 3) Vytvorte nový dátový súbor vo formáte CSV s názvom stĺpca ako „testDataVar“.

Nastavte údaje v súbore CSV nasledovne:

testDataVar 1 2 3 4 5

# 4) Uložte súbor do lokálneho súborového systému a použite ho pri spustení kolekcie prostredníctvom bežca kolekcie.

# 5) Teraz vyberte kolekciu a kliknite na Spustiť, aby ste vykonali požiadavky na kolekciu prostredníctvom bežca kolekcie.

Kolekcia Runner

# 6) Vyberte vytvorený dátový súbor CSV v konfigurácii zberača a typ súboru ako text / CSV.

Výber premennej možnosti

# 7) Teraz stlačte „Spustiť zbierku poštárov“ a pozrite si okno „Spustiť výsledky“. Pre každú vykonanú iteráciu je nakonfigurovaný požiadavka podrobná. Počet iterácií závisí od počtu dátových vstupov, ktoré boli nakonfigurované v súbore CSV.

Výsledky bežca zbierky

Viac podrobností o adresách URL požiadaviek atď. Sa môžete pozrieť vo výsledkoch bežca kolekcie, aby ste overili, či boli hodnoty premenných údajov správne odovzdané adresám URL žiadosti. Všeobecne sa dátové premenné používajú, keď sa majú požiadavky na zber vykonať proti viacerým množinám údajov podľa nakonfigurovaných hodnôt v údajových súboroch.

Prístup k premenným poštového doručovateľa

K premenným poštového doručovateľa je možné pristupovať dvoma spôsobmi, ako je uvedené nižšie.

  1. V žiadosti je možné k premenným nástroja Builder pristupovať pomocou formátu dvojitej zloženej zátvorky. Upozorňujeme, že pri riešení premennej bude hodnota premennej najbližšieho rozsahu nahradená pred vykonaním požiadavky.
  2. V skripte, ako je skript predbežnej žiadosti, testy, tvrdenia atď., Je možné k premenným pristupovať / upravovať ich pomocou nasledujúcej syntaxe.

Načítanie premennej:

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

Nastaviť hodnotu premennej.

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

Tu je dôležité poznamenať, že keď je nastavená premenná, pokúsi sa nájsť najbližšiu premennú rozsahu a nastaviť alebo upraviť túto premennú. V prípade, že sa počas množiny nenájde žiadna premenná, Postman skript jednoducho vytvorí novú lokálnu premennú.

Poznámky a tipy

# 1) Odporúča sa mať rôzne názvy premenných v rôznych rozsahoch, aby nedochádzalo k nejasnostiam, pretože karanténa Postman zvolí premennú s najbližším rozsahom, keď sa pokúša vyriešiť premenné v nástroji na tvorbu požiadaviek s formátom dvojitej zloženej zátvorky alebo keď má pm.variables.get / Skript pm.variables.set je vyriešený.

#dva) Pre premenné prostredia je účinné iba vybrané prostredie, t. J. Pri riešení premenných sa Poštár iba pozrie do vybraného prostredia.

# 3) Dodržujte všeobecné pravidlo - premenná s najužším rozsahom má prednosť pred ostatnými. Napríklad, ak existuje globálna premenná s názvom „input1“ a existuje lokálna premenná s rovnakým názvom a ak sa na premennú odkazuje v rozsahu miestnej premennej, potom má premenná v lokálnom rozsahu v porovnaní s globálnou premennou viac prednosti.

Záver

V tomto tutoriáli sme sa dotkli mnohých konceptov týkajúcich sa premenných v Postmani spolu s rôznymi spôsobmi ich použitia. Diskutovali sme o typoch premenných ako Global, Collection, Environment, Local & Data a o tom, kedy treba každú z nich použiť.

Stručne povedané, premenné Postmana dodávajú veľa sily spôsobu, akým je možné nástroj použiť a nakonfigurovať na efektívne vykonávanie požiadaviek a testov. Z oficiálnej dokumentácie Postmana bolo možné získať niekoľko odkazov tu.

=> Navštívte tu a pozrite si tu návody na výcvik poštárov PO.

Odporúčané čítanie

^