Skip to main content
Documentatie
Documentatie
Administrator Guide
Laatst bijgewerkt: 2023-06-23
Referentie: eigenschappen transport uitgaande e-mail

Referentie: eigenschappen transport uitgaande e-mail

Tabblad Algemeen

Eigenschap
Naam XML-kenmerk
Omschrijving
ID
id
De unieke ID van de component
voor e-mailen
 in de assemblage.
Routeert antwoord naar:
routes-response-to
De bestemming van het antwoordbericht voor het
e-mailtransport
 .
Wanneer uitvoeren
execute-when
Een voorwaarde die bepaalt of het transport wordt uitgevoerd.
Aan
to
Het primaire e-mailadres van de beoogde ontvanger. Volgt de notatie
mailto:[emailaddress]
.
Als u alleen BCC-adressen wilt gebruiken, geeft u een lege . op
mailto:
 waarde.
Onderwerp
subject
De onderwerpregel van de e-mail.
Van
from
Het e-mailadres dat moet worden weergegeven in het veld
'Van'
 van de geleverde e-mail.
SSL
ssl
Hiermee wordt aangegeven of de verbinding SSL is.
Starttls
starttls
Hiermee wordt aangegeven of een directe SSL-onderhandeling met de externe SMTP-server moet worden geactiveerd door een STARTTLS-opdracht te geven voordat de SMTP-sessie wordt gestart. De SMTP-server reageert met een van deze antwoordcodes:
  • 220 Gereed om te starten.
  • Fout in TLS 501-syntaxis (geen parameters toegestaan).
  • 454 TLS is niet beschikbaar vanwege een tijdelijke reden.
De eigenschappen
Ssl
 en
starttls
 sluiten elkaar uit.
Host
host
De naam of het IP-adres van de SMTP-mailserver die het transport gebruikt om het bericht te bezorgen.
Als u OAuth gebruikt, stelt u deze waarde in op
localhost
.
Poort:
port
Het poortnummer waarop de e-mailserver wordt uitgevoerd. De standaardwaarde is 25, de standaard SMTP-poort. Uitzonderingen:
  • Als de eigenschap
    ssl
     is ingesteld op:
    true
     en er geen poort is opgegeven, is de standaardwaarde 465.
  • Als de eigenschap
    Starttls
     is ingesteld op:
    true
     en er geen poort is opgegeven, is de standaardwaarde 587.
Gebruiker
De gebruikersnaam voor toegang tot de e-mailserver.
Wachtwoord
password
Het wachtwoord voor de gebruikersnaam die is opgegeven in de eigenschap
User
 .

Tabblad Geavanceerd

Eigenschap
Naam XML-kenmerk
Omschrijving
Bericht opslaan
store-message
Geef
geen
 op, tenzij anders aangegeven door de ondersteuningsafdeling van Workday.
Gebruik de
opslagstap
 van Studio om berichten op te slaan.
Transportklasse
transport-class
Hiermee wordt indien vereist een alternatieve implementatieklasse per samenstel opgegeven.
U kunt de implementatieklassen globaal wijzigen door het bestand WEB-INF/classes/spring/assembly-bean.xml te bewerken.
Dynamische eindpunten negeren
ignore-dynamic-endpoints
Hiermee wordt aangegeven of de dynamische WS-Addressing (WSA)-waarde in de koptekst van het inkomende bericht moet worden genegeerd of moet worden gebruikt om de waarde in de eigenschap
Endpoint
 van het transport te overschrijven.
Gebruik de stap
set-dynamic-endpoint
 om WS-Addressing-details op te geven.
Bcc
bcc
Hiermee geeft u ontvangers van e-mails met een blinde kopie op met een scheidingsteken voor puntkomma's. Voorbeeld:
logan.mcneil@workday.com; jake.lee@workday.com
.
Cc
cc
Hiermee geeft u de ontvangers van e-mails op met behulp van een puntkomma als scheidingsteken. Voorbeeld:
logan.mcneil@workday.com; jake.lee@workday.com
.
Beantwoorden aan
reply-to
Het e-mailadres dat automatisch wordt ingevoegd in het veld
'Aan'
 wanneer een gebruiker een e-mailbericht beantwoordt. Voor de meeste e-mailberichten is het adres in het veld
'Van'
 voldoende, dus het is niet nodig om de eigenschap
Reply To
 te definiëren. Geef meerdere e-mailadressen op met een scheidingsteken voor puntkomma's. Voorbeeld:
logan.mcneil@workday.com; jake.lee@workday.com
.
Time-out
timeout
Hiermee geeft u in milliseconden een time-outperiode op voor FTP-sessies tussen clients en de FTP-server waarop het transport luistert. Als u geen waarde opgeeft, treedt er na 300.000 ms (5 minuten) een time-out op in de sessie.
Tijdelijke uitzonderingen
transient-exceptions
Tijdelijke uitzonderingen zijn uitzonderingen die zonder wijzigingen kunnen slagen wanneer u het opnieuw probeert. Tijdelijke uitzonderingen zijn uitzonderingen die bij nieuwe pogingen blijven mislukken totdat de onderliggende oorzaak van het probleem is verholpen.
Standaard wordt alleen behandeld:
java.net.ConnectException
 and
java.net.SocketException
 fouten als tijdelijke uitzonderingen.
Geef aanvullende tijdelijke uitzonderingen op als een komma-, spatie- of door komma's en spaties gescheiden opsomming van klassenamen. Voorbeelden:
  • 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()}
Als u aanvullende tijdelijke uitzonderingen opgeeft, moet u ook de standaarduitzonderingen opnemen
java.net.ConnectException
 and
java.net.SocketException
 in de lijst. Als u dit niet doet, worden ze overschreven.

Tabblad SMTP-koppen

Eigenschap
Naam XML-kenmerk
Omschrijving
Naam
name
De naam van een aangepaste SMTP-kop.
Als u een nieuwe aangepaste kop onder bestaande rijen wilt toevoegen, klikt u op
'Toevoegen'
en voert u een
Naam
 en
Waarde
in.
Als u een nieuwe kop boven een bestaande rij wilt toevoegen, plaatst u de cursor in die rij en klikt u vervolgens op
'Invoegen'
 in het vervolgkeuzemenu '
Toevoegen
 '.
Gebruik de knoppen rechts van het tabblad
SMTP-koppen
 om rijen te verwijderen of de volgorde ervan te wijzigen.
Waarde
value
De waarde van een aangepaste SMTP-kop.

Tabblad OAuth

Als u OAuth-verificatie van Microsoft Outlook wilt gebruiken met de component voor uitgaande e-mail van Studio, registreert u Studio als app bij Microsoft Azure, verleent u domeinbrede delegering en verleent u de beheerder toestemming voor
Mail.Send
 machtigingen en verschillende waarden verkrijgen. Zie . voor meer informatie https://learn.microsoft.com/en-gb/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow.
Als u OAuth-verificatie van Google Gmail wilt gebruiken met de component E-mail uit van Studio, registreert u een serviceaccount bij Google Cloud, geeft u domeinbrede delegering op en vraagt u een JSON-omschrijving van verschillende waarden op. Zie . voor meer informatie https://support.google.com/cloud/answer/6158849?hl=en.
Eigenschap
Naam XML-kenmerk
Omschrijving
Provider
provider
De naam van de e-mailprovider
MICROSOFT_OUTLOOK
 of
GOOGLE_GMAIL
.
Naam
name
De door Workday gemandateerde namen die u koppelt aan verschillende waarden uit de Microsoft Azure-portal of de Google Cloud Console.
Voer de volgende namen in voor Microsoft Outlook:
  • outlook.client.id
  • outlook.client.secret
  • outlook.tenant.id
  • outlook.user.id
Voer voor Google Gmail het volgende in:
  • gmail.service.account.key.json
  • gmail.delegated.user
Waarde
value
De van Microsoft of Google verkregen waarden die u aan de bovenstaande namen koppelt.
Maak voor Microsoft Outlook de volgende naam/waarde-paren:
Naam
Waarde
outlook.client.id
Op de
overzichtspagina
 van een geregistreerde app in de Microsoft Azure-portal:
Toepassings-ID (client).
outlook.client.secret
Op de pagina
Certificaten en geheimen
 van een geregistreerde app in de Microsoft Azure-portal:
Geheime client-ID.
outlook.tenant.id
Op de
overzichtspagina
 van een geregistreerde app in de Microsoft Azure-portal:
Directory (tenant)-ID.
outlook.user.id
Het Outlook-adres van het account van waaruit de e-mail wordt verzonden. Ook ingevoerd in het veld
Van
 op het tabblad
Algemeen
 .
Maak voor Google Gmail de volgende naam/waarde-paren:
Naam
Waarde
gmail.service.account.key.json
De JSON-tekst uit het bestand dat is gedownload van de sectie
KEYS
 van de pagina
Serviceaccounts
 in de Google Cloud Console.
gmail.delegated.user
Het Gmail-adres van waaruit de e-mail wordt verzonden. Moet een Principal zijn die is gekoppeld aan het Google-serviceaccount. Ook ingevoerd in het veld
Van
 op het tabblad
Algemeen
 .

Gmail via SSL of met STARTTLS

Wanneer u het transport
van uitgaande e-mail
 configureert voor het gebruik van Gmail via SSL of STARTTLS, moet u ervoor zorgen dat:
  • gebruiker
     en
    wachtwoord
     geldige Gmail-referenties bevatten.
  • eindpunt
     is
    mailto:[name]@gmail.com
    .
  • host
     is
    smtp.gmail.com
    .
  • ssl
     of
    starttls
     is ingesteld op
    true
    .
  • poort
     is:
    • 465, als
      ssl
       is ingesteld op:
      true
      .
    • 587, als
      starttls
       is ingesteld op:
      true
      .
  • time-out
     is
    30000
     (30 seconden).

Microsoft Office 365 via SSL of met STARTTLS

Wanneer u het
e-mailtransport
 configureert voor het gebruik van Microsoft Office 365 via SSL of STARTTLS, moet u ervoor zorgen dat:
  • gebruiker
     en
    wachtwoord
     geldige Office 365-gebruikersreferenties bevatten.
  • eindpunt
     is
    mailto:[name]@[domain-name.top-level-domain]
    .
  • host
     is
    smtp.office365.com
    .
  • ssl
     of
    starttls
     is ingesteld op
    true
    .
  • poort ofwel
     :
    • 465, als
      ssl
       is ingesteld op:
      true
      .
    • 587, als
      starttls
       is ingesteld op
      true
      .
  • time-out
     is
    30000
     (30 seconden).

Hoofdtekst en bijlage van bericht configureren voor niet-binaire notaties

Bij het ontvangen van inkomende berichten matchen veel e-mailtoepassingen het eerste tekstgedeelte in het MIME-bericht en gebruiken dit als berichttekst. Het MIME-type van het hoofdberichtgedeelte instellen op:
text/plain
, stel de eigenschappen
voor berichtinvoer
 en
-uitvoer
 in op
bericht
en stel vervolgens het MIME-type
voor uitvoer
 in op
text/plain
.
Gebruik de
berichtopbouwfunctie
 om de berichtinhoud voor de hoofdtekst van het e-mailbericht te definiëren met behulp van een
tekstelement
 .
Stel voor de bijlage de eigenschap
Uitvoer
 in op
bijlage
, de index
Uitvoerbijlage
 op
0
, en het MIME-type
voor uitvoer
 naar
text/plain
.
Gebruik opnieuw de
berichtenopbouwfunctie
 om de berichtinhoud voor de bijlage te definiëren met behulp van een
tekstelement
 .
Als u wilt voorkomen dat in sommige e-mailtoepassingen tekstbijlagen in de hoofdtekst van het bericht worden weergegeven, stelt u het MIME-type voor de bijlage in op
application/octet-stream
, ook al is het in werkelijkheid tekst. Gebruik hiervoor een MVEL-expressie in een
evaluatiestap
 . Voorbeeld:
parts[1].setMimeType('application/octet-stream')
Als u de naam van het bijlagebestand wilt instellen, gebruikt u een MVEL-expressie om de bijbehorende . in te stellen
Content-Disposition
 kop. Voorbeeld:
parts[1].setHeader('Content-Disposition', 'attachment; filename=payload.txt')
.
Configureer ten slotte de stap
voor het verzenden van e-mails
 .

Hoofdtekst en bijlage van bericht configureren voor binaire notaties

Als u een binair bestand wilt invoegen in de
MediationContext
, definieert u een ophaalservice voor de
workday-in
 die het bestand ophaalt uit een FTP- of SFTP-transport.
Maak de hoofdtekst van het bericht en gebruik vervolgens een
evaluatiestap
 om het opgehaalde bestand naar een variabele te kopiëren. U kunt hiervoor de document accessor-variabele
da
 en de methode
toVar
 gebruiken. Voorbeeld:
da.toVar(Rising_2011_Logo.jpg', 'wd.retrieve.variable')
.
Gebruik een
kopieerstap
 om het bestand uit de te kopiëren
wd.retrieve.variable
 naar een bijlage. Stel hiervoor de eigenschap
Input
 in op
variabele
 en geef op:
wd.retrieve.variable
 als invoervariabele. Stel de eigenschap
Uitvoer
 in op
bijlage
, geef een
uitvoerbijlage
 -index op
0
en een MIME-
uitvoertype
afbeelding/jpeg
.
Configureer ten slotte de stap
voor het verzenden van e-mails
 .