Ricezione di una email

È possibile ricevere un'email, con o senza allegati, da un server email che supporta Post Office Protocol 3 (POP3) o Internet Message Access Protocol (IMAP).

1. Aggiungere un nodo EmailInput al proprio flusso di messaggi.
2. Modificare le proprietà del nodo EmailInput :
   1. Nella scheda Base, aggiungere il server di posta elettronica URL, o il nome del criterio del server di posta elettronica come valore della proprietà Server di posta elettronica, come descritto nel nodo EmailInput. Ad esempio, pop3://myemailserver.com:12345 o imap://myemailserver.com:56789.
   2. Nella scheda Sicurezza , aggiungere il nome oggetto identità di protezione della coppia ID utente e password del server email come valore della proprietà Identità di sicurezza .

      Se si pianifica l'autenticazione con il server email utilizzando un ID utente e una parola d'ordine, è possibile utilizzare il comando mqsicredentials o il comando mqsisetdbparms per definire l'identità di sicurezza. Se intendi utilizzare lo standard « OAuth » (Open Authorization), devi utilizzare il mqsicredentials comando per fornire un ID utente e un token di accesso.

      Per ulteriori informazioni sul supporto dell'identità di sicurezza del server email, consultare Comando mqsicredentials o Comando mqsisetdbparms.

   3. Configurare le seguenti proprietà nella scheda Riprova :
      • Meccanismo nuovo tentativo: la proprietà Meccanismo nuovo tentativo definisce il modo in cui il nodo EmailInput gestisce un errore del flusso di messaggi. I valori validi sono Failure, Short Retryo Short and Long Retry. Il valore predefinito per questa proprietà è Nuovo tentativo breve e lungo, che indica che l'email viene ritentata fino a quando non viene raggiunta la soglia di nuovi tentativi brevi, quindi si verifica un nuovo tentativo lungo, il che significa che l'email non viene mai eliminata dal server di email, ma anche che l'email viene infinitamente ritentata. Le email vengono eliminate dal server email se il messaggio email ha esito negativo e il valore di questa proprietà non è impostato su Tentativi brevi e lunghi.
      • Soglia tentativi: la proprietà Soglia tentativi è il numero di volte in cui si tenta nuovamente la transazione del flusso di messaggi quando il valore della proprietà Meccanismo tentativi è impostato su Tentativi brevi. Il valore predefinito per questa proprietà è 0.
      • Intervallo nuovo tentativo breve (in secondi): l'intervallo nuovo tentativo breve è l'intervallo, in secondi, tra ogni nuovo tentativo se il valore della proprietà Soglia nuovo tentativo non è impostato su zero. Il valore predefinito per questa proprietà è 0. Se l'email viene ritentata fino al raggiungimento della soglia di tentativi brevi e l'email non riesce, l'email viene instradata al terminale failure e l'email viene eliminata dal server email.
      • Intervallo nuovo tentativo lungo (in secondi): l'intervallo nuovo tentativo lungo è l'intervallo, in secondi, tra ogni nuovo tentativo, se il valore della proprietà Meccanismo nuovo tentativo è Nuovo tentativo breve e lungoe la soglia del nuovo tentativo breve è stata esaurita. Il valore predefinito per questa proprietà è 300 secondi.
      • Azione su email non riuscita: la proprietà Azione su email non riuscita determina l'azione che il nodo EmailInput intraprende con l'origine dati di input dopo che tutti i tentativi di elaborare il contenuto email non sono riusciti. La proprietà Azione in caso di errore dell'email è una proprietà di sola lettura impostata sul valore predefinito Elimina email, utilizzato con la proprietà Meccanismo di ripetizione. Se la proprietà del meccanismo Riprova è impostata su Nuovo tentativo breve e lungo, il flusso di messaggi continua a tentare di richiamare l'email dal server email, il che significa che l'email non viene mai eliminata. Se la proprietà Meccanismo tentativi non è impostata su Tentativi brevi e lunghi, viene utilizzato il valore della proprietà Azione in caso di errore Elimina email e l'email viene eliminata dal server email.
3. Salvare le modifiche.
4. Aggiungere il flusso di messaggi al file BAR ed effettuare la distribuzione.

   Quando un messaggio viene trasmesso nel nodo EmailInput distribuito, viene ricevuta un'email dal server email e il corpo del messaggio email e gli eventuali allegati vengono propagati nel dominio MIME (Multipurpose Internet Mail Extensions). Tutte le altre informazioni relative all'email sono memorizzate nell'albero logico MIME Root.EmailInputHeader . Per un elenco completo degli elementi email propagati nella struttura ad albero logica MIME quando si utilizza un nodo EmailInput , vedere EmailInput.

   Quando si riceve un'email che contiene un allegato, il nodo EmailInput posiziona parti differenti del corpo dell'e-mail nel dominio MIME, in modo che siano associate al programma di analisi MIME. L'ubicazione della struttura ad albero MIME creata dal nodo EmailInput per ospitare le informazioni è la stessa ubicazione in cui il nodo EmailOutput prevede che si trovino i dati email quando si invia un'email. L'allegato viene memorizzato nella struttura logica MIME nella directory Root.MIME.Parts.Part.Data. Dove Content-Type descrive il tipo di dati presenti nell'allegato.

   

   La visualizzazione del valore Root.Properties.ContentType nel dominio MIME consente di scrivere la logica per analizzare l'allegato. Per ulteriori informazioni sulla struttura ad albero logica MIME, consultare Dominio e programma di analisi MIME.