Mensajes de Correo¶

Descripción General¶

Los mensajes de Correo se pueden enviar automáticamente en caso de éxito o fracaso de una operación. Los mensajes de Correo también se pueden configurar para que los use un destino de correo en una operación, o usado como argumento para el SendEmail función.

Crear un Mensaje de Correo¶

Siga estos pasos para crear y configurar un mensaje de correo que se enviará en caso de éxito o fracaso de una operación:

1. En el árbol del proyecto, haga clic con el botón derecho en el nodo Mensajes de Correo y, en el menú, seleccione Nuevo mensaje de Correo.

   La pestaña Nuevo mensaje de Correo aparece en el panel derecho:

   

2. Complete las propiedades del mensaje.

   Consejo

   Los campos Servidores de correo SMTP, Para, De, Asunto y Texto reconocen sustituciones de variables globales. Por ejemplo, si no sabe quién será el destinatario hasta el tiempo de ejecución, puede establecer una variable global llamada notify_email en la transformación (usando un DBLookup o con datos de entrada) y luego ingrese [notify_email] en el campo Hasta.

   • Nombre: (Obligatorio) El nombre del mensaje, que debe ser único dentro del proyecto.

   • Servidores de correo SMTP: Lista separada por comas de los servidores SMTP que se usarán para enviar el correo. Se probarán los servidores en el orden en que se especifican hasta que se encuentre uno que acepte el mensaje.

     Nota

     Para brindar compatibilidad con OAuth 2.0 con el correo de Microsoft 365, se pueden pasar parámetros adicionales en la cadena de alojar SMTP mediante el campo Servidores de correo SMTP. Para obtener instrucciones, consulte Soporte de OAuth 2 para Correo de Microsoft 365 abajo.

   • Para: (Obligatorio) Lista de destinatarios separados por comas.

   • De: La dirección de correo que aparecerá en el campo De cuando los destinatarios lean el correo.

   • Usar SSL/TLS: Seleccione para cifrar el correo usando el protocolo SSL/TLS.

   • Autenticación: Para usar la autenticación básica, expanda Autenticación y seleccione Usar autenticación. Luego puede ingresar una Cuenta y una Contraseña de la cuenta.

     Nota

     OAuth 2.0 es compatible con Microsoft 365 como se describe en Soporte de OAuth 2 para Correo de Microsoft 365 abajo.

   • Opcional: Expanda Opcional para mostrar campos opcionales adicionales:

     • CC: Lista de direcciones de correo separadas por comas para recibir una copia del mensaje.
     • BCC: Lista de direcciones de correo separadas por comas para recibir una copia oculta del mensaje.
     • Responder a: Una dirección de correo a la que desea que se envíen las respuestas (se usa de forma predeterminada cuando el destinatario responde en su aplicación de correo). Esto se puede usar si envía el correo desde una cuenta pero desea que las respuestas vayan a una cuenta de correo diferente.

   • Asunto: El asunto del correo.

   • Texto: El cuerpo del correo.

3. Haga clic en el icono Guardar en la barra de herramientas en la parte superior derecha para guardar el mensaje de correo.

4. En el árbol del proyecto, haga clic en operación al que desea agregar el mensaje de notificación.

   El gráfico de operación aparece en el panel de la derecha.

5. En el gráfico de operación, haga clic en en la parte superior del gráfico de operación para mostrar el menú de operación.

   1. En el menú, seleccione En caso de éxito> Correo > Seleccione existente o En caso de error> Correo > Seleccione existente.

   2. Una ventana emergente muestra la lista de mensajes de correo existentes. Seleccione el mensaje de correo creado en los pasos anteriores y haga clic en Aceptar.

6. El mensaje de correo se agregará al gráfico de operación:

   • Se muestra una línea verde y un icono para un mensaje de correo configurado para enviarse cuando la operación se realiza correctamente.
   • Se muestra una línea y un icono rojos para un mensaje de correo configurado para enviarse en caso de falla de la operación.

Compatibilidad con OAuth 2.0 para el Correo de Microsoft 365¶

Para usar OAuth 2.0 con el correo de Microsoft 365, proporcione parámetros adicionales en la cadena de alojar SMTP mediante el campo Servidores de correo SMTP. Estos parámetros adicionales son compatibles con Agentes en Nube 11.3 o posterior, 11.x Agentes Privados que tienen al menos la versión 11.1.1 y 10.x Agentes Privados que tienen al menos la versión 10.63.1.

Las propiedades en el campo Servidores de correo SMTP deben tener el siguiente formato:

<SMTP Host>?clientId=<Client ID>&tenant=<Tenant>&clientSecret=<Client Secret>

Estos parámetros opcionales adicionales también se pueden usar si es necesario para anular los valores predeterminados:

Entradas de ejemplo para el campo Servidores de correo SMTP usando OAuth 2.0:

smtp.office365.com?clientId=1234ab5c6d78e9f&tenant=abcdefgh-ij12-3456&clientSecret=Abc1-d2E3f-GhIjKlMn4-Opqrs_567

[email.server]?clientId=[clientId]&tenant=[tenant]&clientSecret=[clientSecret]&[scope]&urlEncoded=true

Parámetros Dinámicos¶

Palabras clave de nombre de archivo como [date] no funcionan en los campos Asunto o Texto.

Como alternativa, puede utilizar la función Jitterbit date. Para pasar una fecha como variable, puede crear una variable en un secuencia de comandos y asignarle un valor, y luego usarla en el mensaje de correo. Por ejemplo:

$date = Now();  # Gives the current date and time
$date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd");  # Gives just the date

Correos HTML¶

Puede usar HTML en el cuerpo del mensaje:

Variables (en este caso, una variable global email.html) se puede usar dentro de etiquetas HTML: