自定义值列表

一个自定义值列表把可读的标签关联到技术值上。您在下拉菜单里选择 Rouge，请求发出时用的就是 FF0000。

它相当于一个枚举，但由您自己定义，不依赖任何导入的规范。

在哪里创建

打开环境文件夹， 然后切换到它的自定义变量标签页。每个列表都有一个名称和一系列条目：

标签	值	已启用
Rouge	FF0000	✔
Vert	00FF00	✔
Bleu	0000FF	✔
Ancien code interne	X-42	✘

使用它们

任何接受带类型的值的地方 —— 环境变量、请求参数、场景动作的配置字段 —— 都可以选择自定义列表类型，然后选中想用的那个列表。该字段随即变成一个标签下拉菜单。

有两个变体：

• 自定义列表：只能选一项；
• 多选自定义列表：可选多个标签，它们的值会被拼接在一起。

已停用的条目

取消勾选某个条目会把它从下拉菜单中移除，并且让它无法被解析： 仍然引用它的请求发出时会带上原始标签而不是它的值。这是刻意设计的行为 —— 这样能让一个已失效的引用显现出来，而不是让它悄无声息地失败。

什么时候该用普通变量？

需求	请选择
一个随环境变化的值（baseUrl）	一个环境变量
从一个有限集合中做选择，且在所有环境中都相同	一个自定义列表
由导入的规范强制规定的一组值	一个枚举（导入时创建）

在命令行中

类型为“自定义列表”的场景参数在命令行上是按标签传入的， Restorm 会把它转换成对应的值：

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

参阅 headless 执行与 CI。