Passer au contenu principal
Documentation
Documentation
Administrator Guide
Dernière mise à jour : 2023-06-23
Référence : propriétés du transport email-out

Référence : propriétés du transport email-out

Onglet Valeurs usuelles

Propriété
Nom de l'attribut XML
Description
Identifiant
id
Identifiant unique du composant
email-out
 dans l'assemblage.
Routes Response To
routes-response-to
Destination du message de réponse pour le transport
email-out
.
Execute When
execute-when
Condition qui détermine si le transport s'exécute.
À
to
Adresse e-mail principale du destinataire prévu. Respecte le format
mailto:[emailaddress]
.
Si vous souhaitez utiliser uniquement des adresses BCC, indiquez un champ
mailto:
 valeur.
Objet
subject
Ligne d'objet de l'e-mail.
De
from
Adresse e-mail qui doit s'afficher dans le champ
De
 de l'e-mail envoyé.
Ssl
ssl
Indique si la connexion est SSL.
Starttls
starttls
Indique s'il faut activer une négociation SSL immédiate avec le serveur SMTP distant en exécutant une commande STARTTLS avant de démarrer la session SMTP. Le serveur SMTP répond avec l'un des codes de réponse suivants :
  • 220 Prêt à commencer.
  • TLS 501 Erreur de syntaxe (aucun paramètre autorisé).
  • 454 TLS indisponible pour des raisons temporaires.
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 envoyer le message.
Si vous utilisez OAuth, définissez cette valeur sur
localhost
.
Port
port
Numéro de port sur lequel le serveur de messagerie s'exécute. La valeur par défaut est 25, le port SMTP standard. Exceptions :
  • Si la propriété
    sl
     est définie sur
    true
     Si aucun port n'est indiqué, la valeur par défaut est 465.
  • Si la propriété
    Startls
     est définie sur :
    true
     Si aucun port n'est indiqué, la valeur par défaut est 587.
Utilisateur
Nom d'utilisateur permettant d'accéder au serveur de messagerie.
Mot de passe
password
Mot de passe du nom d'utilisateur indiqué dans la propriété
Utilisateur
.

Onglet Avancé

Propriété
Nom de l'attribut XML
Description
Store Message
store-message
Indiquez
none
, sauf indication contraire du support Workday.
Pour stocker des messages, utilisez l'étape
store
 de Workday Studio.
Transport Class
transport-class
Indique une autre classe d'implémentation par assemblage, si nécessaire.
Vous pouvez modifier les classes d'implémentation de manière globale en modifiant le fichier WEB-INF/classes/spring/assembly-bean.xml.
Ignore Dynamic Endpoints
ignore-dynamic-endpoints
Indique s'il faut ignorer la valeur WS-Addressing (WSA) dynamique dans l'en-tête du message entrant ou l'utiliser pour remplacer la valeur de la propriété
Point de terminaison
 du transport.
Utilisez l'étape
set-dynamic-endpoint
 pour indiquer le détail de WS-Addressing.
Bcc
bcc
Spécifie les destinataires des e-mails en copie cachée, en utilisant un point-virgule comme séparateur. Exemple :
logan.mcneil@workday.com; jake.lee@workday.com
.
Cc
cc
Indique des destinataires d'e-mail en copie conforme, à l'aide d'un séparateur point-virgule. Exemple :
logan.mcneil@workday.com; jake.lee@workday.com
.
Répondre à
reply-to
Adresse e-mail automatiquement insérée dans le champ
À
 lorsqu'un utilisateur répond à un e-mail. Pour la plupart des e-mails, l'adresse indiquée dans le champ
De
 est suffisante, il n'est donc pas nécessaire de définir la propriété
Répondre à
. Indiquez plusieurs adresses e-mail à l'aide d'un séparateur point-virgule. Exemple :
logan.mcneil@workday.com; jake.lee@workday.com
.
Expiration
timeout
Indique en millisecondes un délai d'expiration pour les sessions FTP entre les clients et le serveur FTP sur lequel le transport est en mode écoute. Si vous n'indiquez aucune valeur, la session expire au bout de 300 000 ms (5 minutes).
Transient Exceptions
transient-exceptions
Les exceptions transitoires sont des exceptions qui peuvent aboutir sans modification après une nouvelle tentative. Les exceptions non transitoires sont celles qui continueront d'échouer 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 en tant qu'exceptions temporaires.
Indiquez d'autres exceptions transitoires sous forme d'énumération de noms de classe séparés par des virgules, par des espaces ou par des virgules et des espaces. 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 indiquez des exceptions temporaires supplémentaires, vous devez également inclure les exceptions par défaut.
java.net.ConnectException
 et
java.net.SocketException
 dans la liste. Si ce n'est pas le cas, Workday les remplace.

Onglet SMTP Headers

Propriété
Nom de l'attribut XML
Description
Nom
name
Nom d'un en-tête SMTP personnalisé.
Pour ajouter un nouvel en-tête personnalisé sous des lignes existantes, cliquez sur
Ajouter
, puis indiquez un
Nom
 et une
Valeur
.
Pour ajouter un nouvel en-tête au-dessus d'une ligne existante, placez le curseur sur cette ligne, puis cliquez sur
Insérer
 dans le menu déroulant
Ajouter
.
Utilisez les boutons situés à droite de l'onglet
SMTP Headers
 pour supprimer des lignes ou les réorganiser.
Valeur
value
Valeur d'un en-tête SMTP personnalisé.

Onglet OAuth

Pour utiliser l'authentification OAuth de Microsoft Outlook avec la composante de sortie d'e-mail de Studio, enregistrez Studio en tant qu'application avec Microsoft Azure, fournissez une délégation sur l'ensemble du domaine et accordez l'acceptation de l'administrateur pour
Mail.Send
 autorisations et obtenir différentes valeurs. Pour plus d'informations, 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 le composant Email-Out de Workday 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 d'informations, voir https://support.google.com/cloud/answer/6158849?hl=en.
Propriété
Nom de l'attribut XML
Description
Fournisseur d'accès
provider
Le nom du fournisseur de services e-mail, soit
MICROSOFT_OUTLOOK
 ou
GOOGLE_GMAIL
.
Nom
name
Noms obligatoires de Workday que vous associez à différentes valeurs obtenues à partir du portail Microsoft Azure ou de Google Cloud Console.
Pour Microsoft Outlook, saisissez les noms suivants :
  • outlook.client.id
  • outlook.client.secret
  • outlook.tenant.id
  • outlook.user.id
Pour Google Gmail, saisissez :
  • gmail.service.account.key.json
  • gmail.delegated.user
Valeur
value
Valeurs obtenues auprès 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
Sur la page
Overview
 d'une application enregistrée sur le portail Microsoft Azure :
Identifiant de l'application (client).
outlook.client.secret
Sur la page
Certificates & secrets
 d'une application enregistrée sur le portail Microsoft Azure :
Identifiant de clé secrète client.
outlook.tenant.id
Sur la page
Overview
 d'une application enregistrée sur le portail Microsoft Azure :
Identifiant du répertoire (environnement client).
outlook.user.id
Adresse Outlook du compte à partir duquel l'e-mail sera envoyé. Également saisie dans le champ
De
 de l'onglet
Valeurs usuelles
.
Pour Google Gmail, créez les paires nom/valeur suivantes :
Nom
Valeur
gmail.service.account.key.json
Texte JSON du fichier téléchargé depuis la section
KEYS
 de la page
Service accounts
 dans Google Cloud Console.
gmail.delegated.user
Adresse Gmail à partir de laquelle l'e-mail sera envoyé. Doit être une adresse e-mail principale associée au compte de service Google. Également saisie dans le champ
De
 de l'onglet
Valeurs usuelles
.

Gmail via SSL ou avec STARTTLS

Lorsque vous configurez le transport
email-out
 pour utiliser Gmail via SSL ou STARTTLS, vérifiez que :
  • user
     et
    password
     contiennent des identifiants Gmail valides.
  • le point de terminaison
     est
    mailto:[name]@gmail.com
    .
  • l'hôte
     est
    smtp.gmail.com
    .
  • ssl
     ou
    startls
     est défini sur
    true
    .
  • port
     est :
    • 465, si
      ssl
       est défini sur
      true
      .
    • 587, si
      startls
       est défini sur
      true
      .
  • le délai d'expiration
     est
    30000
     (30 secondes).

Microsoft Office 365 via SSL ou avec STARTTLS

Lorsque vous configurez le transport
email-out
 pour utiliser Microsoft Office 365 via SSL ou STARTTLS, vérifiez que :
  • user
     et
    password
     contiennent des identifiants d'utilisateur Office 365 valides.
  • le point de terminaison
     est
    mailto:[name]@[domain-name.top-level-domain]
    .
  • l'hôte
     est
    smtp.office365.com
    .
  • ssl
     ou
    startls
     est défini sur
    true
    .
  • port
     est :
    • 465, si
      ssl
       est défini sur
      true
      .
    • 587, si
      starttls
       est défini sur
      true
      .
  • 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 messagerie mettent en correspondance la première partie de texte du message MIME et l'utilisent comme texte de message. Pour définir le type MIME de la partie de message racine sur
text/plain
, définissez les propriétés
d'entrée
 et
de sortie
 du message sur
message
, puis définissez le type MIME
de sortie
 sur
text/plain
.
Utilisez
Message Builder
 pour définir le contenu du message de l'e-mail à l'aide d'un élément
text
.
Pour la pièce jointe, définissez la propriété
de sortie
 sur
pièce jointe
, l'index de pièce jointe
de sortie
 sur
0
, et le Type MIME
de sortie
 sur
text/plain
.
Là encore, utilisez
Message Builder
 pour définir le contenu du message de la pièce jointe à l'aide d'un élément
text
.
Pour empêcher certaines applications de messagerie 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 en réalité de texte. Pour ce faire, utilisez une expression MVEL dans une étape
eval
. Exemple :
parts[1].setMimeType('application/octet-stream')
Pour définir le nom du fichier joint, utilisez une expression MVE pour définir son
Content-Disposition
 en-tête. Exemple :
parts[1].setHeader('Content-Disposition', 'attachment; filename=payload.txt')
.
Enfin, configurez l'étape
email-out
.

Configurer le corps du message et 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 récupéré dans une variable. Pour ce faire, vous pouvez utiliser la variable d'accès 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 depuis
wd.retrieve.variable
 à une pièce jointe. Pour ce faire, définissez la propriété
Input
 sur
variable
 et spécifiez
wd.retrieve.variable
 comme variable d'entrée. Définissez la propriété
de sortie
 sur
la pièce jointe
, indiquez un index de pièce jointe
de sortie
 de .
0
, et un Type
de sortie
 MIME de
image/jpeg
.
Enfin, configurez l'étape
email-out
.