Anfragen, Ordner und Umgebungsordner
Der Baum eines Restorm-Projekts kennt vier Arten von Elementen.
Der einfache Ordner
Section titled “Der einfache Ordner”Ein Container zur Ablage, ohne Auswirkung auf die Ausführung. Nutzen Sie ihn,
um nach fachlichem Bereich zu gruppieren (Abrechnung, Benutzer …).
Der Umgebungsordner
Section titled “Der Umgebungsordner”Das ist das zentrale Element. Ein Umgebungsordner (oder Variablenordner) enthält:
- seine Umgebungen (
local,staging,production…), jede mit ihren eigenen Variablen und optional Unterumgebungen; - seine benutzerdefinierten Wertelisten;
- die aus einem Import stammenden Aufzählungen;
- die beim Import generierte API-Dokumentation (Modelle, Beschreibungen, Sicherheitsschemata);
- die seinen Anfragen angebotenen Authentifizierungsrouten.
Jede unter diesem Ordner abgelegte Anfrage erbt die ausgewählte Umgebung.
So können Sie {{baseUrl}}/users genau einmal schreiben und über die
smartbar zwischen Umgebungen wechseln.
Ein Import erstellt immer einen Umgebungsordner: Er ist die Einheit für die „Neusynchronisierung“, wenn Sie die Quellspezifikation neu laden.
Die Anfrage
Section titled “Die Anfrage”Eine Anfrage trägt einen Typ (das Protokoll), einen Namen, ein Symbol, Notizen, Tags und die für ihr Protokoll spezifische Konfiguration. Zusätzlich kann sie tragen:
- eine Authentifizierungsroute (Authentifizierung);
- gespeicherte Schnelleinstellungen.
Legen Sie eine neue Anfrage per Rechtsklick ▸ Hinzufügen ▸ und dem gewünschten Protokoll an. Die vollständige Liste finden Sie im Protokollkatalog.
Dasselbe Menü Hinzufügen bietet die acht Server an, die eigenständige Elemente sind: siehe Servermodus.
Das Szenario
Section titled “Das Szenario”Ein Aktionsgraph, der Anfragen und Logik orchestriert. Siehe Szenarien.
Nützliche Gesten
Section titled “Nützliche Gesten”| Geste | Wirkung |
|---|---|
F2 | Ausgewähltes Element umbenennen |
Ctrl+D | Element klonen (mit seinem Unterbaum) |
Delete | Löschen |
| Ziehen und Ablegen | Im Baum verschieben, Favoriten neu anordnen |
| Mittelklick auf einen Breadcrumb | Vorfahren in einem Hintergrund-Tab öffnen |
Veraltete Anfragen
Section titled “Veraltete Anfragen”Eine Anfrage kann als veraltet markiert werden — das geschieht insbesondere bei der Neusynchronisierung eines Imports, wenn eine Operation aus der Quellspezifikation verschwindet. Sie bleibt im Baum erhalten, mit einem Warnbanner am Kopf ihres Tabs, statt Ihnen unter den Füßen gelöscht zu werden.