Las plantillas contienen el texto de los mensajes que produce Portail ZAPP: correos de cuenta (verificación, contraseña olvidada…), notificaciones, alertas de vencimiento, correos enviados desde un ticket del Service Desk y algunos documentos PDF. Modificar una plantilla cambia lo que reciben los destinatarios, sin tocar el resto de la aplicación.
La pantalla Plantillas (menú Administración › Apariencia e idiomas › Plantillas) está reservada a los Administradores.
La lista de plantillas
Cada plantilla tiene una Clave (su identificador, que usan los módulos que envían el mensaje), un Nombre, una Categoría opcional, los Idiomas en los que está redactada y un Estado (Activo o Inactivo). El nombre se muestra en tu idioma, aquí y en todas las listas de selección de plantillas. Busca por nombre (en cualquier idioma) o clave y filtra por categoría. Cuando el módulo Cuadrículas de datos está instalado, la lista es una cuadrícula.
En cada fila, el lápiz abre la plantilla y el ojo abre su Vista previa.
La mayoría de las plantillas vienen con los módulos. Una plantilla incluida que eliminas se vuelve a crear con su texto original en el siguiente arranque de la aplicación. Cuando una actualización corrige el texto de una plantilla incluida, la corrección solo se aplica a las versiones que nunca has modificado: tus personalizaciones nunca se sobrescriben.
Crear una plantilla
Nueva plantilla pide:
- Clave: solo letras minúsculas, cifras,
_,-y., sin espacios. Debe ser única y ya no se puede modificar; - Nombre: un campo por idioma de la instancia; el del idioma predeterminado es obligatorio. Un idioma vacío muestra el nombre del idioma predeterminado;
- Categoría (texto libre, para clasificar la lista).
La plantilla se crea activa y vacía: llegas directamente a su ficha para añadir un primer idioma. Crear una plantilla no basta para usarla: es la función que envía el mensaje (por ejemplo, un paso de notificación de un proceso o el envío de un correo desde un ticket) la que designa la plantilla.
Modificar una plantilla
La tarjeta Metadatos permite ajustar:
- el Nombre, uno por idioma: cada uno ve la plantilla en el suyo. Las plantillas incluidas tienen su nombre en francés, inglés y español;
- la Categoría;
- Activa: una plantilla inactiva deja de usarse. Según la función, los mensajes que dependen de ella se envían sin su formato o no se envían; tampoco se propone ya en las listas de selección de plantillas;
- Envolver en el layout de correo: el contenido se coloca dentro del diseño común de los correos (logotipo, colores, pie de página); consulta «Dar formato a los correos». No afecta a las notificaciones que se muestran en la aplicación.
Haz clic en Guardar para aplicar.
Las versiones por idioma
Cada idioma de la plantilla tiene su pestaña, con:
- Asunto (obligatorio);
- Correo del remitente y Nombre del remitente: si se dejan vacíos, se usa el remitente configurado para la instancia;
- Contenido HTML: el cuerpo del mensaje.
Añadir un idioma propone los idiomas activos de la instancia. Elegir un idioma que ya existe sustituye su versión.
Eliminar, en la pestaña de un idioma, elimina solo esa versión tras confirmación; los demás idiomas de la plantilla se conservan.
El texto puede contener variables, escritas con su nombre entre dobles llaves, que la función que envía el mensaje sustituye por sus valores (nombre del destinatario, número de ticket…). Los valores siempre se insertan como texto: no pueden inyectar HTML. Las fechas se formatean según el idioma del mensaje.
Al enviar un mensaje, Portail ZAPP elige la versión en el idioma del destinatario; si no existe, la del idioma predeterminado de la instancia; si tampoco, la primera versión disponible.
Vista previa
Vista previa muestra el mensaje tal como se enviará, con el diseño de correo incluido si la plantilla lo usa. Elige el Idioma y rellena las Variables (una por línea, con la forma nombre=valor): la lista viene rellenada con las variables encontradas en la plantilla. Renderizar muestra el Asunto y la Salida HTML; Ver código fuente alterna entre el resultado y el código HTML. Si la plantilla contiene un error de sintaxis, o si está inactiva, aparece en su lugar el mensaje Error de renderizado.
Exportar e importar
- Exportar todo descarga todas las plantillas y sus versiones en un archivo JSON; Exportar, en la ficha de una plantilla, descarga solo esa.
- Importar carga un archivo con el mismo formato. Las plantillas que faltan se crean. Para una plantilla que ya existe (misma clave), cada versión del archivo sustituye a la versión del mismo idioma, personalizada o no; su nombre y su categoría no cambian. Una importación puede activar el diseño de correo de una plantilla, nunca desactivarlo.
Usa la exportación y la importación para llevar plantillas de una instancia de pruebas a producción.
Eliminar una plantilla
Eliminar plantilla, en su ficha, la elimina con todas sus versiones, tras confirmación. Una plantilla incluida vuelve en el siguiente arranque (texto original); para detener un mensaje, es preferible desmarcar Activa.
Ver también
- «Dar formato a los correos»: el diseño común de los correos.