Variabili di generazione

Un template non conosce il suo progetto. Le variabili di generazione sono il ponte: il template dichiara le variabili di cui ha bisogno, e ne compila il valore in Restorm. Alla generazione, ogni valore viene valutato poi iniettato nel contesto del template.

Variabile o flag nativo?

Non usare una variabile se non per ciò che il design non porta già. Le intenzioni che ha inserito nel design (searchable, PII, volumetria, profilo di accesso, traffico, freschezza, sensibilità, ritenzione, cache, autenticazione…) sono direttamente leggibili nel template tramite ctx — inutile ridichiararle. Vedi Il contesto del template. Le variabili servono per le impostazioni proprie del template: nome del pacchetto, namespace, versione del framework, generare un Dockerfile o no, ecc.

Dichiarare e compilare

Ogni variabile è dichiarata dal template (nel suo restorm-template.json) con un nome, un ambito, un tipo, un valore predefinito e una descrizione facoltativa. Lato Restorm, compila il suo valore sotto forma di espressione Handlebars — valutata per ogni entità interessata, poi convertita al tipo dichiarato.

I tipi possibili sono string, boolean, number ed enum (con la sua lista di opzioni).

Un’azione Scopri le variabili utilizzate da questo template analizza il template e segnala le variabili utilizzate ma non dichiarate, per evitare le dimenticanze.

Gli ambiti

L’ambito decide a quale livello la variabile viene valutata e dove atterra nel contesto del template:

Ambito	Valutata	Disponibile nel template
Progetto	una volta	ctx.design.vars.<nom>
Modello	per modello	ctx.models[].vars.<nom>
Proprietà	per proprietà	ctx.models[].properties[].vars.<nom>
Rotta	per rotta	ctx.groups[].routes[].vars.<nom>

Valore generale e override

Per ogni template, definisca valori generali per ambito (le «variabili generali», che si applicano per esempio a tutti i modelli). Può poi fare override di una variabile per un modello, una proprietà o una rotta dati, dalla scheda Code generation di quell’entità. Un valore vuoto significa «ereditare»: il primo valore non vuoto prevale, e ogni valore non risolto risale come un errore — mai in silenzio.