Listas de valores personalizadas

Uma lista de valores personalizada associa rótulos legíveis a valores técnicos. Escolhe Vermelho numa lista pendente e o pedido parte com FF0000.

É o equivalente de uma enumeração, mas definida por si, sem depender de uma especificação importada.

Onde criá-las

Abra a pasta de variáveis e depois o seu separador Variáveis personalizadas. Cada lista tem um nome e uma série de entradas:

Rótulo	Valor	Ativada
Vermelho	FF0000	✔
Verde	00FF00	✔
Azul	0000FF	✔
Antigo código interno	X-42	✘

Utilizá-las

Em qualquer sítio onde seja aceite um valor tipado — variável de ambiente, parâmetro de consulta, campo de configuração de uma ação de cenário — escolha o tipo Lista personalizada e depois a lista pretendida. O campo passa a ser uma lista pendente de rótulos.

Duas variantes:

• Lista personalizada: uma única escolha;
• Lista personalizada múltipla: vários rótulos, cujos valores são concatenados.

Entradas desativadas

Desmarcar uma entrada retira-a da lista pendente e torna-a não resolúvel: um pedido que ainda a referenciasse partiria com o rótulo em bruto em vez do seu valor. É o comportamento pretendido — torna visível uma referência que caducou, em vez de a fazer falhar silenciosamente.

Quando preferir uma variável clássica?

Necessidade	Escolha
Um valor que muda conforme o ambiente (baseUrl)	Uma variável de ambiente
Uma escolha dentro de um conjunto finito, idêntico em todos os ambientes	Uma lista personalizada
Um conjunto de valores imposto pela especificação importada	Uma enumeração (criada na importação)

Na linha de comandos

Um parâmetro de cenário do tipo “lista personalizada” passa-se por rótulo na linha de comandos, e o Restorm converte-o no valor correspondente:

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

Consulte Execução headless e CI.