Żądania, foldery i foldery zmiennych
Drzewo projektu Restorm składa się z czterech rodzin elementów.
Zwykły folder
Section titled “Zwykły folder”Kontener służący do porządkowania, bez wpływu na wykonanie. Przydaje się do
grupowania według obszaru funkcjonalnego (Rozliczenia, Użytkownicy…).
Folder zmiennych
Section titled “Folder zmiennych”To element centralny. Folder zmiennych (albo folder środowisk) przechowuje:
- swoje środowiska (
local,staging,production…), każde z własnymi zmiennymi, a w razie potrzeby także podśrodowiska; - swoje własne listy wartości;
- wyliczenia pochodzące z importu;
- dokumentację API wygenerowaną przy imporcie (modele, opisy, schematy zabezpieczeń);
- trasy uwierzytelniania udostępniane jego żądaniom.
Każde żądanie umieszczone w tym folderze dziedziczy wybrane środowisko. To
właśnie dzięki temu wystarczy raz zapisać {{baseUrl}}/users i przełączać się
między środowiskami ze smartbara.
Import zawsze tworzy folder zmiennych: jest on jednostką „ponownej synchronizacji” przy przeładowaniu źródłowej specyfikacji.
Żądanie
Section titled “Żądanie”Żądanie ma typ (protokół), nazwę, ikonę, notatki, tagi oraz konfigurację właściwą dla swojego protokołu. Może mieć również:
- trasę uwierzytelniania (Uwierzytelnianie);
- zapisane szybkie ustawienia.
Nowe żądanie tworzy się przez kliknięcie prawym przyciskiem ▸ Dodaj ▸, a następnie wybór protokołu. Pełną listę zawiera katalog protokołów.
To samo menu Dodaj udostępnia osiem serwerów, które są pełnoprawnymi elementami drzewa: zob. Tryb serwera.
Scenariusz
Section titled “Scenariusz”Graf akcji, który orkiestruje żądania i logikę. Zob. Scenariusze.
Przydatne gesty
Section titled “Przydatne gesty”| Gest | Efekt |
|---|---|
F2 | Zmiana nazwy wybranego elementu |
Ctrl+D | Klonowanie elementu (wraz z poddrzewem) |
Delete | Usunięcie |
| Przeciąganie i upuszczanie | Przenoszenie w drzewie, zmiana kolejności ulubionych |
| Kliknięcie środkowym przyciskiem na ścieżce nawigacyjnej | Otwarcie elementu nadrzędnego w zakładce w tle |
Żądania przestarzałe
Section titled “Żądania przestarzałe”Żądanie może zostać oznaczone jako przestarzałe — robi tak zwłaszcza ponowna synchronizacja importu, gdy operacja znika ze źródłowej specyfikacji. Takie żądanie pozostaje w drzewie, z paskiem ostrzeżenia u góry swojej zakładki, zamiast zniknąć bez uprzedzenia.