Variabel generasi

Sebuah template tidak mengenal proyek Anda. Variabel generasi adalah jembatannya: template mendeklarasikan variabel yang dibutuhkannya, dan Anda mengisi nilainya di Restorm. Saat generasi, setiap nilai dievaluasi lalu disuntikkan ke dalam konteks template.

Variabel atau penanda bawaan?

Gunakan sebuah variabel hanya untuk apa yang belum dibawa oleh desain. Maksud yang telah Anda masukkan ke dalam desain (searchable, PII, volume, profil akses, lalu lintas, kesegaran, sensitivitas, retensi, cache, autentikasi…) dapat langsung dibaca di template melalui ctx — tidak perlu dideklarasikan ulang. Lihat Konteks template. Variabel berguna untuk pengaturan khusus template: nama paket, namespace, versi framework, menghasilkan Dockerfile atau tidak, dsb.

Mendeklarasikan dan mengisi

Setiap variabel dideklarasikan oleh template (di dalam restorm-template.json-nya) dengan sebuah nama, sebuah lingkup, sebuah tipe, sebuah nilai bawaan, dan deskripsi opsional. Di sisi Restorm, Anda mengisi nilainya dalam bentuk ekspresi Handlebars — dievaluasi untuk setiap entitas yang bersangkutan, lalu dikonversi ke tipe yang dideklarasikan.

Tipe yang mungkin adalah string, boolean, number, dan enum (beserta daftar opsinya).

Sebuah aksi Temukan variabel yang digunakan oleh template ini menganalisis template dan menandai variabel yang digunakan tetapi tidak dideklarasikan, untuk menghindari kelalaian.

Lingkup

Lingkup menentukan pada tingkat mana variabel dievaluasi dan di mana ia mendarat dalam konteks template:

Lingkup	Dievaluasi	Tersedia di template
Proyek	sekali	ctx.design.vars.<nom>
Model	per model	ctx.models[].vars.<nom>
Properti	per properti	ctx.models[].properties[].vars.<nom>
Rute	per rute	ctx.groups[].routes[].vars.<nom>

Nilai umum dan penimpaan

Untuk setiap template, Anda mendefinisikan nilai umum per lingkup (yang disebut « variabel umum », yang misalnya berlaku untuk semua model). Anda kemudian dapat menimpa sebuah variabel untuk sebuah model, properti, atau rute tertentu, dari tab Code generation entitas tersebut. Sebuah nilai kosong berarti « mewarisi »: nilai tak-kosong pertama menang, dan setiap nilai yang tidak terselesaikan muncul sebagai sebuah galat — tidak pernah dalam diam.