Nociones básicas para crear una Notification Template (Plantilla de Notificación)

Describimos en este artículo varias nociones básicas a tener en cuenta siempre que se vaya a generar una plantilla de notificación para utilizar en operaciones que envían avisos vía correo electrónico, como por ejemplo "Send document and metadata by email".

Puedes hacer esto desde la administración avanzada, en el apartado Notificaciones.

Utiliza el más "+" para añadir una nueva notificación. Tendrás que rellenar cierta información básica.

Usar información dinámica en el asunto o en el cuerpo del correo

Siempre que en el Subject o en el Body, o en los dos a la vez, se vayan a utilizar variables que se van a sustituir al generar la notificación, hay que utilizar la siguiente etiqueta al comienzo de cada bloque.

{% load filetags %}

A continuación, se muestra su uso en el asunto y en el cuerpo.



Algunas etiquetas que te resultarán de utilidad:

{{fil.filename}} -> Título del documento

{{fil.uuid}} -> Identificador interno del documento

{{fil|gmv:"metadata.field1"}} -> 
Imprime el valor de un campo. Remplaza "field1" con el nombre de la API del campo
que quieres imprimir. 

{{fil.id|gmv_printable:"metadata.field2"}} ->
Utiliza esta etiqueta cuando trabajes con campos de tipo
diccionario, documento, usuarios, etc. 

{{series.team.get_absolute_logo_url}} ->
Para pintar el logo del team.

{{fil.id|gmvp_currency: "metadata.field2"}} -> Imprime un campo numérico
de tipo moneda.

{{fil.doctype.label}} -> Nombre del formulario del documento

{{fil.author}} -> Autor del documento

{{user_to.first_name}} -> Imprime el nombre del destinatario

{{current_user}} -> Usuario que ejecuta la operación. 
Puede no siempre estar disponible.

A continuación tienes un ejemplo de una notificación ya configurada.

Incluir el enlace al documento en el cuerpo del correo

Puedes incluir en el cuerpo del correo un enlace que lleve directo al documento para el que se ha ejecutado la notificación.

<a href="https://mycompany.athento.com/file/view/{{fil.uuid}}">{{fil.filename}}</a>

Sólo tienes que reemplazar "mycompany" por tu dominio de Athento.

Importar o exportar una plantilla de notificación entre instalaciones de Athento

Puedes encontrar los botones para importar y/o exportar una Plantilla de Notificación en la esquina superior derecha dentro de la administración avanzada de las mismas.
 
Para exportar plantillas, debes seleccionar todas las plantillas deseadas previo a hacer click sobre el botón de Exportar. Luego, puedes seleccionar el formato en el que se exportarán los datos:

Para importar plantillas, simplemente tienes que seleccionar el archivo que contiene sus datos y el formato de dicho archivo: