Variables y entornos
Las variables de Restorm viven en una carpeta de variables, que puede contener varios juegos: uno por entorno.
Entornos y subentornos
Section titled “Entornos y subentornos”Un entorno es una lista de pares clave / valor. Puede contener subentornos, que heredan de su padre y sobrescriben lo que redefinen.
Es la herramienta adecuada para modelar staging → staging / customer A, staging / customer B: la base común se escribe una vez y solo
se repite la diferencia.
Elegir el entorno activo
Section titled “Elegir el entorno activo”El selector de entorno está a la izquierda de la smartbar de cada pestaña de petición. Muestra una marca de color y el nombre del entorno.
El menú emergente ofrece una casilla «Aplicar a todas las peticiones»: si está
marcada, cambia toda la carpeta de golpe. Es lo que quiere para pasar un proyecto
entero de local a staging.
Tipos de valores
Section titled “Tipos de valores”Una variable no es solo una cadena. Restorm ofrece los siguientes tipos:
| Tipo | Qué es |
|---|---|
| Cadena | Un valor literal, enviado tal cual |
| Expresión | Una plantilla Handlebars: es el único tipo cuyas {{ }} se evalúan |
| Numérico | Un número, con un formato de visualización |
| Booleano | Verdadero / falso |
| Fecha-hora | Una fecha ISO, con un formato |
| Color | Un color hexadecimal |
| Secreto | Una referencia a un origen de secretos: el valor nunca pasa por el archivo de proyecto |
| Lista | Una lista de valores |
| Enumeración / Enumeración múltiple | Un valor restringido por una enumeración importada |
| Lista personalizada / Lista personalizada múltiple | Una elección por etiqueta en una lista de valores personalizada |
| Variable | Una referencia a otra variable |
| Entorno | Una referencia a un entorno |
| Nulo | El valor nulo explícito |
Orden de resolución
Section titled “Orden de resolución”De lo más general a lo más específico; el último gana:
- el entorno raíz y después cada subentorno de la cadena;
- las variables del propio entorno, en su orden de declaración: una variable puede por tanto apoyarse en las definidas por encima de ella;
- las variables de ejecución establecidas por un escenario (acción Definir variable), que cubren el entorno durante la ejecución;
- los valores propios de la petición (cabeceras, parámetros de consulta, parámetros de ruta), resolviéndose cada grupo sobre el contexto acumulado;
- y por último las
{{ }}escritas directamente en los campos de la petición: consulte Variables en línea.
Restorm hace además varias pasadas: una expresión de un entorno padre puede, por tanto, recuperar un valor redefinido por un hijo.
Variables desactivadas
Section titled “Variables desactivadas”Cada variable tiene una casilla de activación. Una variable desactivada no entra en el contexto: es la forma limpia de neutralizar temporalmente una sobrescritura sin eliminarla.
Al importar, los pares clave / valor cuyo valor se resuelve como vacío se desactivan automáticamente: su primera ejecución no envía, por tanto, un enjambre de cabeceras vacías.
¿Y los helpers?
Section titled “¿Y los helpers?”Toda expresión es una plantilla Handlebars, con más de cien helpers disponibles: cadenas, matemáticas, fechas, listas, codificación, hash y datos aleatorios.