Configuración de plantillas de notificación

Configurar el contenido de los mensajes de correo electrónico que se envían a los usuarios cuando se desencadenan notificaciones.

Antes de empezar

Para enviar notificaciones de correo electrónico, debe configurar un servidor SMTP.

Acerca de esta tarea

Las plantillas de notificación definen los mensajes de correo electrónico que los usuarios reciben cuando se les envían notificaciones. Las plantillas son documentos HTML en los que se combinan elementos dinámicos con elementos estáticos para crear mensajes. Las plantillas se utilizan adjuntándolas a los esquemas de notificación o a las tareas de notificación que se crean. A medida que se desencadenan los sucesos, se resuelven las variables en las plantillas adjuntas en función del suceso y del contexto. Para cada uno de los sucesos configurables por el usuario se proporcionan plantillas predeterminadas. Es posible utilizar y modificar las plantillas predeterminadas o crear sus propias plantillas.

Cuando crea una plantilla, se configura un elemento de asunto y un elemento de cuerpo. Tanto el asunto como el cuerpo pueden incluir elementos estáticos y elementos dinámicos. Los elementos dinámicos se definen con el Apache Velocity Template Language (VTL). Las sentencias de VTL hacen referencia a las propiedades de IBM® UrbanCode Release. Para obtener información sobre las sentencias VTL y las propiedades que se pueden utilizar en las plantillas, consulte Variables de plantilla de notificación.

El elemento del cuerpo también puede incluir imágenes. Antes de utilizar una imagen en una plantilla, se debe subir al servidor de IBM UrbanCode Release. Las imágenes se almacenan en la carpeta especificada en la propiedad notification.images.folder.path en el archivo server.properties. De forma predeterminada, la ubicación es la carpeta [instalación_servidor]/UCRelease/ucrelease/notification-images. Existen disponibles varias imágenes predeterminadas para que el usuario las pueda utilizar en sus propias plantillas.

Nota: Si utiliza una configuración de alta disponibilidad, la carpeta que se especifica mediante la propiedad notification.images.folder.path se debe compartir en todos los nodos.

Cuando trabaje con una plantilla, puede comprobar el trabajo mostrando una vista previa del correo electrónico de notificación.

Procedimiento

  1. Desde el panel de instrumentos de IBM UrbanCode Release, pulse Valores y, a continuación, pulse Plantillas de notificación.
  2. En la página Plantillas de notificación, pulse Añadir nueva.
  3. En el campo Nombre, especifique un nombre para la plantilla. Puesto que las plantillas se asignan a sucesos específicos, es importante proporcionar un nombre descriptivo. Por ejemplo, una plantilla que se denomine "Tarea omitida" estará pensada para adjuntarla a una regla Tarea omitida.
  4. Opcional: Pulse Cargar imagen, seleccione una imagen a subir en el servidor y, a continuación, pulse Guardar. Se visualizará un mensaje de éxito que proporcionará el URL que podrá copiar y pegar en la plantilla.
    Nota: La imagen debe estar en el formato PNG.
  5. En el campo Asunto, especifique la línea del asunto del correo electrónico. En la línea del asunto se pueden utilizar sentencias VTL.
  6. En el campo Cuerpo, especifique el cuerpo principal del mensaje de correo electrónico. Utilice las características de edición para dar formato al mensaje e insertar hiperenlaces e imágenes. En el mensaje también se pueden utilizar sentencias VTL. Para obtener ejemplos de sentencias VTL habituales, consulte Variables de plantilla de notificación.

    Para insertar una imagen en el cuerpo del mensaje, realice uno de los pasos siguientes:

    • Coloque el cursor en el lugar en el que desea ubicar la imagen y, a continuación, especifique o pegue el URL de la imagen. En este fragmento de código se muestra un URL de imagen típico que podría especificar:
      <img src="../notificationTemplates/image/segment-avatar.png"/>
    • Pulse Insertar imagen, especifique el URL de la imagen, y pulse Establecer. Por ejemplo, para utilizar la imagen en el ejemplo anterior, especifique:
      ../notificationTemplates/image/segment-avatar.png
  7. Opcional: Para visualizar una vista previa del mensaje de correo electrónico, lleve a cabo los pasos siguientes:
    1. Pulse Mostrar vista previa. Se visualiza la ventana Mostrar vista previa.
    2. Seleccione el suceso y otros parámetros. Sus selecciones determinarán el contexto que utilizará la vista previa. Por ejemplo, el release que se selecciona determina el release visualizado en la vista previa.
    3. Pulse Mostrar vista previa. Se visualizará una vista previa del mensaje.
    4. Opcional: Para enviar una vista previa del correo electrónico, pulse Enviar vista previa de correo electrónico. Se enviará a la dirección de correo electrónico del usuario actual un mensaje de correo electrónico que utilizará los parámetros seleccionados.
  8. Pulse Guardar. La plantilla se añade a la página Plantillas de notificación.

Qué hacer a continuación

Añada la plantilla a un esquema de notificación o a una tarea de notificación.

Comentarios