Référence : propriétés de transport Email-Out

Onglet Common

Propriété	Nom de l’attribut de la version XML	Description
Identifiant	id	L’identifiant unique de la composante de sortie de courriel au sein de l’ensemble.
Achemine la réponse à	routes-response-to	La destination du message de réponse pour le transport de sortie de courriels .
Exécuter quand	execute-when	Condition qui détermine si le transport est exécuté.
À	to	L’adresse de courriel principale du destinataire prévu. Respecte le format mailto:[emailaddress] . Si vous ne voulez utiliser que des adresses BCC, indiquez un champ vide. mailto: valeur.
Objet	subject	L’objet du courriel.
De	from	L'adresse de courriel qui doit s'afficher dans le champ De du courriel livré.
SSL	ssl	Indique si la connexion est SSL.
Dates de début	starttls	Précise s'il faut activer une négociation SSL immédiate avec le serveur SMTP distant en émettant une commande start pris en charge avant le démarrage de la session SMTP. Le serveur SMTP répond avec l’un des codes de réponse suivants : 220 Ready to start. TLS 501 Syntax error (no parameters allowed). 454 TLS not available due to a temporary reason. Les propriétés SSL et STARTTLS s’excluent mutuellement.
Hôte	host	Nom ou adresse IP du serveur de messagerie SMTP utilisé par le transport pour livrer le message. Si vous utilisez OAuth, définissez cette valeur sur localhost .
Port	port	Numéro de port sur lequel s'exécute le serveur de messagerie. La valeur par défaut est 25, le port SMTP standard. Exceptions : Si la propriété SSL est définie à true et qu'aucun port n'est précisé, la valeur par défaut est 465. Si la propriété Starttls est définie à true et qu’aucun port n’est précisé, la valeur par défaut est 587.
Utilisateur		Le nom d’utilisateur pour accéder au serveur de courriel.
Mot de passe	password	Le mot de passe du nom d’utilisateur indiqué dans la propriété Utilisateur .

Onglet Avanced

Propriété	Nom de l’attribut de la version XML	Description
Message de magasin	store-message	Préciser aucune valeur , sauf avis contraire du service de soutien de Workday. Pour stocker les messages, utilisez l’étape store de Studio.
Classe de transport	transport-class	Indique une autre classe de mise en œuvre par agrégat, si nécessaire. Vous pouvez changer les classes de mise en œuvre de manière globale en modifiant le fichier WEB-INF/classes/spring/assembly-bean.xml.
Ignorer les points de terminaison dynamiques	ignore-dynamic-endpoints	Indique s'il faut ignorer la valeur dynamique WS-Addressing (WSA) dans l'en-tête du message entrant ou l'utiliser pour remplacer la valeur dans la propriété Endpoint du transport. Utilisez l’étape set-dynamic-endpoint pour préciser les détails d’adressage des services Web.
Cci	bcc	Indique les destinataires des courriels en copie normale, en utilisant un séparateur de points-virgules. Exemple : logan.mcneil@workday.com; jake.lee@workday.com .
Cc	cc	Indique les destinataires des courriels en copie papier, à l’aide d’un séparateur de points-virgules. Exemple : logan.mcneil@workday.com; jake.lee@workday.com .
Répondre à	reply-to	L’adresse de courriel qui est automatiquement insérée dans le champ À quand un utilisateur répond à un message par courriel. Pour la plupart des courriels, l’adresse dans le champ From est suffisante, il n’est donc pas nécessaire de définir la propriété Reply To . Indiquez plusieurs adresses de courriel à l'aide d'un séparateur de points-virgules. Exemple : logan.mcneil@workday.com; jake.lee@workday.com .
Expiration	timeout	Indique, en millisecondes, la période d'expiration des sessions FTP entre les clients et le serveur FTP sur lequel le transport est à l'écoute. Si vous ne précisez aucune valeur, la session expirera après 300 000 ms (5 minutes).
Exceptions transitoires	transient-exceptions	Les exceptions transitoires sont des exceptions qui pourraient réussir sans modification au moment de réessayer. Les exceptions non transitoires sont celles qui continueront d’échouer à la nouvelle tentative jusqu’à ce que la cause sous-jacente du problème soit corrigée. Par défaut, Workday traite uniquement java.net.ConnectException et java.net.SocketException erreurs comme exceptions transitoires. Indiquez des exceptions transitoires supplémentaires sous forme d'énumération des noms de classes séparées par des virgules, des espaces ou des virgules. Exemples : 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 vous précisez des exceptions transitoires supplémentaires, vous devez également inclure les exceptions par défaut. java.net.ConnectException et java.net.SocketException sont dans la liste. Si vous ne le faites pas, Workday les remplace.

Onglet SMTP Headers

Propriété	Nom de l’attribut de la version XML	Description
Nom	name	Le nom d'un en-tête SMTP personnalisé. Pour ajouter un nouvel en-tête personnalisé sous des rangées existantes, cliquez sur Add , puis entrez Name et Value . Pour ajouter un nouvel en-tête au-dessus d’une rangée existante, placez le curseur dans la rangée en question, puis cliquez sur Insert dans le menu déroulant Add . Utilisez les boutons à droite de l’onglet SMTP Headers pour supprimer des rangées ou les réorganiser.
Valeur	value	La valeur d'un en-tête SMTP personnalisé.

Onglet OAuth

Pour utiliser l'authentification OAuth de Microsoft Outlook avec la composante de sortie de courriel de Studio, enregistrez Studio en tant qu'application avec Microsoft Azure, fournissez une délégation à l'échelle du domaine, accordez le consentement de l'administrateur pour

Mail.Send

autorisations et obtenir différentes valeurs. Pour plus de détails, voir https://learn.microsoft.com/en-gb/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow.

Pour utiliser l’authentification OAuth de Google Gmail avec la composante Email-Out de Studio, enregistrez un compte de service auprès de Google Cloud, fournissez une délégation à l’échelle du domaine et obtenez une description JSON des différentes valeurs. Pour plus de détails, voir https://support.google.com/cloud/answer/6158849?hl=en.

Propriété

Nom de l’attribut de la version XML

Description

Fournisseur

provider

Le nom du fournisseur de courriel, soit

MICROSOFT_OUTLOOK

ou

GOOGLE_GMAIL

.

Nom

name

Les noms obligatoires de Workday que vous associez à diverses valeurs obtenues à partir du portail Microsoft Azure ou de la console Google Cloud.

Pour Microsoft Outlook, entrez les noms suivants :

Outlook.client.id

outlook.client.secret

Outlook.tenant.id

Outlook.user.id

Pour Google Gmail, entrez :

gmail.service.account.key.json

gmail.delegated.user

Valeur

value

Les valeurs obtenues à partir de Microsoft ou de Google que vous associez aux noms ci-dessus.

Pour Microsoft Outlook, créez les paires nom/valeur suivantes :

Nom	Valeur
Outlook.client.id	À partir de la page Overview d’une application enregistrée sur le portail Microsoft Azure : Identifiant d’application (client).
outlook.client.secret	À partir de la page Certificates & secrets d’une application enregistrée sur le portail Microsoft Azure : Identifiant de clé secrète client.
Outlook.tenant.id	À partir de la page Overview d’une application enregistrée sur le portail Microsoft Azure : Identifiant du répertoire (locataire).
Outlook.user.id	L’adresse Outlook du compte à partir duquel le courriel sera envoyé. Également entrée dans le champ From de l’onglet Common .

Pour Google Gmail, créez les paires nom/valeur suivantes :

Nom	Valeur
gmail.service.account.key.json	Le texte JSON du fichier téléchargé à partir de la section KEYS de la page Service accounts dans Google Cloud Console.
gmail.delegated.user	L’adresse Gmail à partir de laquelle le courriel sera envoyé. Il doit s’agir d’un utilisateur principal associé au compte de service Google. Également entrée dans le champ From de l’onglet Common .

Gmail sur SSL ou avec STARTTLS

Quand vous configurez le transport

email-out

pour utiliser Gmail sur SSL ou STARTTLS, assurez-vous que :

L'utilisateur

et

le mot de passe

contiennent des données d'identification Gmail valides.

point de terminaison

est

mailto:[name]@gmail.com

.

l'hôte

est

smtp.gmail.com

.

ssl

ou

startls

est défini à

true

.

Le port

est soit :

465, si

SSL

est défini à

true

.

587, si

startls

est défini à

true

.

Le délai d'expiration

est

30000

(30 secondes).

Microsoft Office 365 sur SSL ou avec START candidats

Quand vous configurez le transport

email-out

pour utiliser Microsoft Office 365 sur SSL ou STARTTLS, assurez-vous que :

l'utilisateur

et

le mot de passe

contiennent des données d'identification de l'utilisateur Office 365 valides.

point de terminaison

est

mailto:[name]@[domain-name.top-level-domain]

.

l'hôte

est

smtp.office365.com

.

ssl

ou

startls

est défini à

true

.

portez l’

une ou l’autre des options suivantes :

465, si

SSL

est défini à

true

.

587, si

startls

est défini à

vrai

.

Le délai d'expiration

est

30000

(30 secondes).

Configurer le corps du message et la pièce jointe pour les formats non binaires

Lors de la réception de messages entrants, de nombreuses applications de courriel correspondent à la première partie de texte du message MIME et l’utilisent comme texte du message. Pour définir le type MIME de la partie racine du message à

text/plain

, définissez les propriétés

de l'entrée

et

de la sortie

du message à message
, puis définissez le type

de sortie

MIME à text/ Affecter l'objet de gestion
.

Utilisez le

créateur de messages

pour définir le contenu du message pour le corps du message à l’aide d’un élément

de texte

.

Pour la pièce jointe, définissez la propriété

Output

sur pièce jointe
, et l'index de pièces jointes

de sortie

sur

0

et le type

de sortie

MIME à text/ Affecter l'objet de type
.

Utilisez de nouveau le

Créateur de messages

pour définir le contenu du message pour la pièce jointe à l’aide d’un élément

de texte

.

Pour empêcher certaines applications de courriel d’afficher des pièces jointes dans le corps du message, définissez le type MIME de la pièce jointe sur application/octet-stream
, même s’il s’agit de texte. Pour ce faire, utilisez une expression MVEL dans une étape

d’évaluation

. Exemple :

parts[1].setMimeType('application/octet-stream')

Pour définir le nom du fichier joint, utilisez une expression MVEL pour en définir le nom.

Content-Disposition

en-tête. Exemple :

parts[1].setHeader('Content-Disposition', 'attachment; filename=payload.txt')

.

Configurez ensuite l’étape

d’envoi par courriel

.

Configuration du corps du message et de la pièce jointe pour les formats binaires

Pour injecter un fichier binaire dans

MediationContext

, définissez un service de récupération pour

workday-in

qui récupère le fichier à partir d’un transport FTP ou SFTP.

Créez le corps du message, puis utilisez une étape

eval

pour copier le fichier extrait dans une variable. Pour ce faire, vous pouvez utiliser la variable d’accéder au document

da

et la méthode

toVar

. Exemple :

da.toVar(Rising_2011_Logo.jpg', 'wd.retrieve.variable')

.

Utilisez une étape

de copie

pour copier le fichier à partir du

wd.retrieve.variable

à une pièce jointe. Pour ce faire, définissez la propriété

Input

comme variable
et précisez

wd.retrieve.variable

comme variable d'entrée. Définissez la propriété

de sortie

sur la pièce jointe
, précisez un index de pièce jointe

de sortie

de

0

et un type

de sortie

MIME de image/jpeg
.

Configurez ensuite l’étape

d’envoi par courriel

.