Primeros pasos con las variables
Las variables te permiten mostrar automáticamente información de tus proyectos de Ezus en tus documentos y páginas web. En lugar de actualizar manualmente la misma información para cada cliente, puedes insertar una variable en una plantilla y dejar que Ezus recupere el valor correspondiente cuando se genere el documento.
¿Qué es una variable?
Una variable es un marcador que conecta una plantilla con la información almacenada en Ezus.
Por ejemplo, puedes insertar:
$$project.title$$
Cuando generas el documento, Ezus sustituye la variable por el título del proyecto actual.
Si tu proyecto se llama Aventura en Islandia, el resultado será:
Aventura en Islandia
Esto significa que puedes reutilizar la misma plantilla para diferentes proyectos sin tener que sustituir manualmente la información del proyecto cada vez.
💡 Piensa en una variable como una instrucción que le indica a Ezus: “Muestra aquí esta información específica.”
¿Dónde puedo encontrar las variables?
Cuando editas una plantilla de documento, puedes encontrar las variables disponibles en el Variable Drawer, situado en la esquina superior izquierda de la pestaña Modificación del documento.
El Variable Drawer se divide en dos áreas principales:
General: información relacionada con el proyecto, brief, usuario, cliente, viajeros, cuenta y alternativas.
Programa: información relacionada con el itinerario, incluidos días, etapas, actividades, alojamientos, transportes, productos y proveedores.
Siempre que sea posible, selecciona y copia las variables directamente desde el Variable Drawer en lugar de escribirlas manualmente. Esto te ayudará a mantener la sintaxis correcta.
Elige la variable según dónde esté almacenada la información
Antes de seleccionar una variable, identifica de dónde procede la información en Ezus.
Puede existir información similar en diferentes niveles de un proyecto, y elegir una variable del nivel equivocado puede devolver un resultado diferente al esperado.
Por ejemplo:
Si quieres información sobre el hotel asociado a un día concreto, utiliza la información correspondiente de Día / Programa.
Si quieres el primer alojamiento del proyecto independientemente del día, utiliza una variable de Alojamiento.
Si quieres información general, como el título del proyecto o el nombre del cliente, utiliza la variable General correspondiente.
💡 No empieces preguntándote “¿Qué variable debo utilizar?”. Empieza preguntándote “¿Dónde está almacenada esta información en Ezus?”. Después, elige la variable asociada a ese nivel.
Variables en Slides
En las plantillas de Slides, las variables utilizan la sintaxis $$...$$.
Por ejemplo:
$$project.title$$
Puedes combinar texto estático y variables en la misma área de texto. El texto estático permanece sin cambios, mientras que la variable se sustituye por información del proyecto cuando se genera el documento.
Por ejemplo:
Tu viaje a $$project.destination$$
podría generar:
Tu viaje a Islandia
Las variables pueden recuperar muchos tipos diferentes de información, incluidos textos, fechas, descripciones, imágenes, información del proyecto e información del programa.
🔭 Consulta Lista completa de variables para Slides para conocer las variables disponibles en Slides, su sintaxis y ejemplos.
Variables en plantillas HTML
Las páginas web HTML también utilizan variables para recuperar información de Ezus.
Cuando una variable se utiliza fuera de un bucle, puedes utilizar las variables disponibles en el Variable Drawer de la misma forma que en Slides.
Por ejemplo:
<h1>$$project.title$$</h1>
Cuando se genera la página web, $$project.title$$ se sustituye por el título del proyecto actual.
Dentro de un bucle HTML, la sintaxis cambia porque estás trabajando con el elemento actual de ese bucle.
Por ejemplo, dentro de un bucle que recorre los días del programa:
{% for day in days %} <h2>{{ day.title }}</h2> {% endfor %}Aquí, {{ day.title }} recupera el título de cada día a medida que el bucle recorre el programa.
⚠️ No copies automáticamente una variable de Slides dentro de un bucle HTML. Las variables situadas fuera de los bucles y las variables que hacen referencia al objeto actual dentro de un bucle no utilizan la misma sintaxis.
🔭 Consulta Variables HTML para conocer las variables HTML disponibles y Uso de bucles en plantillas HTML para aprender cómo funcionan las variables con contenido repetido.
¿Qué ocurre si una variable no muestra la información esperada?
Si una variable está vacía o devuelve información inesperada, comprueba primero los datos de origen antes de modificar la plantilla.
Comprueba que:
La información exista en el proyecto.
Estés utilizando la variable correspondiente al objeto o nivel de información correcto.
La sintaxis de la variable no haya sido modificada.
La plantilla se esté probando con un proyecto que contenga la información que quieres mostrar.
Si estás trabajando con HTML, la variable se esté utilizando en el contexto correcto, especialmente cuando se encuentra dentro de un bucle.
⚠️ Un resultado vacío no significa necesariamente que la variable sea incorrecta. Si la información correspondiente no se ha completado en el proyecto, es posible que Ezus simplemente no tenga ningún valor que mostrar.
Prueba tus variables
Después de añadir o modificar una variable:
Guarda la plantilla.
Genera el documento o la página web utilizando un proyecto representativo.
Compara el resultado generado con la información almacenada en el proyecto.
Comprueba que el valor esperado aparezca en el lugar correcto.
Si no aparece, verifica la información de origen y el contexto de la variable antes de volver a modificar la plantilla.
💡 Utiliza un proyecto de prueba representativo que contenga días, actividades, alojamientos, transportes, descripciones e imágenes cuando corresponda. Un proyecto con información incompleta puede no ser suficiente para determinar si una variable funciona correctamente.
🔭 Una vez que te sientas cómodo utilizando variables, continúa con Lista completa de variables para Slides o Variables HTML para encontrar la sintaxis exacta de la información que quieres mostrar.