Daftar nilai kustom

Sebuah daftar nilai kustom memasangkan label yang mudah dibaca dengan nilai teknis. Anda memilih Merah di menu tarik-turun, lalu permintaannya dikirim dengan FF0000.

Ini setara dengan sebuah enumerasi, tetapi Anda sendiri yang mendefinisikannya, tanpa bergantung pada spesifikasi yang diimpor.

Tempat membuatnya

Bukalah folder variabel lalu tab Variabel kustom-nya. Setiap daftar memiliki nama dan serangkaian entri:

Label	Nilai	Aktif
Rouge	FF0000	✔
Vert	00FF00	✔
Bleu	0000FF	✔
Ancien code interne	X-42	✘

Menggunakannya

Di mana pun nilai bertipe diterima — variabel lingkungan, parameter kueri, kolom konfigurasi sebuah aksi skenario — pilihlah tipe Daftar kustom lalu daftar yang diinginkan. Kolomnya akan berubah menjadi menu tarik-turun berisi label.

Dua varian:

• Daftar kustom: satu pilihan saja;
• Daftar kustom ganda: beberapa label, yang nilainya digabungkan.

Entri yang dinonaktifkan

Melepas centang sebuah entri akan menghapusnya dari menu tarik-turun dan membuatnya tidak dapat diselesaikan: permintaan yang masih merujuknya akan dikirim dengan label mentahnya alih-alih nilainya. Itulah perilaku yang dikehendaki — hal itu membuat rujukan yang sudah usang menjadi terlihat alih-alih gagal diam-diam.

Kapan lebih baik memakai variabel biasa?

Kebutuhan	Pilihlah
Nilai yang berubah menurut lingkungan (baseUrl)	Sebuah variabel lingkungan
Pilihan dari sekumpulan terbatas, sama di semua lingkungan	Sebuah daftar kustom
Sekumpulan nilai yang ditetapkan oleh spesifikasi yang diimpor	Sebuah enumerasi (dibuat saat impor)

Di baris perintah

Parameter skenario yang bertipe “daftar kustom” diberikan melalui labelnya di baris perintah, dan Restorm mengonversinya menjadi nilai:

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

Lihat Eksekusi headless & CI.