Listes de valeurs personnalisées

Une liste de valeurs personnalisée associe des libellés lisibles à des valeurs techniques. Vous choisissez Rouge dans un menu déroulant, la requête part avec FF0000.

C’est l’équivalent d’une énumération, mais que vous définissez vous-même, sans dépendre d’une spécification importée.

Où les créer

Ouvrez le dossier de variables puis son onglet Variables personnalisées. Chaque liste porte un nom et une suite d’entrées :

Libellé	Valeur	Activée
Rouge	FF0000	✔
Vert	00FF00	✔
Bleu	0000FF	✔
Ancien code interne	X-42	✘

Les utiliser

Partout où une valeur typée est acceptée — variable d’environnement, paramètre de requête, champ de configuration d’une action de scénario — choisissez le type Liste personnalisée puis la liste voulue. Le champ devient un menu déroulant de libellés.

Deux variantes :

• Liste personnalisée : un seul choix ;
• Liste personnalisée multiple : plusieurs libellés, dont les valeurs sont jointes.

Entrées désactivées

Décocher une entrée la retire du menu déroulant et la rend non résoluble : une requête qui la référençait encore repartira avec le libellé brut au lieu de sa valeur. C’est le comportement voulu — cela rend visible une référence devenue caduque au lieu de la faire échouer silencieusement.

Quand préférer une variable classique ?

Besoin	Choisissez
Une valeur qui change selon l’environnement (baseUrl)	Une variable d’environnement
Un choix parmi un ensemble fini, identique dans tous les environnements	Une liste personnalisée
Un ensemble de valeurs imposé par la spécification importée	Une énumération (créée à l’import)

En ligne de commande

Un paramètre de scénario typé « liste personnalisée » se passe par libellé sur la ligne de commande, et Restorm le convertit en valeur :

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

Voir Exécution headless & CI.