Migrálás Postmanből
1. Exportálás a Postmanből
Section titled “1. Exportálás a Postmanből”A Postmanben: Collection ▸ … ▸ Export ▸ Collection v2.1. Ugyanígy kell eljárni a környezetekkel is.
2. Importálás a Restormba
Section titled “2. Importálás a Restormba”Fájl ▸ Importálás (Ctrl+I), majd a JSON-fájl. A Restorm magától felismeri a
formátumot.
Részletek: Postman-gyűjtemény importálása.
Ami automatikusan átjön
Section titled “Ami automatikusan átjön”| Postman | Restorm |
|---|---|
| Mappák | Mappák, ugyanolyan mélységben |
| HTTP-kérések | HTTP-kérések |
| GraphQL-kérések | GraphQL-kérések (nem HTTP-kérések) |
| raw, formdata, urlencoded, file, graphql törzs | A megfelelő törzstípus |
| Gyűjteményszintű változók | Egy környezet változói |
| Leírások | Jegyzetek és API-dokumentáció |
| Példaválaszok | API-dokumentáció |
| Pre-request és test szkriptek | Egy futtatható forgatókönyv, a pm.* réteggel |
Ami kiigazítást igényel
Section titled “Ami kiigazítást igényel”A hitelesítés
Section titled “A hitelesítés”A Postman hitelesítési blokkjai dokumentálásra kerülnek (az érzékeny értékek maszkolva), de nem alakulnak futtatható azonosítókká.
Érdemes újra létrehozni egy
hitelesítési kérést: öt perc munka, és
cserébe jár az automatikus tokenmegújítás, valamint a 401 utáni
újrapróbálkozás — amit a Postman magától nem tesz meg.
A környezetek
Section titled “A környezetek”Exportálni kell őket a Postmanből, majd újra létrehozni egy változómappában.
Érdemes egyben kihasználni az alkörnyezeteket is: ahol a Postman célpontonként egy lapos környezetet ír elő, ott a Restorm közös alapot és ügyfelenkénti vagy régiónkénti felülírásokat engedélyez.
A runnerek és a Newman
Section titled “A runnerek és a Newman”Ez a legkifizetődőbb csere. Egy forgatókönyv mindent megtesz, amit egy runner, csak jobban:
- a folyamat látható, nem a gyűjtemény implicit sorrendje;
- az elágazások, a ciklusok és az újrapróbálkozások blokkok, nem
pm.setNextRequesthívások; - a CI-ben való futtatás beépített, tiszta kilépési kódokkal — lásd: Headless futtatás és CI.
Fogalmi megfelelések
Section titled “Fogalmi megfelelések”| Postman | Restorm |
|---|---|
| Workspace | Egy .restorm projekt, gitben verziózva |
| Collection | Egy mappa vagy egy változómappa |
| Environment | Egy környezet egy változómappában |
| Globals | Egy gyökérkörnyezet, amelyet a gyermekei örökölnek |
| Pre-request / Test script | Egy forgatókönyv vagy egy kódművelet |
| Collection Runner | Egy forgatókönyv |
| Newman | restorm --run --headless |
| Mock Server | A kiszolgálómód, helyben |
| Monitors | Egy Időzítő művelet, vagy a CI egy időzített feladata |
| Postman Console | A konzol |
{{$random…}} dinamikus változók | Ugyanazok, és további 116 helper — lásd a referenciát |
A lényegi különbség
Section titled “A lényegi különbség”A kérésekből a tárház fájljai lesznek. Ugyanazon a felülvizsgálati körön mennek végig, mint a kód, az előzményük a git előzménye, a hozzáférési jogokat pedig a git-tárhelyszolgáltató adja.
Nincs üzemeltetett munkaterület, amelyet adminisztrálni kell, és nincs API-adat
egy harmadik fél szolgáltatásán. Lásd:
Projektek és .restorm fájlok.
És amit a Postman tud, a Restorm pedig nem
Section titled “És amit a Postman tud, a Restorm pedig nem”A tisztesség kedvéért: a Restormnak nincs üzemeltetett, közös munkaterülete, nincs nyilvános API-portálja, nincsenek beágyazott megjegyzések a kéréseken, és nincs üzemeltetett monitorozása. Ha egy szervezet ezekre épít, azoknak nincs közvetlen megfelelőjük — a megosztás a giten keresztül történik.