Saltar al contenido

Mensajes de correo electrónico en Jitterbit Design Studio

Descripción general

Los mensajes de correo electrónico se pueden enviar automáticamente al éxito o fracaso de una operación. Los mensajes de correo electrónico también se pueden configurar para ser utilizados por un destino de correo electrónico en una operación, o utilizados como un argumento para la función SendEmail.

Crear un mensaje de correo electrónico

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

  1. En el árbol del proyecto, haz clic derecho en el nodo Mensajes de Correo Electrónico y en el menú selecciona Nuevo Mensaje de Correo Electrónico.

    La pestaña Nuevo Mensaje de Correo Electrónico aparece en el panel derecho:

    attachment

  2. Completa 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 sabes quién será el destinatario hasta el momento de la ejecución, puedes establecer una variable global llamada notify_email en la transformación (usando un DBLookup o con datos de entrada) y luego ingresar [notify_email] en el campo Para.

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

    • Servidores de Correo SMTP: Lista separada por comas de servidores SMTP que se utilizarán para enviar el correo electrónico. Los servidores se probarán en el orden en que se especifican hasta que se encuentre uno que acepte el mensaje.

      Nota

      Para proporcionar soporte para OAuth 2.0 con correo electrónico de Microsoft 365, se pueden pasar parámetros adicionales en la cadena del host SMTP utilizando el campo Servidores de Correo SMTP. Para instrucciones, consulta Soporte de OAuth 2 para correo electrónico de Microsoft 365 a continuación.

    • Para: (Requerido) Lista separada por comas de destinatarios.

    • De: La dirección de correo electrónico que aparecerá en el campo De cuando el(los) destinatario(s) lean el correo electrónico.

    • Usar SSL/TLS: Selecciona para cifrar el correo electrónico utilizando el protocolo SSL/TLS. Esto es requerido para muchos servicios SMTP modernos, incluyendo el correo electrónico de Microsoft 365. Esta propiedad influye en el valor predeterminado del parámetro opcional starttls como se describe en Soporte de OAuth 2 para el correo electrónico de Microsoft 365 a continuación.

    • Autenticación: Para usar la autenticación básica o el tipo de concesión password con OAuth 2.0, expande Autenticación y selecciona Usar autenticación. Luego puedes ingresar una Cuenta y la Contraseña de la cuenta.

      Nota

      OAuth 2.0 es compatible con Microsoft 365 como se describe en Soporte de OAuth 2 para el correo electrónico de Microsoft 365 a continuación.

    • Opcional: Expande Opcional para mostrar campos adicionales opcionales:

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

    • Asunto: El asunto del correo electrónico.

    • Texto: El cuerpo del correo electrónico.

  3. Haz clic en el ícono de Guardar en la barra de herramientas en la parte superior derecha para guardar el mensaje de correo electrónico.

  4. En el árbol del proyecto, haz clic en la operación a la que deseas agregar el mensaje de notificación.

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

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

    1. Desde el menú, selecciona En Éxito > Correo Electrónico > Seleccionar Existente o En Fallo > Correo Electrónico > Seleccionar Existente.

    2. Una ventana emergente muestra la lista de mensajes de correo electrónico existentes. Selecciona el mensaje de correo electrónico creado en los pasos anteriores y haz clic en Aceptar.

  6. El mensaje de correo electrónico se añadirá al gráfico de la operación:

  7. Se muestra una línea y un ícono verdes para un mensaje de correo electrónico configurado para enviarse al tener éxito la operación.

  8. Se muestra una línea y un ícono rojos para un mensaje de correo electrónico configurado para enviarse al fallar la operación.

Soporte de OAuth 2.0 para correo electrónico de Microsoft 365

Para usar OAuth 2.0 con el correo electrónico de Microsoft 365, se deben proporcionar parámetros adicionales en la cadena del host SMTP utilizando el campo SMTP Mail Servers. Estos parámetros adicionales son compatibles con agentes en la nube 11.3 o posteriores, agentes privados 11.x que sean al menos versión 11.1.1, y agentes privados 10.x que sean al menos versión 10.63.1.

Importante

Se requiere la versión del agente 10.83 / 11.21 o posterior para usar el parámetro starttls. Configurar este parámetro en true es necesario para forzar tráfico seguro a través de puertos tradicionalmente inseguros como 25 cuando Use SSL/TLS está habilitado.

Las propiedades en el campo SMTP Mail Servers deben estar en el siguiente formato sensible a mayúsculas:

Formato del campo SMTP Mail Servers
<SMTP Host>?clientId=<Client ID>&tenant=<Tenant>&clientSecret=<Client Secret>
Parte Descripción
SMTP Host El servidor SMTP.
Client ID (clientId) El ID de cliente obtenido del proveedor de OAuth.
Tenant (tenant) El ID de inquilino obtenido del proveedor de OAuth.
Client Secret (clientSecret) El ID de inquilino obtenido del proveedor de OAuth.

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

Parte Descripción
Port (port) Predeterminado: 587. El puerto SMTP.
STARTTLS (starttls) Predeterminado: false si Use SSL/TLS está habilitado, de lo contrario true. Configurar en true para forzar tráfico seguro a través de puertos tradicionalmente inseguros como 25 cuando Use SSL/TLS está habilitado. Se requieren agentes versión 10.83 / 11.21 o posteriores para usar este parámetro.
URL Encoding (urlEncoded) Predeterminado: false. Configurar en true si los valores necesitan ser codificados en URL.
Scope (scope) Predeterminado: https://outlook.office365.com/.default.
Token (tokenEndpoint) Predeterminado: https://login.microsoftonline.com/ + tenant + /oauth2/v2.0/token.
Grant Type (grantType) Predeterminado: password. Usar password con autenticación básica o OAuth 2.0 cuando Use authentication está habilitado bajo Authentication con una Account válida y Password de cuenta. Usar client_credentials con OAuth 2.0 si password no es aplicable.

Ejemplos de entradas para el campo Servidores de Correo SMTP utilizando OAuth 2.0:

Ejemplo 1 (Codificado en duro)
smtp.office365.com?clientId=1234ab5c6d78e9f&tenant=abcdefgh-ij12-3456&clientSecret=Abc1-d2E3f-GhIjKlMn4-Opqrs_567&port=25&starttls=true
Ejemplo 2 (Usando Variables, Alcance y Codificación de URL)
[email.server]?clientId=[clientId]&tenant=[tenant]&clientSecret=[clientSecret]&[scope]&urlEncoded=true

Parámetros dinámicos

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

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

$date = Now();  # Da la fecha y hora actuales
$date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd");  # Da solo la fecha

Correos electrónicos en HTML

Se puede usar HTML en el cuerpo del mensaje:

attachment

Las variables (en este caso, una variable global email.html) se pueden usar dentro de las etiquetas HTML:

attachment