Variables de generación
Una plantilla no conoce su proyecto. Las variables de generación son el puente: la plantilla declara las variables que necesita, y usted rellena su valor en Restorm. Al generar, cada valor se evalúa y luego se inyecta en el contexto de la plantilla.
Declarar y rellenar
Section titled “Declarar y rellenar”Cada variable es declarada por la plantilla (en su
restorm-template.json) con un nombre, un
ámbito, un tipo, un valor por defecto y una descripción facultativa.
Del lado de Restorm, usted rellena su valor en forma de expresión Handlebars —
evaluada para cada entidad afectada, y luego convertida al tipo declarado.
Los tipos posibles son string, boolean, number y enum (con su
lista de opciones).
Una acción Descubrir las variables utilizadas por esta plantilla analiza la plantilla y señala las variables utilizadas pero no declaradas, para evitar los olvidos.
Los ámbitos
Section titled “Los ámbitos”El ámbito decide a qué nivel se evalúa la variable y dónde aterriza en el contexto de la plantilla:
| Ámbito | Evaluada | Disponible en la plantilla |
|---|---|---|
| Proyecto | una vez | ctx.design.vars.<nom> |
| Modelo | por modelo | ctx.models[].vars.<nom> |
| Propiedad | por propiedad | ctx.models[].properties[].vars.<nom> |
| Ruta | por ruta | ctx.groups[].routes[].vars.<nom> |
Valor general y sobrescritura
Section titled “Valor general y sobrescritura”Para cada plantilla, usted define valores generales por ámbito (las «variables generales», que se aplican por ejemplo a todos los modelos). Puede luego sobrescribir una variable para un modelo, una propiedad o una ruta dados, desde la pestaña Code generation de esa entidad. Un valor vacío significa «heredar»: el primer valor no vacío prevalece, y todo valor no resuelto sube como un error — nunca en silencio.