自訂值清單
自訂值清單把易讀的標籤對應到技術性的值。您在下拉選單裡選 Rouge,
請求送出去的則是 FF0000。
它相當於一個列舉,但由您自己定義,不必依賴匯入的規格。
請開啟環境資料夾,再切到 它的自訂變數分頁。每份清單都有一個名稱和一系列項目:
| 標籤 | 值 | 已啟用 |
|---|---|---|
Rouge | FF0000 | ✔ |
Vert | 00FF00 | ✔ |
Bleu | 0000FF | ✔ |
Ancien code interne | X-42 | ✘ |

任何接受具型別值的地方——環境變數、查詢參數、情境動作的設定欄位——都可以選擇 自訂清單類型,再挑選想用的清單。該欄位就會變成一個標籤下拉選單。
有兩種變體:
- 自訂清單:單選;
- 多重自訂清單:可選多個標籤,其值會被串接起來。
取消勾選某個項目,會把它從下拉選單中移除,同時讓它無法被解析:仍然引用著它的 請求,送出時會帶著原始標籤而不是它的值。這是刻意設計的行為——它讓一個已經失效的 引用被看見,而不是靜靜地失敗。
什麼時候該用一般的變數?
Section titled “什麼時候該用一般的變數?”| 需求 | 請選擇 |
|---|---|
會隨環境而改變的值(baseUrl) | 一個環境變數 |
| 從有限集合中做選擇,且在所有環境中都相同 | 一份自訂清單 |
| 由匯入的規格所規定的一組值 | 一個列舉(匯入時建立) |
型別為「自訂清單」的情境參數在命令列上是以標籤傳遞的,Restorm 會把它轉換成 對應的值:
restorm --open projet.restorm --run "Rendu" --headless --param Couleur=Rouge請參閱 headless 執行與 CI。