¿Qué son las variables?
Las variables son los placeholders que usás en una plantilla para que el sistema reemplace ese texto con un dato real cuando se ejecuta la solicitud. Por ejemplo, en lugar de escribir "Hola Juan" en una notificación, escribí Hola {{empleado.nombre}} y cada solicitud usará el nombre del colaborador correspondiente.
Sintaxis
Siempre con doble llave: {{objeto.propiedad}}. Las mayúsculas importan. Espacios dentro de las llaves no son válidos (escribí {{empleado.nombre}}, no {{ empleado.nombre }}).
Dónde se pueden usar
| Lugar | Soporte de variables |
|---|---|
| Cuerpo de notificaciones | Sí, todas las variables del contexto |
| Asunto de notificaciones | Sí |
| Plantillas de documentos asociadas a la acción final | Sí |
| Campos del formulario (labels, valores por defecto) | Sí para el valor por defecto, no para el label |
| Reglas de avance condicional | Solo campos del sistema (no campos personalizados libres) |
Variables más usadas
| Variable | Qué devuelve |
|---|---|
{{empleado.nombre}} | Nombre completo del colaborador afectado |
{{empleado.rut}} | RUT / DNI / CURP / cédula según país |
{{empleado.fecha_ingreso}} | Fecha de ingreso (formato YYYY-MM-DD) |
{{empleado.cargo}} | Nombre del cargo |
{{empleado.area}} | Nombre del área |
{{solicitante.nombre}} | Quién inició la solicitud |
{{plantilla.nombre}} | Nombre de la plantilla |
{{etapa.nombre}} | Etapa actual del flujo |
{{solicitud.url}} | Link directo a la solicitud |
{{solicitud.fecha}} | Fecha en que se inició la solicitud |
{{formulario.<campo>}} | Valor de un campo del formulario (reemplazá <campo> por el nombre interno del campo) |
Formato de variables
Podés aplicar transformaciones básicas:
- Fechas:
{{empleado.fecha_ingreso | formato:dd-MM-yyyy}}devuelve "15-03-2026" en lugar de "2026-03-15". - Texto en mayúsculas:
{{empleado.nombre | mayuscula}}. - Números con separador de miles:
{{empleado.sueldo | numero}}devuelve "1.500.000" en lugar de "1500000".
Casos comunes
- "La variable se muestra literal en el correo final (
{{empleado.nombre}})": la variable está mal escrita, no existe en el contexto, o hay un espacio dentro de las llaves. Revisá la sintaxis exacta. - "Necesito usar un campo del formulario en una notificación": usá
{{formulario.<nombre_interno>}}. El nombre interno se ve cuando editás el campo en el formulario. - "Quiero condicionar el avance en base a un campo libre": no es posible. Las condiciones de avance solo aceptan campos del sistema (atributos de la ficha del colaborador). Si necesitás condicionar por un dato del formulario, convertilo en un atributo personalizado a nivel ficha en lugar de un campo libre.
- "La imagen no aparece embebida en el correo": no es posible embeber imágenes dinámicas como variable. Solo se puede incluir el link al recurso (
{{empresa.logo_url}}por ejemplo).
Limitaciones
- No se pueden encadenar variables (ej.
{{empleado.supervisor.nombre}}no resuelve en cadena; necesitás una variable directa). - No hay condicionales tipo if/else dentro del texto de una notificación.
- Variables de campos personalizados libres no se sincronizan a la ficha al final del flujo.