Proměnné generování

Šablona nezná váš projekt. Proměnné generování jsou tím mostem: šablona deklaruje proměnné, které potřebuje, a vy vyplníte jejich hodnotu v Restormu. Při generování je každá hodnota vyhodnocena a poté vložena do kontextu šablony.

Proměnná nebo nativní příznak?

Používejte proměnnou pouze pro to, co návrh ještě nenese. Záměry, které jste zadali do návrhu (searchable, PII, volumetrie, profil přístupu, provoz, čerstvost, citlivost, retence, cache, ověřování…) jsou přímo čitelné v šabloně přes ctx — není třeba je znovu deklarovat. Viz Kontext šablony. Proměnné slouží pro nastavení specifická pro šablonu: název balíčku, jmenný prostor, verze frameworku, generovat Dockerfile nebo ne, atd.

Deklarace a vyplnění

Každá proměnná je deklarována šablonou (v jejím restorm-template.json) s názvem, rozsahem, typem, výchozí hodnotou a volitelným popisem. Na straně Restormu vyplníte její hodnotu ve formě výrazu Handlebars — vyhodnocenou pro každou dotčenou entitu a poté převedenou na deklarovaný typ.

Možné typy jsou string, boolean, number a enum (s jeho seznamem možností).

Akce Objevit proměnné použité touto šablonou analyzuje šablonu a signalizuje proměnné použité, ale nedeklarované, aby se předešlo opomenutím.

Rozsahy

Rozsah rozhoduje, na jaké úrovni je proměnná vyhodnocena a kam přistane v kontextu šablony:

Rozsah	Vyhodnocena	Dostupná v šabloně
Projekt	jednou	ctx.design.vars.<název>
Model	na model	ctx.models[].vars.<název>
Vlastnost	na vlastnost	ctx.models[].properties[].vars.<název>
Trasa	na trasu	ctx.groups[].routes[].vars.<název>

Obecná hodnota a přepsání

Pro každou šablonu definujete obecné hodnoty podle rozsahu („obecné proměnné“, které se vztahují například na všechny modely). Poté můžete přepsat proměnnou pro daný model, vlastnost nebo trasu ze záložky Code generation této entity. Prázdná hodnota znamená „zdědit“: první neprázdná hodnota vyhrává a každá nevyřešená hodnota se hlásí jako chyba — nikdy potichu.