Notificaciones por correo electrónico en Jitterbit Integration Studio

Introducción

Las notificaciones configuradas en Integration Studio se activan por una acción de operación o se inician desde un script. Las notificaciones por correo electrónico se pueden utilizar para enviar automáticamente un correo electrónico sobre el éxito o fracaso de una operación o al llamar a un script.

Si en cambio deseas configurar una notificación por correo electrónico que se active cuando un agente privado se caiga o tu contraseña de Harmony esté a punto de expirar, consulta Alertas.

Para otras formas de configurar notificaciones por correo electrónico en Integration Studio, consulta Formas de enviar correos electrónicos.

Crear o editar una notificación por correo electrónico

Las notificaciones por correo electrónico se pueden crear o editar desde el panel del proyecto, la configuración de la operación o un script.

Las nuevas notificaciones por correo electrónico se crean con el nombre predeterminado Nueva Notificación de Correo. Las notificaciones nuevas subsiguientes con nombres predeterminados se les añade un número incrementado entre paréntesis.

Después de crear una notificación por correo electrónico o abrir una notificación existente para editar, consulta Configurar una notificación por correo electrónico más adelante en esta página para la configuración.

Panel del proyecto

Se puede crear una nueva notificación por correo electrónico desde la pestaña Componentes del panel del proyecto utilizando la opción Crear Nuevo en la categoría Correos Electrónicos (consulta Menú de acciones de la pestaña Componentes en Pestaña Componentes del panel del proyecto).

Una notificación existente se puede editar desde la pestaña Componentes del panel del proyecto utilizando la opción Ver/Editar en un componente de notificación por correo electrónico (consulta Menú de acciones del componente en Pestaña Componentes del panel del proyecto).

Configuración de la operación

También puedes crear o editar notificaciones por correo electrónico desde la pestaña Acciones de la Configuración de la operación, a la que se puede acceder desde estas ubicaciones:

• La pestaña Flujos de trabajo del panel del proyecto (ver Menú de acciones del componente en Pestaña Flujos de trabajo del panel del proyecto).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña Componentes del panel del proyecto).
• El lienzo de diseño (ver Menú de acciones del componente en Lienzo de diseño).

Una vez que la pantalla de Configuración de la operación esté abierta, selecciona la pestaña Acciones. Selecciona la Condición, y para la Acción selecciona Enviar notificación por correo electrónico. Para crear una nueva notificación por correo electrónico, haz clic en el enlace para Crear nueva notificación por correo electrónico para abrir la pantalla de configuración de notificaciones por correo electrónico:

Para editar una notificación por correo electrónico existente, asegúrate de tener seleccionada Enviar notificación por correo electrónico como la Acción. Luego, en el menú desplegable de Notificación por correo electrónico, pasa el cursor sobre la notificación existente y haz clic en el ícono de edición para abrir la pantalla de configuración de notificaciones por correo electrónico.

Script

Es posible que desees utilizar un script que se pueda configurar en la operación para incluir lógica avanzada sobre cuándo enviar la notificación por correo electrónico. Por ejemplo, para verificar un código específico o un estado de error, podrías usar un script para proporcionar más control sobre lo que sucede cuando tienes un error.

Dentro del editor de scripts, abre la pestaña de Notificaciones del paleta de componentes de script.

Para crear una nueva notificación por correo electrónico, haz clic en Agregar nuevo.

Para editar una notificación existente, haz clic en el nombre de la notificación.

Menú de acciones de notificaciones por correo electrónico

Después de crear una notificación por correo electrónico, las acciones del menú para esa notificación son accesibles desde la pestaña Componentes del panel del proyecto (ver Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).

Cada una de estas acciones del menú está disponible:

Elemento del menú	Descripción
	Ver/Editar abre la pantalla de configuración de la notificación por correo electrónico para que configures la notificación. Para más detalles, consulta Configurar una notificación por correo electrónico más adelante en esta página.
	Cortar coloca una copia de la notificación por correo electrónico en tu portapapeles y elimina la notificación original del proyecto (ver Reutilización de componentes).
	Copiar coloca una copia de la notificación por correo electrónico en tu portapapeles (ver Reutilización de componentes).
	Duplicar crea una nueva notificación por correo electrónico no referenciada utilizando la misma configuración que la notificación original (ver Reutilización de componentes).
	Renombrar posiciona el cursor en el nombre de la notificación por correo electrónico para que realices las ediciones necesarias.
	Ver dependencias cambia la vista en el panel del proyecto para mostrar cualquier otra parte del proyecto de la que dependa la notificación por correo electrónico (ver Dependencias de componentes, eliminación y remoción).
	Agregar a grupo abre un diálogo para crear un nuevo grupo personalizado o para agregar la notificación por correo electrónico a un grupo existente (ver Grupos de componentes).
	Eliminar elimina permanentemente la notificación por correo electrónico (ver Dependencias de componentes, eliminación y remoción).
	Eliminar quita las referencias a la notificación por correo electrónico que están configuradas con una acción de operación en el lienzo de diseño (ver Dependencias de componentes, eliminación y remoción).

Configurar una notificación por correo electrónico

Esta sección cubre la configuración de una notificación por correo electrónico. Una vez hecho esto, se puede configurar un correo electrónico para que se envíe en caso de éxito o fallo de una operación (ver Acciones de operación) o agregar la notificación a un script (ver Tipos de script y creación).

Cuando se crea una nueva notificación por correo electrónico o se edita una existente, se abre la pantalla de configuración de la notificación por correo electrónico:

• Nombre de la notificación por correo electrónico: Ingresa un nombre para la notificación por correo electrónico. El nombre debe ser único para cada notificación por correo electrónico y no debe contener barras diagonales (/) ni dos puntos (:).

• Servidor(es) de correo electrónico SMTP: Ingresa al menos un servidor SMTP que desees utilizar para enviar el correo electrónico. Si ingresas múltiples servidores SMTP, usa una coma para separar cada uno. Los servidores se prueban en el orden en que se especifican hasta que se encuentra uno que acepte el mensaje.

• Dirección(es) de correo electrónico para: Ingresa al menos una dirección de correo electrónico para recibir el correo. Si ingresas múltiples destinatarios, usa una coma para separar cada uno.

  Consejo

  Si no sabes quiénes son los destinatarios hasta después de haber ejecutado una operación, puedes definir y usar una variable global. Por ejemplo, una variable global [notify_email] podría usar valores devueltos por la función DBLookup para buscar la(s) dirección(es) de correo electrónico.

• Desde la dirección de correo electrónico: Ingresa la dirección de correo electrónico que deseas que aparezca como remitente cuando el(los) destinatario(s) lean el correo.

• Configuraciones opcionales: Haz clic para expandir configuraciones opcionales adicionales:

  

  • Usar SSL/TLS: Selecciona la casilla para cifrar el correo utilizando el protocolo SSL/TLS.

  • Dirección(es) de correo electrónico CC: Ingresa una o más direcciones de correo electrónico para recibir una copia del correo. Si ingresas múltiples destinatarios en copia, usa una coma para separar cada uno.

  • Dirección(es) de correo electrónico BCC: Ingresa una o más direcciones de correo electrónico para recibir una copia oculta del correo. Si ingresas múltiples destinatarios en copia oculta, usa una coma para separar cada uno.

  • Responder a la dirección de correo electrónico: Ingresa la dirección de correo electrónico a la que deseas que se envíen las respuestas por defecto. Esto puede ser útil si envías el correo desde una cuenta común pero deseas que las respuestas vayan a una cuenta de correo personal.

  • Usar autenticación: Selecciona la casilla si el servidor SMTP requiere autenticación. Al seleccionar esta opción, los campos Cuenta y Contraseña a continuación se habilitan para que ingreses tus credenciales de autenticación.

    

• Asunto y Mensaje: Ingresa el asunto y el cuerpo que se utilizarán para el correo. Para usar variables globales, variables de proyecto o variables de Jitterbit en el Mensaje, ingrésalas manualmente o comienza escribiendo un corchete cuadrado abierto [ en el campo para mostrar una lista de variables existentes de las que elegir.

  Nota

  Las palabras clave del nombre de archivo como [date] no funcionan en los campos de Asunto o Mensaje si no están primero definidas como variables globales. Para usar funciones de fecha y hora para poblar una variable global, puedes hacerlo dentro de un script. Por ejemplo:

  // This sets the global variable equal to the current date and time
  $date = Now()
  // This sets the global variable equal to just the date
  $date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd")
  

  Consejo

  Puedes usar HTML en el Mensaje. Las variables se pueden usar dentro de las etiquetas HTML utilizando corchetes, como se demuestra con la variable email_address a continuación:

  <html>
  <head>
  <title>Page Title</title>
  </head>
  <body>
  <h1>This Is a Heading</h1>
  <p>This is a paragraph.</p>
  <p>[Visit our HTML tutorial.](https://www.example.com/html/message/)</p>
  <p>Send me an email at [email_address].</p>
  </body>
  </html>
  

• Prueba: Haz clic para enviar un correo electrónico de prueba utilizando la configuración. Se recomienda enviar un correo electrónico de prueba para asegurar que la configuración funcione correctamente y como se espera. Si se utilizan variables en la configuración, es posible que debas especificar un valor predeterminado para usar con fines de prueba (ver Variables).

• Guardar: Haz clic para guardar y cerrar la configuración de notificación por correo electrónico.

• Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios. Un mensaje te pide que confirmes que deseas descartar los cambios.

Agregar una notificación por correo electrónico a una operación o script

Enviar una notificación por correo electrónico se puede agregar a una operación como una acción a realizar en caso de éxito o fracaso de la operación, o se puede agregar a un script para ejecutarse utilizando lógica avanzada sobre cuándo enviar el correo electrónico. Esto se configura desde la configuración de la operación o desde dentro de un script.

Configuración de la operación

Abre la configuración de la operación para una operación existente y selecciona la pestaña Acciones. Luego configura la acción de la operación de la siguiente manera:

1. En el primer menú desplegable, selecciona la condición apropiada de la operación que debería activar la acción (En Éxito o En Fallo).
2. En el segundo menú desplegable, selecciona Enviar Correo Electrónico.
3. En el tercer menú desplegable, selecciona la notificación por correo electrónico configurada.
4. Haz clic en Agregar Acción para añadir la notificación por correo electrónico a la operación.

Para una explicación más detallada de las opciones, consulta Acciones de operación.

Las notificaciones por correo electrónico vinculadas se muestran directamente en el lienzo de diseño conectadas a la operación con la que están asociadas:

Script

Dentro de un script escrito en Jitterbit Script, abre la pestaña de Notificaciones del panel de componentes del script.

Para agregar una notificación y la función necesaria para ejecutarla, utiliza la función SendEmailMessage y la referencia de notificación como un argumento de función. Para más detalles, consulta Notificaciones en Jitterbit Script.