Saltar al contenido principal
Documentación
Documentación
Administrator Guide
Última actualización: 2023-06-23
Referencia: propiedades de transporte del componente email-out

Referencia: propiedades de transporte del componente email-out

Ficha Common

Propiedad
Nombre de atributo XML
Descripción
ID
id
El ID exclusivo del componente
de envío por correo electrónico
 en el conjunto.
Envío de respuesta a
routes-response-to
El destino del mensaje de respuesta para el transporte
de envío por correo electrónico
 .
Ejecutar cuando
execute-when
Una condición que determina si se ejecuta el transporte.
Hasta
to
La dirección de correo electrónico principal del destinatario previsto. Sigue el formato
mailto:[emailaddress]
.
Si desea utilizar solo direcciones CCO, especifique un valor vacío.
mailto:
 valor
Asunto
subject
La línea de asunto del correo electrónico.
Desde
from
La dirección de correo electrónico que debe mostrarse en el campo
De
 del correo electrónico enviado.
Ssl
ssl
Especifica si la conexión es SSL.
Starttls
starttls
Especifica si se activa una negociación SSL inmediata con el servidor SMTP remoto emitiendo un comando STARTTLS antes de iniciar la sesión SMTP. El servidor SMTP responde con uno de los siguientes códigos de respuesta:
  • 220 El servidor está listo para la sesión SMTP.
  • TLS 501 Error de sintaxis (no se permiten parámetros).
  • 454 TLS no disponible por un motivo temporal.
Las propiedades
SSL
 y
STARTTLS
 se excluyen mutuamente.
Anfitrión
host
El nombre o la dirección IP del servidor de correo SMTP que utiliza el transporte para entregar el mensaje.
Si utiliza OAuth, defina este valor como
localhost
.
Puerto
port
El número de puerto en el que se ejecuta el servidor de correo. El valor por defecto es 25, que es el puerto SMTP estándar. Excepciones:
  • Si la propiedad
    SSL
     se establece en
    true
     y no se especifica ningún puerto, el valor por defecto es 465.
  • Si la propiedad
    Starttls
     se establece en
    true
     y no se especifica ningún puerto, el valor por defecto es 587.
Usuario
El nombre de usuario para acceder al servidor de correo electrónico.
Contraseña
password
La contraseña del nombre de usuario especificado en la propiedad
User
 .

Ficha Advanced

Propiedad
Nombre de atributo XML
Descripción
Almacenar mensaje
store-message
No especifique
ninguno,
 a menos que el servicio de asistencia de Workday le indique lo contrario.
Para almacenar mensajes, utilice el paso
store
 de Studio.
Clase de transporte
transport-class
Especifica una clase de implementación alternativa por ensamblaje, si es necesario.
Puede cambiar las clases de implementación de forma global al editar el archivo WEB-INF/classes/spring/assembly-bean.xml.
Ignorar puntos finales dinámicos
ignore-dynamic-endpoints
Especifica si se ignora el valor dinámico de WS-Addressing (WSA) en la cabecera del mensaje entrante o se utiliza para sustituir el valor de la propiedad
Punto final
 del transporte.
Utilice el paso
set-dynamic-endpoint
 para especificar los detalles de WS-Addressing.
Bcc
bcc
Especifica los destinatarios de correo electrónico con copia oculta, utilizando un separador de punto y coma. Ejemplo:
logan.mcneil@workday.com; jake.lee@workday.com
.
Cc
cc
Especifica los destinatarios del correo electrónico con copia al carbón, utilizando un separador de punto y coma. Ejemplo:
logan.mcneil@workday.com; jake.lee@workday.com
.
Destinatario
reply-to
La dirección de correo electrónico que se inserta automáticamente en el campo
Para
 cuando un usuario responde a un mensaje de correo electrónico. Para la mayoría de los mensajes de correo electrónico, la dirección en el campo
De
 es suficiente, por lo que no hace falta definir la propiedad
Destinatario
. Especifique varias direcciones de correo electrónico mediante un punto y coma. Ejemplo:
logan.mcneil@workday.com; jake.lee@workday.com
.
Tiempo de espera
timeout
Especifica, en milisegundos, un periodo de tiempo de espera para las sesiones FTP entre clientes y el servidor FTP en el que está a la escucha el transporte. Si no especifica ningún valor, se agotará el tiempo de espera de la sesión pasados los 300 000 milisegundos (5 minutos).
Excepciones transitorias
transient-exceptions
Las excepciones transitorias son excepciones que podrían realizarse correctamente sin modificaciones al reintentar. Las excepciones no transitorias son aquellas que seguirán fallando al reintentar hasta que se corrija la causa subyacente del problema.
Por defecto, Workday solo trata
java.net.ConnectException
 y
java.net.SocketException
 errores como excepciones transitorias.
Especifique excepciones transitorias adicionales como una coma, un espacio o una enumeración de nombres de clase separados por comas y espacios. Ejemplos:
  • java.net.UknownHostException java.net.ConnectException java.net.SocketException
  • java.net.UknownHostException,java.net.ConnectException,java.net.SocketException
  • java.net.UknownHostException, java.net.ConnectException, java.net.SocketException
  • @{new java.net.UnknownHostException().getClass().getName()}
Si especifica excepciones transitorias adicionales, también debe incluir las excepciones por defecto
java.net.ConnectException
 y
java.net.SocketException
 en la lista Si no lo hace, Workday los sobrescribe.

Ficha de cabeceras SMTP

Propiedad
Nombre de atributo XML
Descripción
Nombre
name
El nombre de una cabecera SMTP personalizada.
Para añadir una nueva cabecera personalizada debajo de cualquier fila existente, haga clic en
Añadir
 y, a continuación, introduzca un
Nombre
 y un
Valor
.
Para añadir una nueva cabecera encima de una fila existente, coloque el cursor en esa fila y, a continuación, haga clic en
Insertar
 en el menú desplegable
Añadir
.
Utilice los botones a la derecha de la ficha
SMTP Headers
 para eliminar filas o reordenarlas.
Valor
value
El valor de una cabecera SMTP personalizada.

Ficha OAuth

Para usar la autenticación OAuth de Microsoft Outlook con el componente de envío por correo electrónico de Studio, registre Studio como una aplicación con Microsoft Azure, proporcione delegación en todo el dominio, otorgue el consentimiento del administrador para
Mail.Send
 permisos y obtener varios valores. Para obtener más información, consulte https://learn.microsoft.com/en-gb/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow.
Para utilizar la autenticación OAuth de Google Gmail con el componente Email-Out de Studio, registre una cuenta de servicio en Google Cloud, proporcione una delegación en todo el dominio y obtenga una descripción JSON de varios valores. Para obtener más información, consulte https://support.google.com/cloud/answer/6158849?hl=en.
Propiedad
Nombre de atributo XML
Descripción
Proveedor
provider
El nombre del proveedor de correo electrónico, ya sea
MICROSOFT_OUTLOOK
 o
GOOGLE_GMAIL
.
Nombre
name
Los nombres obligatorios de Workday que asocia con varios valores obtenidos de Microsoft Azure Portal o Google Cloud Console.
En Microsoft Outlook, introduzca los siguientes nombres:
  • outlook.client.id
  • outlook.client.secret
  • outlook.tenant.id
  • outlook.user.id
En Google Gmail, introduzca lo siguiente:
  • gmail.service.account.key.json
  • gmail.delegated.user
Valor
value
Los valores obtenidos de Microsoft o Google que asocia con los nombres anteriores.
En Microsoft Outlook, cree estos pares de nombre/valor:
Nombre
Valor
outlook.client.id
Desde la página
Overview
 de una aplicación registrada en el portal de Microsoft Azure:
ID de aplicación (cliente).
outlook.client.secret
Desde la página
Certificates & secrets
 de una aplicación registrada en el portal de Microsoft Azure:
ID de clave secreta de cliente.
outlook.tenant.id
Desde la página
Overview
 de una aplicación registrada en el portal de Microsoft Azure:
ID de directorio (entorno de cliente).
outlook.user.id
La dirección de Outlook de la cuenta desde la que se enviará el correo electrónico. También se introduce en el campo
De
 de la ficha
Común
.
En Google Gmail, cree estos pares de nombre/valor:
Nombre
Valor
gmail.service.account.key.json
El texto en formato JSON del archivo descargado de la sección
KEYS
 de la página
Service accounts
 en Google Cloud Console.
gmail.delegated.user
La dirección de Gmail desde la que se enviará el correo electrónico. Debe ser una dirección principal asociada a Google Service Account. También se introduce en el campo
De
 de la ficha
Común
.

Configuración de Gmail con SSL o STARTTLS

Al configurar el transporte
email-out
 para utilizar Gmail con SSL o STARTTLS, asegúrese de que:
  • El usuario
     y
    la contraseña
     contienen credenciales de Gmail válidas.
  • el punto final
     es
    mailto:[name]@gmail.com
    .
  • el host
     es
    smtp.gmail.com
    .
  • SSL
     o
    starttls
     se establece en
    true
    .
  • el puerto
     es:
    • 465, si
      SSL
       está definido como
      true
      .
    • 587, si
      starttls
       se establece en
      true
      .
  • el tiempo de espera
     es
    30000
     (30 segundos).

Microsoft Office 365 a través de SSL o con STARTTLS

Al configurar el transporte
email-out
 para utilizar Microsoft Office 365 con SSL o STARTTLS, asegúrese de que:
  • El usuario
     y
    la contraseña
     contienen credenciales de usuario de Office 365 válidas.
  • el punto final
     es
    mailto:[name]@[domain-name.top-level-domain]
    .
  • el host
     es
    smtp.office365.com
    .
  • SSL
     o
    starttls
     se establece en
    true
    .
  • puerto
     :
    • 465, si
      SSL
       está definido como
      true
      .
    • 587, si
      starttls
       se establece en
      true
      .
  • el tiempo de espera
     es
    30000
     (30 segundos).

Configuración de cuerpo de mensaje y archivo adjunto para formatos no binarios

Al recibir mensajes entrantes, muchas aplicaciones de correo electrónico cotejan la primera parte de texto del mensaje MIME y la utilizan como texto del mensaje. Para definir el tipo MIME de la parte del mensaje raíz en
text/plain
, defina las propiedades
de Entrada
 y
Salida
 del mensaje como
mensaje
y, a continuación, defina el Tipo MIME
de salida
 como
text/plain
.
Utilice el
Generador de mensajes
 para definir el contenido del mensaje para el cuerpo del mensaje de correo electrónico mediante un elemento
de texto
 .
Para el archivo adjunto, establezca la propiedad
Resultado
 en
archivo adjunto
, el índice de archivo adjunto
de salida
 en
0
y el Tipo MIME
de salida
 en
text/plain
.
De nuevo, utilice el
Generador de mensajes
 para definir el contenido del mensaje del archivo adjunto mediante un elemento
de texto
 .
Para evitar que algunas aplicaciones de correo electrónico muestren archivos adjuntos de texto en el cuerpo de mensaje, defina el tipo MIME del archivo adjunto como
application/octet-stream
, aunque en realidad sea texto. Para ello, utilice una expresión MVEL en un paso
de evaluación
 . Ejemplo:
parts[1].setMimeType('application/octet-stream')
Para definir el nombre del archivo adjunto, utilice una expresión MVEL para definir su
Content-Disposition
 cabecera. Ejemplo:
parts[1].setHeader('Content-Disposition', 'attachment; filename=payload.txt')
.
Por último, configure el paso
de envío por correo electrónico
 .

Configuración del cuerpo de mensaje y el archivo adjunto para formatos binarios

Para insertar un archivo binario en
MediationContext
, defina un servicio de recuperación para
workday-in
 que recupere el archivo de un transporte FTP o SFTP.
Cree el cuerpo de mensaje y, a continuación, utilice un paso
eval
 para copiar el archivo recuperado en una variable. Puede utilizar la variable de acceso al documento
da
 y el método
toVar
 para lograrlo. Ejemplo:
da.toVar(Rising_2011_Logo.jpg', 'wd.retrieve.variable')
.
Utilice un paso
de copia
 para copiar el archivo de la
wd.retrieve.variable
 a un archivo adjunto. Para ello, defina la propiedad
Entrada
 como
variable
 y especifique
wd.retrieve.variable
 como variable de entrada. Establezca la propiedad
Resultado
 en
archivo adjunto
, especifique un Índice de archivo adjunto
de resultado
 de
0
y un Tipo MIME
de salida
 de
image/jpeg
.
Por último, configure el paso
de envío por correo electrónico
 .