Aangepaste waardelijsten

Een aangepaste waardelijst koppelt leesbare labels aan technische waarden. U kiest Rood in een keuzelijst, en het verzoek vertrekt met FF0000.

Dat is het equivalent van een enumeratie, maar dan een die u zelf definieert, zonder afhankelijk te zijn van een geïmporteerde specificatie.

Waar u ze maakt

Open de omgevingsmap en daarna haar tabblad Aangepaste variabelen. Elke lijst heeft een naam en een reeks items:

Label	Waarde	Ingeschakeld
Rood	FF0000	✔
Groen	00FF00	✔
Blauw	0000FF	✔
Oude interne code	X-42	✘

Ze gebruiken

Overal waar een getypeerde waarde wordt geaccepteerd — omgevingsvariabele, queryparameter, configuratieveld van een scenario-actie — kiest u het type Aangepaste lijst en daarna de gewenste lijst. Het veld wordt een keuzelijst met labels.

Er zijn twee varianten:

• Aangepaste lijst: één keuze;
• Meervoudige aangepaste lijst: meerdere labels, waarvan de waarden aan elkaar worden geplakt.

Uitgeschakelde items

Als u een item uitvinkt, verdwijnt het uit de keuzelijst en is het niet meer op te lossen: een verzoek dat er nog naar verwees, vertrekt met het ruwe label in plaats van de waarde. Dat is bedoeld gedrag — het maakt een verwijzing die niet meer geldt zichtbaar in plaats van hem stil te laten mislukken.

Wanneer kiest u liever een gewone variabele?

Behoefte	Kies
Een waarde die per omgeving verschilt (baseUrl)	Een omgevingsvariabele
Een keuze uit een eindige verzameling, gelijk in alle omgevingen	Een aangepaste lijst
Een verzameling waarden die de geïmporteerde specificatie oplegt	Een enumeratie (bij de import aangemaakt)

Op de opdrachtregel

Een scenarioparameter van het type “aangepaste lijst” geeft u op label mee op de opdrachtregel, en Restorm zet die om naar de waarde:

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

Zie Headless uitvoering & CI.