Las variables de Slides recuperan la información introducida en Ezus y la insertan automáticamente en el documento generado.

Si es la primera vez que utilizas variables, empieza por Primeros pasos con las variables.

💡 Puedes encontrar las variables directamente en el Variable Drawer mientras editas tu plantilla. Siempre que sea posible, copia la variable desde el drawer en lugar de escribirla manualmente.

Utiliza este artículo cuando necesites encontrar una variable específica de Slides o comprender su sintaxis, las opciones disponibles o su contexto.

Las variables en Ezus pueden dividirse en dos grupos principales:

Variables generales, para información relacionada con el proyecto, el cliente, los contactos, las alternativas, los pagos y otra información a nivel de proyecto.
Variables del programa, para información relacionada con el itinerario, como días, etapas, alojamientos, transportes, productos y destinos.

La mayoría de las variables están disponibles para todos los clientes. Las variables de campos personalizados son diferentes: recuperan información de campos configurados específicamente para tu cuenta. Las veremos por separado más adelante en este artículo.

Cómo leer las variables

Algunas variables de este artículo contienen marcadores de posición. Sustitúyelos por la información que quieras recuperar.

Marcador de posición	Marcador de posición	Ejemplo
`N`	El número del elemento que quieres mostrar. `1` = primer elemento, `2` = segundo elemento, `3` = tercer elemento, etc.	`$$days.2.title$$` recupera el título del segundo día.
`N'`	El número de la alternativa que quieres mostrar. Las alternativas se numeran a partir de `0`: `0` = primera alternativa, `1` = segunda alternativa, etc.	`$$alternatives.0.title$$` recupera el título de la primera alternativa.
`Z`	El tipo de elemento del programa: `steps`, `accom` o `transp`.	Sustituye `Z` por `transp` para recuperar información de los transportes.
`[X]`	La categoría que quieres recuperar, como `[train]`, `[hotel]` o `[restaurant]`.	`$$transp.[train].1.title$$` recupera el título del primer tren.
`[short]` / `[long]`	La versión de una descripción que quieres mostrar.	`$$destination.description.[long]$$` recupera la descripción larga.

💡 No necesitas crear las variables manualmente. Siempre que sea posible, busca y copia la variable directamente desde el Variable Drawer.

Por ejemplo, la variable de referencia:

$$Z.[X].N.title$$

puede convertirse en:

$$transp.[train].1.title$$

Esto recupera el título del primer elemento de transporte de la categoría tren.

⚠️ N y N' no empiezan por el mismo número. La mayoría de los elementos numerados utilizan 1 para el primer elemento, mientras que las alternativas empiezan por 0.

Variables generales

Las variables generales recuperan información que no está vinculada a un elemento concreto del programa.

Incluyen información relacionada con el proyecto, el cliente, los contactos, las alternativas y los pagos.

Alternativas

💡 A diferencia de la mayoría de las variables numeradas, las alternativas se numeran empezando por 0, no por 1. Por lo tanto, la primera alternativa es 0.

Información	Variable
Destinatio	`$$alternatives.N'.destination$$`
Subdestino	`$$alternatives.N'.sub_destination$$`
Número de personas	`$$alternatives.N'.people$$`
Presupuesto	`$$alternatives.N'.budget$$`
Presupuesto por pasajero	`$$alternatives.N'.budget_pax$$`
Fecha de inicio	`$$alternatives.N'.date_in$$`
Fecha de fin	`$$alternatives.N'.date_out$$`
Duración	`$$alternatives.N'.duration$$`
Noches	`$$alternatives.N'.nights$$`
Titulo	`$$alternatives.N'.title$$`
Referencia	`$$alternatives.N'.reference$$`

Por ejemplo:

$$alternatives.0.title$$

recupera el título de la primera alternativa.

Presupuestos de las alternativas

Información	Variable
Presupuesto sin impuestos	`$$alternatives.N'.actual_budget.excl_tax$$`
Presupuesto con impuestos	`$$alternatives.N'.actual_budget.incl_tax$$`
Impuestos	`$$alternatives.N'.actual_budget.tax$$`
Presupuesto/pax sin impuestos	`$$alternatives.N'.actual_budget.pax.excl_tax$$`
Presupuesto/pax con impuestos	`$$alternatives.N'.actual_budget.pax.incl_tax$$`
Impuestos/pax	`$$alternatives.N'.actual_budget.pax.tax$$`

También pueden añadirse las siguientes variaciones cuando sean compatibles:

.options

.with_options

Por ejemplo:

$$alternatives.0.actual_budget.incl_tax.options$$

Contactos

Información	Variable
Nombre	`$$contacts.N.first_name$$`
Apellido	`$$contacts.N.last_name$$`
Nombre completo	`$$contacts.N.name$$`
Tratamiento	`$$contacts.N.civility$$`
Cargo	`$$contacts.N.title$$`
Email	`$$contacts.N.email$$`
Teléfono 1	`$$contacts.N.phone1$$`
Teléfono 2	`$$contacts.N.phone2$$`
Fecha de nacimiento	`$$contacts.N.birth_date$$`

Pagos

Resumen de pagos

Información	Variable
Fecha	`$$payments.date$$`
Cantidad	`$$payments.amount$$`
Porcentaje	`$$payments.%$$`

Pago específico

Información	Variable
Fecha	`$$payment.N.date$$`
Cantidad	`$$payment.N.amount$$`
Porcentaje	`$$payment.N.%$$`

Variables del programa

Las variables del programa recuperan información del itinerario y de los elementos asociados.

Los elementos del programa pueden incluir:

steps
accom
transp

Destinos

Información	Variable
Imagen	`$$destination.images.N$$`
Descripción corta	`$$destination.description.[short]$$`
Descripción larga	`$$destination.description.[long]$$`

Días

Información	Variable
Título del día	`$$days.N.title$$`
Fecha del día	`$$days.N.date$$`
Imagen del día	`$$days.N.images.N$$`

Por ejemplo:

$$days.3.images.2$$

recupera la segunda imagen del Día 3.

Elementos del programa

Utiliza steps, accom o transp según el tipo de información del programa que quieras recuperar.

Información	Variable
Título	`$$Z.[X].N.title$$`
Fecha de inicio	`$$Z.[X].N.date_start$$`
Hora de inicio	`$$Z.[X].N.hours_start$$`
Fecha de finalización	`$$Z.[X].N.date_end$$`
Hora de finalización	`$$Z.[X].N.hours_end$$`
Duración	`$$Z.[X].N.duration$$`
Noches	`$$Z.[X].N.nights$$`
Número de pasajeros	`$$Z.[X].N.pax$$`
Dirección	`$$Z.[X].N.address$$`
Categoria	`$$Z.N.category$$`

Descripciones e imágenes

Información	Variable
Descripción corta	`$$Z.[X].N.description.[short]$$`
Descripción larga	`$$Z.[X].N.description.[long]$$`
Imagen	`$$Z.[X].N.images.N$$`

Productos

Información	Variable
Todos los productos	`$$Z.[X].N.products$$`
Productos opcionales	`$$Z.[X].N.products.option$$`
Productos sin opciones	`$$Z.[X].N.products.no_option$$`

Listas

Información	Variable
Etapas	`$$steps.list$$`
Alojamientos	`$$accom.list$$`
Transportes	`$$transp.list$$`
Transportes filtrados por categoría	`$$transp.[X].list$$`

Etapas dentro de un día

Utiliza days.N.steps cuando quieras recuperar las etapas pertenecientes a un día específico.

Información	Variable
Título	`$$days.N.steps.[X].N.title$$`
Fecha de inicio	`$$days.N.steps.[X].N.date_start$$`
Hora de inicio	`$$days.N.steps.[X].N.hours_start$$`
Fecha de finalización	`$$days.N.steps.[X].N.date_end$$`
Hora de finalización	`$$days.N.steps.[X].N.hours_end$$`
Número de pasajeros	`$$days.N.steps.[X].N.pax$$`
Dirección	`$$days.N.steps.[X].N.address$$`
Categoria	`$$days.N.steps.[X].N.category$$`
Descripción corta	`$$days.N.steps.[X].N.description.[short]$$`
Descripción larga	`$$days.N.steps.[X].N.description.[long]$$`
Imagen	`$$days.N.steps.[X].N.images.N$$`

Productos asociados a las etapas

Información	Variable
Todos los productos	`$$days.N.steps.[X].products$$`
Productos opcionales	`$$days.N.steps.[X].products.option$$`
Productos sin opciones	`$$days.N.steps.[X].products.no_option$$`

Etapas por momento del día

Información	Variable
Todas las etapas	`$$days.N.steps.list$$`
Mañana	`$$days.N.steps.[morning].list$$`
Tarde	`$$days.N.steps.[afternoon].list$$`
Noche	`$$days.N.steps.[evening].list$$`

🔭 See Categories and Moments of the day in Slides to learn how to use categories and moments of the day to control which program information is displayed.

Información del proveedor asociada a un producto

También puedes recuperar información sobre el proveedor asociado al producto actual.

Por ejemplo:

$$this.supplier.title$$

$$this.supplier.capacity$$

$$this.supplier.website$$

$$this.supplier.address.[country]$$

$$this.supplier.contacts.N.name$$

Información del Provider

La información del Provider tiene sus propias variables.

Para encontrarlas en el Variable Drawer, ve a:

Product → Provider

Las variables de Provider siguen la misma estructura y lógica que las variables de Supplier, pero recuperan información del provider asociado al producto.

⚠️ Las variables de Supplier y Provider no son intercambiables. Asegúrate de seleccionar la fuente correcta, especialmente cuando un producto contiene información tanto de Supplier como de Provider.

Proveedor y Producto de un elemento del programa

También puedes acceder a información asociada a un elemento concreto del programa.

Fuente de información	Estructura
Proveedor	`$$Z.N.supplier...$$`
Producto	`$$Z.N.product...$$`
Proveedor dentro de un día	`$$days.N.steps.N.supplier...$$`
Producto dentro de un día	`$$days.N.steps.N.product...$$`

Añade la información que quieras recuperar después del objeto.

Por ejemplo:

$$Z.N.supplier.title$$

recupera el título del proveedor asociado al elemento del programa seleccionado.

Variables de campos personalizados

Las variables que hemos visto hasta ahora recuperan información estándar de Ezus disponible para los clientes. Los campos personalizados son diferentes porque son campos configurados específicamente para tu cuenta.

Esto significa que una variable de campo personalizado contiene un nombre técnico que depende de tu propia configuración.

En la sintaxis de la variable, {{Y}} representa el nombre técnico del campo personalizado, no su nombre visible.

Por ejemplo, imagina que tienes un campo personalizado que se muestra como:

Número de estrellas

con el nombre técnico:

nb_stars

Una variable escrita en la referencia como:

$$this.{{Y}}$$

se convertiría en:

$$this.{{nb_stars}}$$

[Screenshot: Configuración del campo personalizado mostrando el nombre visible del campo y su nombre técnico, con nb_stars resaltado]

💡 Copia el nombre técnico desde la configuración del campo personalizado en lugar de asumir que es el mismo que el nombre visible del campo.

Dependiendo de dónde esté configurado el campo personalizado, puedes utilizar estructuras como:

Información	Variable
Campo personalizado del proyecto	`$$project.{{Y}}$$`
Campo personalizado del cliente	`$$client.{{Y}}$$`
Campo personalizado del objeto actual	`$$this.{{Y}}$$`
Campo personalizado de un elemento del programa	`$$Z.[X].N.{{Y}}$$`
Campo personalizado de una etapa dentro de un día	`$$days.N.steps.[X].N.{{Y}}$$`

Por ejemplo, si una etapa de restaurante contiene un campo personalizado cuyo nombre técnico es menu:

$$steps.[restaurant].1.{{menu}}$$

recupera el valor almacenado en el campo personalizado menu de la primera etapa de restaurante.

⚠️ Los campos personalizados dependen de la configuración de tu cuenta. Un nombre técnico utilizado en otra cuenta o en otro campo personalizado no recuperará automáticamente tu información.

🔭 Consulta [artículo sobre cómo crear y configurar campos personalizados] para aprender qué son los campos personalizados, dónde se configuran y cómo encontrar sus nombres técnicos.

Formato de fechas

Puedes controlar cómo aparece una fecha añadiendo un formato de fecha a la variable.

Formatos habituales

Formato	Muestra
`.[w_day]`	Día de la semana
`.[day]`	Día
`.[month]`	Mes
`.[year]`	Año

Por ejemplo, si el Día 1 es miércoles, 14 de diciembre de 2022:

$$days.1.date.[day]$$

muestra:

$$days.1.date.[month]$$

muestra:

December

$$days.1.date.[year]$$

muestra:

2022

Formatos de fecha personalizados

Puedes combinar códigos de fecha para crear el formato de fecha exacto que quieras.

Por ejemplo, si quieres mostrar:

Wednesday 14 December

utiliza:

$$days.1.date.[%A %d %B]$$

Si quieres mostrar la fecha completa incluyendo el año:

Wednesday 14 December 2022

utiliza:

$$days.1.date.[%A %d %B %Y]$$

Codigo	Significado
`%a`	Día de la semana abreviado
`%A`	Día de la semana completo
`%w`	Número del día de la semana
`%d`	Día del mes
`%b`	Mes abreviado
`%B`	Mes completo
`%m`	Número del mes
`%y`	Año con dos dígitos
`%Y`	Año completo
`%j`	Número del día en el año
`%U`	Número de la semana, comenzando en domingo
`%W`	Número de la semana, comenzando en lunes
`%%`	Carácter `%`
`%d’`	Día con terminación ordinal

Formato de imágenes

Las variables de imagen de Slides pueden utilizar diferentes comportamientos de imagen.

Comportamiento	Ejemplo
Estándar	`$$client.logo$$`
Crop	`$$client.logo.[crop]$$`
Center	`$$client.logo.[center]$$`

🔭 Consulta Añadir y dar formato a variables de imagen en Slides para aprender cuándo utilizar la variable de imagen estándar, crop o center.

Modificadores de Slides

Los siguientes símbolos no son variables. Cambian el comportamiento del contenido cuando falta la información asociada a una variable.

Símbolo	Finalidad
`&& ... &&`	Oculta el texto estático asociado cuando la variable no existe
`@@`	Añade un salto de línea únicamente cuando existe la variable siguiente
`#--#`	Elimina una fila de una tabla cuando la variable no existe

⚠️ Estos modificadores son específicos de Slides. No los utilices en plantillas HTML.

🔭 Consulta Utilizar modificadores en Slides para ver ejemplos e instrucciones sobre cómo utilizar estos modificadores.

Lista completa de variables para Slides

Cómo leer las variables

Variables generales

Alternativas

Presupuestos de las alternativas

Contactos

Pagos

Resumen de pagos

Pago específico

Variables del programa

Destinos

Días

Elementos del programa

Descripciones e imágenes

Productos

Listas

Etapas dentro de un día

Productos asociados a las etapas

Etapas por momento del día

Información del proveedor asociada a un producto

Información del Provider

Proveedor y Producto de un elemento del programa

Variables de campos personalizados

Formato de fechas

Formatos habituales

Formatos de fecha personalizados

Formato de imágenes

Modificadores de Slides