Benutzerdefinierte Wertelisten

Eine benutzerdefinierte Werteliste verknüpft lesbare Bezeichnungen mit technischen Werten. Sie wählen Rouge in einem Dropdown-Menü, und die Anfrage geht mit FF0000 hinaus.

Das entspricht einer Aufzählung, die Sie jedoch selbst definieren, ohne auf eine importierte Spezifikation angewiesen zu sein.

Wo Sie sie anlegen

Öffnen Sie den Variablenordner und darin den Tab Benutzerdefinierte Variablen. Jede Liste trägt einen Namen und eine Reihe von Einträgen:

Bezeichnung	Wert	Aktiviert
Rouge	FF0000	✔
Vert	00FF00	✔
Bleu	0000FF	✔
Ancien code interne	X-42	✘

Sie verwenden

Überall, wo ein typisierter Wert akzeptiert wird – Umgebungsvariable, Anfrageparameter, Konfigurationsfeld einer Szenario-Aktion –, wählen Sie den Typ Benutzerdefinierte Liste und dann die gewünschte Liste. Das Feld wird zu einem Dropdown-Menü mit Bezeichnungen.

Zwei Varianten:

• Benutzerdefinierte Liste: eine einzige Auswahl;
• Benutzerdefinierte Liste (mehrfach): mehrere Bezeichnungen, deren Werte aneinandergereiht werden.

Deaktivierte Einträge

Einen Eintrag abzuwählen entfernt ihn aus dem Dropdown-Menü und macht ihn nicht mehr auflösbar: Eine Anfrage, die ihn noch referenziert, wird mit der rohen Bezeichnung statt mit ihrem Wert abgeschickt. Das ist das gewünschte Verhalten – es macht eine ungültig gewordene Referenz sichtbar, statt sie stillschweigend fehlschlagen zu lassen.

Wann eine klassische Variable vorzuziehen ist

Bedarf	Wählen Sie
Ein Wert, der je nach Umgebung wechselt (baseUrl)	Eine Umgebungsvariable
Eine Auswahl aus einer endlichen Menge, identisch in allen Umgebungen	Eine benutzerdefinierte Liste
Eine Wertemenge, die von der importierten Spezifikation vorgegeben ist	Eine Aufzählung (beim Import erstellt)

Auf der Kommandozeile

Ein Szenarioparameter vom Typ „benutzerdefinierte Liste“ wird auf der Kommandozeile über die Bezeichnung übergeben, und Restorm wandelt ihn in den Wert um:

restorm --open projet.restorm --run "Rendu" --headless --param Couleur=Rouge

Siehe Headless-Ausführung & CI.