Danh sách giá trị tùy chỉnh

Một danh sách giá trị tùy chỉnh gắn các nhãn dễ đọc với các giá trị kỹ thuật. Bạn chọn Rouge trong một menu thả xuống, còn yêu cầu thì đi kèm giá trị FF0000.

Nó tương đương với một kiểu liệt kê, nhưng do chính bạn định nghĩa, không phụ thuộc vào một đặc tả đã nhập.

Tạo chúng ở đâu

Hãy mở thư mục biến rồi vào tab Biến tùy chỉnh của nó. Mỗi danh sách có một tên và một loạt mục:

Nhãn	Giá trị	Đang bật
Rouge	FF0000	✔
Vert	00FF00	✔
Bleu	0000FF	✔
Ancien code interne	X-42	✘

Sử dụng chúng

Ở mọi nơi chấp nhận một giá trị có kiểu — biến môi trường, tham số truy vấn, trường cấu hình của một hành động kịch bản — hãy chọn kiểu Danh sách tùy chỉnh rồi chọn danh sách bạn muốn. Trường đó trở thành một menu thả xuống các nhãn.

Hai biến thể:

• Danh sách tùy chỉnh: chỉ một lựa chọn;
• Danh sách tùy chỉnh nhiều giá trị: nhiều nhãn, các giá trị của chúng được nối lại.

Mục bị vô hiệu hóa

Bỏ đánh dấu một mục sẽ gỡ nó khỏi menu thả xuống và khiến nó không giải quyết được nữa: một yêu cầu vẫn còn tham chiếu tới nó sẽ đi kèm nhãn thô thay vì giá trị. Đây là hành vi có chủ ý — nó làm lộ rõ một tham chiếu đã lỗi thời thay vì để nó thất bại một cách âm thầm.

Khi nào nên chọn một biến thông thường?

Nhu cầu	Hãy chọn
Một giá trị thay đổi theo môi trường (baseUrl)	Một biến môi trường
Một lựa chọn trong một tập hữu hạn, giống nhau ở mọi môi trường	Một danh sách tùy chỉnh
Một tập giá trị do đặc tả đã nhập áp đặt	Một kiểu liệt kê (tạo ra lúc nhập)

Trên dòng lệnh

Một tham số kịch bản có kiểu “danh sách tùy chỉnh” được truyền theo nhãn trên dòng lệnh, và Restorm sẽ chuyển nó thành giá trị:

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

Xem Chạy headless & CI.