Variablen und Umgebungen
Die Variablen von Restorm leben in einem Variablenordner, der mehrere Sätze davon enthalten kann: einen pro Umgebung.
Umgebungen und Unterumgebungen
Section titled “Umgebungen und Unterumgebungen”Eine Umgebung ist eine Liste von Schlüssel-Wert-Paaren. Sie kann Unterumgebungen enthalten, die von ihrer übergeordneten Umgebung erben und überschreiben, was sie neu definieren.
Das ist das richtige Werkzeug, um staging → staging / customer A,
staging / customer B abzubilden: Die gemeinsame Basis wird einmal
geschrieben, nur der Unterschied wird wiederholt.
Die aktive Umgebung auswählen
Section titled “Die aktive Umgebung auswählen”Der Umgebungsauswähler befindet sich links von der Smartbar jedes Anfrage-Tabs. Er zeigt einen farbigen Punkt und den Namen der Umgebung an.
Das Popover bietet ein Kontrollkästchen „Auf alle Anfragen anwenden“:
Ist es aktiviert, wechselt es den gesamten Ordner auf einmal um – genau das
wollen Sie, um ein ganzes Projekt von local auf staging umzustellen.
Werttypen
Section titled “Werttypen”Eine Variable ist mehr als nur eine Zeichenkette. Restorm bietet typischerweise:
| Typ | Was es ist |
|---|---|
| Zeichenkette | Ein literaler Wert, der unverändert gesendet wird |
| Ausdruck | Eine Handlebars-Vorlage – der einzige Typ, dessen {{ }} ausgewertet werden |
| Numerisch | Eine Zahl mit einem Anzeigeformat |
| Boolesch | Wahr / Falsch |
| Datum-Uhrzeit | Ein ISO-Datum mit einem Format |
| Farbe | Eine hexadezimale Farbe |
| Secret | Ein Verweis auf eine Secret-Quelle – der Wert gelangt niemals in die Projektdatei |
| Liste | Eine Liste von Werten |
| Enumeration / Mehrfach-Enumeration | Ein Wert, der durch eine importierte Enumeration eingeschränkt wird |
| Benutzerdefinierte Liste / Benutzerdefinierte Mehrfachliste | Eine Auswahl nach Bezeichnung aus einer benutzerdefinierten Werteliste |
| Variable | Ein Verweis auf eine andere Variable |
| Umgebung | Ein Verweis auf eine Umgebung |
| Null | Der explizite Nullwert |
Auflösungsreihenfolge
Section titled “Auflösungsreihenfolge”Vom Allgemeinsten zum Spezifischsten – der letzte gewinnt:
- die Wurzelumgebung, dann jede Unterumgebung der Kette;
- die Variablen der Umgebung selbst, in ihrer Deklarationsreihenfolge: Eine Variable kann sich also auf die über ihr definierten stützen;
- die von einem Szenario gesetzten Laufzeitvariablen (Aktion Variable setzen), die die Umgebung für die Dauer der Ausführung überdecken;
- die anfragespezifischen Werte (Header, Query-Parameter, Pfadparameter), wobei jede Gruppe im Kontext der bereits aufgelösten Werte aufgelöst wird;
- schließlich die direkt in den Feldern der Anfrage geschriebenen
{{ }}– siehe Inline-Variablen.
Restorm führt außerdem mehrere Durchläufe aus: Ein Ausdruck einer übergeordneten Umgebung kann also einen von einer untergeordneten Umgebung neu definierten Wert abrufen.
Deaktivierte Variablen
Section titled “Deaktivierte Variablen”Jede Variable besitzt ein Aktivierungskästchen. Eine deaktivierte Variable fließt nicht in den Kontext ein – das ist der saubere Weg, eine Überschreibung vorübergehend zu neutralisieren, ohne sie zu löschen.
Beim Import werden Schlüssel-Wert-Paare, deren Wert sich zu leer auflöst, automatisch deaktiviert: Ihre erste Ausführung sendet also keine Schwemme leerer Header.
Und die Helper?
Section titled “Und die Helper?”Jeder Ausdruck ist eine Handlebars-Vorlage mit über hundert verfügbaren Helpern: Zeichenketten, Mathematik, Datumsangaben, Listen, Kodierung, Hashing, Zufallsdaten.