Come configurare una porta di trasmissione SMTP

È possibile configurare una porta di trasmissione SMTP a livello di codice o tramite la Console di amministrazione BizTalk.

Come configurare una porta di trasmissione SMTP a livello di codice

L'adapter SMTP memorizza le rispettive informazioni di configurazione nel database di gestione BizTalk (definito anche database di configurazione). Le informazioni di configurazione vengono memorizzate in un contenitore delle proprietà XML personalizzato. Durante l'inizializzazione dell'adapter SMTP e la relativa fase di esecuzione, il server passa la configurazione all'adapter come segue:

• Per il gestore di invio SMTP, le informazioni di configurazione passano all'adattatore chiamando il metodo Load dell'interfaccia IPersistPropertyBag .

• Per gli adapter di trasmissione SMTP, le informazioni di configurazione vengono passate all'adapter sotto forma di set di proprietà in un contesto di messaggio. Tali proprietà sono raggruppate nello spazio dei nomi SMTP.

  Il modello a oggetti di BizTalk Explorer espone l'interfaccia di configurazione dell'adapter ITransportInfo per le porte di trasmissione, che include la proprietà di lettura/scrittura TransportTypeData. Tale proprietà accetta l'elenco delle proprietà di configurazione della porta di trasmissione SMTP come stringa XML costituita dalla coppia nome/valore. Si noti che per impostare questa proprietà nel modello a oggetti BizTalk Explorer, deve essere innanzitutto impostata sulla proprietà Address dell'interfaccia ITransportInfo .

  L'impostazione della proprietà TransportTypeData dell'interfaccia ITransportInfo non è necessaria. Se non viene impostata, la porta di trasmissione SMTP userà i valori predefiniti per il gestore di trasmissione SMTP. Le proprietà specifiche della porta di trasmissione SMTP vengono definite nello schema proprietà bts_smtp_properties.xsd dell'adapter di trasmissione SMTP.

  Se non viene definita alcuna proprietà che duplica le proprietà di configurazione del gestore di trasmissione, verranno utilizzate le proprietà di configurazione per il gestore. Se non vengono definite le proprietà necessarie, verranno usati i valori predefiniti. Se non vengono definiti i valori predefiniti, il gestore di trasmissione SMTP registrerà un errore nel registro eventi e sposterà il messaggio nell'adapter di backup.

  È possibile impostare queste proprietà a livello di codice in un contesto di messaggio. È possibile impostare queste proprietà in una pianificazione dell'orchestrazione di BizTalk o in un componente personalizzato della pipeline. Di seguito sono riportate le regole applicate per l'utilizzo di queste proprietà.

• Se la proprietà viene impostata in un'orchestrazione o in un componente personalizzato della pipeline in una pipeline di ricezione, vengono applicate le regole seguenti:

  • Se il messaggio viene inviato a una porta di trasmissione statica, il valore della proprietà verrà sovrascritto con il valore configurato per tale porta di trasmissione.

  • Se il messaggio viene inviato a una porta di trasmissione dinamica, il valore della proprietà non verrà sovrascritto.

• Se la proprietà viene impostata in un componente personalizzato della pipeline in una pipeline di trasmissione, vengono applicate le regole seguenti:

  • Il valore non verrà sovrascritto indipendentemente dal fatto che il messaggio venga inviato a una porta di trasmissione statica o dinamica.

  Nella tabella seguente sono illustrate le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per l'indirizzo di trasmissione SMTP.

Nome proprietà	Type	Descrizione	Restrizioni	Commenti
SMTPHost	xs:string	Server SMTP usato per l'invio di messaggi.	Lunghezza massima: 256	Valore predefinito: vuoto. Il valore predefinito indica che la porta di trasmissione SMTP userà i valori di configurazione relativi al gestore.
From	xs:string	Indirizzo di posta elettronica che la porta di invio SMTP inserisce nell'intestazione SMTP From .	Lunghezza massima: 256	Valore predefinito: vuoto. Il valore predefinito indica che la porta di trasmissione SMTP userà i valori di configurazione relativi al gestore.
CC	xs:string	Indirizzo di posta elettronica a cui verrà inviata una copia del messaggio.	Lunghezza massima: 1024	Valore predefinito: Vuoto È possibile elencare più indirizzi di posta elettronica.
Oggetto	xs:string	Intestazione dell'oggetto per i messaggi.	Lunghezza minima: 0 Lunghezza massima: 256	Valore predefinito: %MessageID%.
SMTPAuthenticate	xs:int	Tipo di autenticazione da usare.	Nessuno	Valori validi: - 0 - Nessuna autenticazione - 1- Autenticazione di base - 2 - Account di elaborazione (NTLM) Il valore predefinito indica che la porta di trasmissione SMTP userà i valori di configurazione relativi al gestore. Per applicare il valore predefinito, omettere questa proprietà dall'elenco di proprietà durante l'impostazione della proprietà TransportTypeData.
UserName	xs:string	Nome utente da usare per l'autenticazione con il server.	Lunghezza minima: 0 Lunghezza massima: 256	Valore predefinito: Vuoto Richiede un valore se SMTPAuthenticate è uguale a 1 (autenticazione di base).
Password	xs:string	Password utente per l'autenticazione con il server SMTP.	Lunghezza minima: 0 Lunghezza massima: 256	Valore predefinito: Vuoto Richiede un valore se SMTPAuthenticate è uguale a 1 (autenticazione di base).
ReadReceipt	xs:boolean	Richiede una conferma di lettura per i messaggi da questa porta di trasmissione.	Nessuno	Valore predefinito: False
DeliveryReceipt	xs:boolean	Richiede una conferma di recapito per i messaggi da questa porta di trasmissione.	Nessuno	Valore predefinito: False
EmailBodyText	xs:string	Specificare il testo da usare per il corpo del messaggio di posta elettronica da inviare.	Lunghezza massima: 64 kb	Valore predefinito: Vuoto
EmailBodyTextCharset	xs:string	Specificare il set di caratteri da usare per codificare il corpo del messaggio di posta elettronica inviato quando viene usata l'opzione EmailBodyText . L'adattatore SMTP convertirà EmailBodyText nel set di caratteri specificato da EmailBodyTextCharset.	Nessuno	Valore predefinito: No. È necessario impostare in modo esplicito il valore, ad esempio UTF-8. Se non si imposta alcun valore, è possibile che venga visualizzato l'errore mostrato alla fine di questo argomento.
EmailBodyFile	xs:string	Specificare che verrà usato il contenuto di un file (indicare il percorso completo) come corpo del messaggio di posta elettronica da inviare. Questo percorso deve essere accessibile all'host per l'adapter SMTP in fase di esecuzione.	Lunghezza massima percorso: 256 caratteri	Valore predefinito: Vuoto
EmailBodyFileCharset	xs:string	Specificare il set di caratteri da utilizzare per codificare il corpo del messaggio di posta elettronica inviato se è impostata la proprietà EmailBodyFile . L'adapter SMTP non eseguirà alcuna conversione nel file, che deve essere già codificato in questo set di caratteri. Se il file include un BOM (byte order mark), verrà rimosso dall'adapter SMTP.	Nessuno	Valore predefinito: UTF-8 (65001)
Allegati	xs:string	Specificare che uno o più file (indicare il percorso completo) saranno allegati al messaggio di posta elettronica. Il percorso o i percorsi specificati devono essere accessibili all'host per l'adapter SMTP in fase di esecuzione.	Lunghezza massima percorso: 256 caratteri	Valore predefinito: Vuoto
MessagePartsAttachments	xs:int	Specificare in che modo le parti del messaggio BizTalk vengono allegate al messaggio di posta elettronica.	Nessuno	Valori validi: - 0 - Nessuna parte del messaggio BizTalk verrà usata come allegati. - 1- La parte del corpo del messaggio BizTalk viene inviata come allegato di posta elettronica. In questo caso, è necessario specificare le proprietà EmailBodyFile o EmailBodyText . Se non viene specificata alcuna di queste proprietà, la parte del corpo del messaggio BizTalk verrà inviata come corpo del messaggio di posta elettronica, invece che come allegato. - 2 - Tutte le parti vengono inviate come allegati. Tuttavia, se EmailBodyText o EmailBodyFile non viene specificato, la parte del corpo del messaggio BizTalk viene inviata come corpo del messaggio di posta elettronica e altre parti vengono inviate come allegati. Valore predefinito: 0
ReplyBy	xs:dateTime	Popola il campo di intestazione Reply-By nel messaggio in uscita con il valore specificato.	Non è possibile impostare questa proprietà nella pagina delle proprietà della porta di trasmissione. Questa proprietà può essere impostata da una pipeline o un'orchestrazione.	Valore predefinito: Vuoto

Nel codice seguente viene illustrato il formato della stringa XML da usare per impostare le proprietà:

<CustomProps>  
   <DeliveryReceipt vt="11">-1</DeliveryReceipt  
   <SMTPHost vt="8">sfdsadf</SMTPHost>  
   <Subject vt="8">Some subject</Subject>  
   <From vt="8">username@domain.com</From>  
   <SMTPAuthenticate vt="19">2</SMTPAuthenticate>  
   <ReadReceipt vt="11">-1</ReadReceipt>  
</CustomProps>  

Come configurare una porta di trasmissione SMTP con la Console di amministrazione BizTalk Server

È possibile impostare le variabili dell'adapter della porta di trasmissione SMTP nella Console di amministrazione BizTalk Server. Se non vengono impostate proprietà per la porta di trasmissione, verranno usati i valori del gestore di trasmissione predefinito impostati nella Console di amministrazione BizTalk Server.

Per configurare una porta di trasmissione SMTP con la Console di amministrazione BizTalk Server, usare la procedura seguente.

Per configurare le variabili per una porta di trasmissione SMTP

1. Nella Console di amministrazione BizTalk Server creare una nuova porta di trasmissione oppure fare doppio clic su una porta di trasmissione esistente per modificarla. Per altre informazioni, vedere Come creare una porta di trasmissione. Configurare tutte le opzioni della porta di trasmissione e specificare SMTP per l'opzione Tipo nella sezione Trasporto della scheda Generale .

2. Nella scheda Generale , nella sezione Trasporto , accanto a Tipo, fare clic su Configura.

3. Nella scheda Generale della finestra di dialogo Proprietà trasporto SMTP eseguire le operazioni seguenti:

   Usare	Per
   To	Obbligatorio. Specificare l'indirizzo di posta elettronica di destinazione per l'invio dei messaggi. È possibile specificare più di un indirizzo. Lunghezza massima: 256 Per altre informazioni su questa proprietà, vedere Restrizioni per la proprietà SMTP To.
   CC	Specificare l'indirizzo di posta elettronica al quale inviare una copia del messaggio. È possibile specificare più di un indirizzo. Lunghezza massima: 1024
   Oggetto	Specificare l'intestazione dell'oggetto per il messaggio. Lunghezza minima: 0 Lunghezza massima: 256
   Notifica	Specificare il tipo di ricezione di notifica. È possibile selezionare uno o entrambi i tipi di ricezione. I tipi di ricezione di notifica sono: - Lettura ricevuta. Viene inviato un messaggio di conferma tramite posta elettronica quando il messaggio viene letto. - Ricevuta di consegna. Viene inviato un messaggio di conferma tramite posta elettronica quando il messaggio viene recapitato.

4. Nella scheda Componi della finestra di dialogo Proprietà trasporto SMTP eseguire le operazioni seguenti:

   Usare	Per
   Parte corpo del messaggio BizTalk	Specificare di usare la parte corpo del messaggio BizTalk per il corpo del messaggio di posta elettronica da inviare.
   Text	Specificare il testo da usare per il corpo del messaggio di posta elettronica da inviare. Dopo aver selezionato l'opzione Testo , è possibile immettere il testo per il corpo del messaggio di posta elettronica nella casella di testo. Lunghezza massima: 64 KB
   Set di caratteri per il testo	- Specificare il set di caratteri da utilizzare per codificare il corpo del messaggio di posta elettronica inviato. Questa opzione è disponibile solo se è selezionata l'opzione Testo . - Valore predefinito: UTF-8 (65001)
   File	Specificare che per il corpo del messaggio di posta elettronica da inviare verrà usato il contenuto di un file e indicare il percorso del file. Dopo aver selezionato l'opzione File , è possibile fare clic sul pulsante Con i puntini di sospensione (...) per passare al file. Lunghezza massima del percorso: 256 caratteri Nota: è consigliabile specificare un percorso in una condivisione file accessibile da tutti i server BizTalk nel gruppo BizTalk Server da usare nell'ambiente di produzione.
   Set di caratteri del file	Specificare la codifica del set di caratteri del file da inviare. Nota: L'adattatore SMTP non applica la codifica specificata al file. Questa opzione consente solo di specificare il modo in cui il file in fase di trasmissione è già stato codificato. Questa opzione è disponibile solo se è selezionata l'opzione File . Valore predefinito: UTF-8 (65001)

5. Nella scheda Allegati della finestra di dialogo Proprietà trasporto SMTP eseguire le operazioni seguenti:

   Usare	Per
   Parti restanti del messaggio BizTalk	Specificare in che modo le parti del messaggio BizTalk vengono allegate al messaggio di posta elettronica. Opzioni: - Non allegare parti - Collega solo parte del corpo - Collegare tutte le parti Valore predefinito: non allegare parti.
   Aggiungere	Specificare uno o più file da allegare al messaggio di posta elettronica. Dopo aver fatto clic su Aggiungi , è possibile selezionare un file e aggiungerlo all'elenco dei file da allegare. Lunghezza massima del percorso: 256 caratteri Nota: è consigliabile specificare un percorso in una condivisione file accessibile da tutti i server BizTalk nel gruppo BizTalk Server da usare nell'ambiente di produzione.
   Rimuovi	Rimuove il file selezionato dall'elenco dei file da allegare al messaggio di posta elettronica.

6. Nella scheda Override gestore della finestra di dialogo Proprietà trasporto SMTP eseguire le operazioni seguenti:

   Usare	Per
   Nome del server SMTP	Specificare il nome del server SMTP da usare quando si inviano messaggi. Lunghezza massima: 256 Nota: l'URI per una porta di trasmissione o una posizione di ricezione non può superare i 256 caratteri.
   Da (indirizzo posta elettronica)	Specificare l'indirizzo di posta elettronica da inserire nell'intestazione SMTP From . Lunghezza massima: 256
   Tipo di autenticazione	Specificare il tipo di autenticazione da usare con il server SMTP. Opzioni: - (Impostazione predefinita) - Nessuna autenticazione - Autenticazione di base - Account processo (NTLM) Il valore predefinito indica che la porta di trasmissione SMTP userà i valori di configurazione specificati nel gestore di trasmissione.
   Nome utente	Specificare il nome utente da usare per l'autenticazione con il server SMTP. Questa proprietà richiede un valore se il tipo di autenticazione è Autenticazione di base. Lunghezza minima: 0 Lunghezza massima: 256
   Password	Specificare la password da usare per l'autenticazione con il server SMTP. Questa proprietà richiede un valore se il tipo di autenticazione è Autenticazione di base. Lunghezza minima: 0 Lunghezza massima: 256

7. Fare di nuovo clic su OK e su OK per salvare le impostazioni.

Vedere anche

Configurazione dell'adapter SMTP