Passa al contenuto principale
Documentazione
Documentazione
Administrator Guide
Ultimo aggiornamento: 2023-06-23
Riferimenti: Proprietà di trasporto delle e-mail in uscita

Riferimenti: Proprietà di trasporto delle e-mail in uscita

Scheda Common

Proprietà
Nome attributo XML
Descrizione
ID
id
ID univoco del componente
e-mail
 all'interno dell'assieme.
Inoltra la risposta a
routes-response-to
La destinazione del messaggio di risposta per il trasporto
e-mail in uscita
 .
Eseguire quando
execute-when
Condizione che determina se il trasporto viene eseguito.
A
to
L'indirizzo e-mail principale del destinatario previsto. Segue il formato
mailto:[emailaddress]
.
Se si desidera utilizzare solo indirizzi BCC, specificare un valore vuoto
mailto:
 valore
Oggetto
subject
La riga dell'oggetto dell'e-mail.
Da
from
L'indirizzo e-mail che deve essere visualizzato nel campo
Da
 dell'e-mail recapitata.
Ssl
ssl
Specifica se la connessione è SSL.
Starttls
starttls
Specifica se attivare una negoziazione SSL immediata con il server SMTP remoto immettendo un comando STARTTLS prima di avviare la sessione SMTP. Il server SMTP risponde con uno dei seguenti codici di risposta:
  • 220 Pronto per l'avvio
  • TLS 501 Errore di sintassi (nessun parametro consentito)
  • 454 TLS non disponibile per un motivo temporaneo
Le proprietà
Ssl
 e
starttls
 si escludono a vicenda.
Host
host
Il nome o l'indirizzo IP del server di posta SMTP utilizzato dal trasporto per recapitare il messaggio.
Se si utilizza OAuth, impostare questo valore su
localhost
.
Porta
port
Il numero di porta su cui è in esecuzione il server di posta. Il valore predefinito è 25, porta SMTP standard. Eccezioni:
  • Se la proprietà
    SSL
     è impostata su
    true
     e non è stata specificata alcuna porta, il valore predefinito è 465.
  • Se la proprietà
    Starttls
     è impostata su
    true
     e non è stata specificata alcuna porta, il valore predefinito è 587.
Utente
Il nome utente per l'accesso al server e-mail.
Password
password
La password per il nome utente specificato nella proprietà
User
 .

Scheda Advanced

Proprietà
Nome attributo XML
Descrizione
Memorizzare il messaggio
store-message
Specificare
nessuno
 se non diversamente indicato dall'assistenza Workday.
Per archiviare i messaggi, utilizzare lo step
store
 di Studio.
Classe di trasporto
transport-class
Specifica una classe di implementazione alternativa in base all'assieme, se necessario.
È possibile modificare le classi di implementazione a livello globale modificando il file WEB-INF/classes/Spring/Assembly-bean.xml.
Ignora gli endpoint dinamici
ignore-dynamic-endpoints
Specifica se ignorare il valore dinamico WS-Addressing (WSA) nell'intestazione del messaggio in arrivo o utilizzarlo per sostituire il valore nella proprietà
Endpoint
 del trasporto.
Utilizzare lo step
set-dynamic-endpoint
 per specificare i dettagli del WS-Addressing.
Bcc
bcc
Specifica i destinatari e-mail in copia nascosta, utilizzando un punto e virgola come separatore. Esempio:
logan.mcneil@workday.com; jake.lee@workday.com
.
Cc
cc
Specifica i destinatari dell'e-mail in copia per conoscenza, utilizzando un punto e virgola come separatore. Esempio:
logan.mcneil@workday.com; jake.lee@workday.com
.
Destinatario risposta
reply-to
L'indirizzo e-mail inserito automaticamente nel campo
A
 quando un utente risponde a un messaggio e-mail. Per la maggior parte dei messaggi e-mail, l'indirizzo nel campo
From
 è sufficiente, quindi non è necessario definire la proprietà
Reply To
. Specificare più indirizzi e-mail utilizzando un punto e virgola come separatore. Esempio:
logan.mcneil@workday.com; jake.lee@workday.com
.
Timeout
timeout
Specifica, in millisecondi, un periodo di timeout per le sessioni FTP tra i client e il server FTP su cui è in ascolto il trasporto. Se non si specifica un valore, la sessione scade dopo 300.000 ms (5 minuti).
Eccezioni temporanee
transient-exceptions
Le eccezioni temporanee sono eccezioni che potrebbero avere esito positivo senza apportare modifiche al nuovo tentativo. Le eccezioni non temporanee sono quelle che continueranno a non riuscire fino a quando la causa del problema non verrà corretta.
Per impostazione predefinita, il sistema tratta solo
java.net.ConnectException
 e
java.net.SocketException
 errori come eccezioni temporanee.
Specificare eccezioni temporanee aggiuntive come virgola, spazio o enumerazione dei nomi delle classi separate da virgole e spazi. Esempi:
  • 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()}
Se si specificano eccezioni temporanee aggiuntive, è necessario includere anche le eccezioni predefinite
java.net.ConnectException
 e
java.net.SocketException
 nell'elenco. In caso contrario, il sistema li sovrascrive.

Scheda Intestazioni SMTP

Property
Nome attributo XML
Descrizione
Nome
name
Il nome di un'intestazione SMTP personalizzata.
Per aggiungere una nuova intestazione personalizzata sotto qualsiasi riga esistente, fare clic su
Add
, quindi specificare un
Name
 e un
Value
.
Per aggiungere una nuova intestazione sopra una riga esistente, posizionare il cursore su quella riga, quindi fare clic su
Insert
 nel menu a discesa
Add
.
Utilizzare i pulsanti a destra della scheda
SMTP Headers
 per eliminare le righe o riordinarle.
Valore
value
Il valore di un'intestazione SMTP personalizzata.

Scheda OAuth

Per utilizzare l'autenticazione OAuth di Microsoft Outlook con il componente E-mail in uscita di Studio, registrare Studio come app con Microsoft Azure, fornire delega a livello di dominio, concedere il consenso dell'amministratore per
Mail.Send
 autorizzazioni e ottenere vari valori. Per i dettagli, consultare https://learn.microsoft.com/en-gb/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow.
Per utilizzare l'autenticazione OAuth di Google Gmail con il componente Email-Out di Studio, registrare un account di servizio con Google Cloud, fornire la delega a livello di dominio e ottenere una descrizione JSON con vari valori. Per i dettagli, consultare https://support.google.com/cloud/answer/6158849?hl=en.
Property
Nome attributo XML
Descrizione
Provider
provider
Il nome del provider di posta elettronica
MICROSOFT_OUTLOOK
 o
GOOGLE_GMAIL
.
Nome
name
I nomi assegnati a Workday associati a vari valori ottenuti dal portale di Microsoft Azure o da Google Cloud Console.
Per Microsoft Outlook, immettere i seguenti nomi:
  • outlook.client.id
  • outlook.client.secret
  • outlook.tenant.id
  • outlook.user.id
Per Google Gmail, immettere:
  • gmail.service.account.key.json
  • gmail.delegated.user
Valore
value
I valori ottenuti da Microsoft o Google associati ai nomi precedenti.
Per Microsoft Outlook, creare le seguenti coppie nome/valore:
Nome
Valore
outlook.client.id
Dalla pagina
Overview
 di un'app registrata nel portale di Microsoft Azure:
Application (client) ID.
outlook.client.secret
Dalla pagina
Certificates & secrets
 di un'app registrata nel portale di Microsoft Azure:
Client Secret ID.
outlook.tenant.id
Dalla pagina
Overview
 di un'app registrata nel portale di Microsoft Azure:
Directory (tenant) ID.
outlook.user.id
L'indirizzo Outlook dell'account da cui verrà inviata l'e-mail. Immesso anche nel campo
From
 della scheda
Common
.
Per Google Gmail, creare le seguenti coppie nome/valore:
Nome
Valore
gmail.service.account.key.json
Il testo JSON del file scaricato dalla sezione
KEYS
 della pagina
Service accounts
 in Google Cloud Console.
gmail.delegated.user
L'indirizzo Gmail da cui verrà inviata l'e-mail. Deve essere un Principal associato all'account di servizio Google. Immesso anche nel campo
From
 della scheda
Common
.

Gmail su SSL o con STARTTLS

Quando si configura il trasporto delle
email-out
 per l'utilizzo di Gmail su SSL o STARTTLS, assicurarsi che:
  • l'utente
     e
    la password
     contengono credenziali Gmail valide.
  • l'endpoint
     è
    mailto:[name]@gmail.com
    .
  • host
     è
    smtp.gmail.com
    .
  • SSL
     o
    starttls
     è impostato su
    true
    .
  • la porta
     è:
    • 465, se
      ssl
       è impostato su
      true
      .
    • 587, se
      starttls
       è impostato su
      true
      .
  • il timeout
     è
    30000
     (30 secondi).

Microsoft Office 365 su SSL o con STARTTLS

Quando si configura il trasporto delle
email-out
 per l'utilizzo di Microsoft Office 365 su SSL o STARTTLS, assicurarsi che:
  • user
     e
    password
     contengono credenziali utente di Office 365 valide.
  • l'endpoint
     è
    mailto:[name]@[domain-name.top-level-domain]
    .
  • host
     è
    smtp.office365.com
    .
  • SSL
     o
    starttls
     è impostato su
    true
    .
  • porta
     :
    • 465, se
      ssl
       è impostato su
      true
      .
    • 587, se
      starttls
       è impostato su
      true
      .
  • il timeout
     è
    30000
     (30 secondi).

Configurazione del corpo del messaggio e dell'allegato per i formati non binari

Quando si ricevono messaggi in arrivo, molte applicazioni e-mail corrispondono alla prima parte di testo del messaggio MIME e la utilizzano come testo del messaggio. Per impostare il tipo MIME della parte del messaggio radice su
text/plain
, impostare le proprietà
Input
 e
Output
 del messaggio su
message
, quindi impostare Tipo MIME
di output
 su
text/plain
.
Utilizzare il
Generatore di messaggi
 per definire il contenuto del messaggio per il corpo del messaggio e-mail utilizzando un elemento
di testo
 .
Per l'allegato, impostare la proprietà
Output
 su
allegato
, l'indice allegato
Output
 su
0
e il Tipo MIME
di output
 in
testo/normale
.
Anche in questo caso, utilizzare il
Generatore di messaggi
 per definire il contenuto del messaggio per l'allegato utilizzando un elemento
di testo
 .
Per evitare che alcune applicazioni e-mail visualizzino allegati di testo nel corpo del messaggio, impostare il tipo MIME dell'allegato su
application/octet-stream
, anche se in realtà si tratta di testo. A tale scopo, utilizzare un'espressione MVEL all'interno di uno step
di valutazione
 . Esempio:
parts[1].setMimeType('application/octet-stream')
Per impostare il nome del file allegato, utilizzare un'espressione MVEL per impostarlo
Content-Disposition
 intestazione Esempio:
parts[1].setHeader('Content-Disposition', 'attachment; filename=payload.txt')
.
Infine, configurare lo step
di invio e-mail
 .

Configurazione del corpo messaggio e dell'allegato per i formati binari

Per inserire un file binario in
MediationContext
, definire un servizio Recupero per
workday-in
 che recuperi il file da un trasporto FTP o SFTP.
Creare il corpo del messaggio, quindi utilizzare uno step
eval
 per copiare il file recuperato in una variabile. A tale scopo è possibile utilizzare la variabile della funzione di accesso ai documenti
da
 e il metodo
toVar
 . Esempio:
da.toVar(Rising_2011_Logo.jpg', 'wd.retrieve.variable')
.
Utilizzare uno step
di copia
 per copiare il file da
wd.retrieve.variable
 a un allegato. A tale scopo, impostare la proprietà
Input
 su
Variable
 e specificare
wd.retrieve.variable
 come variabile di input. Impostare la proprietà
Output
 su
Allegato
, specificare un Indice allegato
Output
 di
0
e un Tipo MIME di
output
 di
image/jpeg
.
Infine, configurare lo step
di invio e-mail
 .