L'esempio SendMail illustra come usare l'adattatore Simple Mail Transfer Protocol (SMTP) per inviare messaggi di posta elettronica dall'interno di un'orchestrazione di Microsoft BizTalk Server. Le informazioni dinamiche utilizzate per inviare i messaggi di posta elettronica vengono recuperate da un messaggio XML mediante la funzionalità di promozione di proprietà.
Scopo dell'esempio
In questo esempio viene inviato un messaggio di posta elettronica utilizzando le informazioni ottenute dalle proprietà alzate di livello da un ordine di acquisto XML in ingresso, mediante la sequenza di passaggi seguente:
L'orchestrazione BizTalk Server recupera un messaggio dell'po po xml di input.
L'orchestrazione BizTalk Server promuove le proprietà PONumber e Email per facilitare l'accesso in futuro.
L'orchestrazione BizTalk Server usa i valori delle proprietà promosse per impostare l'indirizzo di destinazione della porta di trasmissione dinamica e per impostare l'oggetto del messaggio di posta elettronica.
L'orchestrazione BizTalk Server invia il messaggio di posta elettronica costruito tramite l'adattatore SMTP.
Percorso dell'esempio
<Percorso> esempi\AdaptersUsage\SendMail\
Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.
File
Descrizione
AssemblyInfo.cs, SendMail.btproj, SendMail.sln
Fornisce i file di informazioni di progetto, soluzione e assembly per questo esempio.
Cleanup.bat
Annulla la distribuzione degli assembly e li rimuove dalla Global Assembly Cache (GAC); rimuove le porte di trasmissione e ricezione; rimuove le directory virtuali di Microsoft Internet Information Services (IIS) in base alle necessità.
PropertySchema.xsd, PurchaseOrder.xsd
Forniscono rispettivamente gli schemi per le proprietà da alzare di livello e per il messaggio dell'ordine di acquisto in formato XML.
ReceiveSend.odx
Fornisce una orchestrazione BizTalk Server che elabora il messaggio XML PO in ingresso e invia un messaggio di posta elettronica in base alle informazioni contenute nel messaggio.
SendMailInput.xml
Contiene un file di input di esempio con un ordine di acquisto specificato mediante XML.
Setup.bat
Compila e inizializza l'esempio. Nota: Questo file di installazione crea e associa porte e così via, usando un meccanismo diverso rispetto alla maggior parte dei file di installazione per gli esempi dell'SDK. Non richiede un file con estensione xml di supporto.
Per compilare e inizializzare l'esempio
In una finestra di comando passare alla seguente cartella:
<Percorso> esempi\AdaptersUsage\SendMail
Eseguire il file Setup.bat. Verranno eseguite le operazioni seguenti:
Creazione della cartella di input seguente per l'esempio:
<Percorso> esempi\AdaptersUsage\SendMail\In
Compila il progetto di Visual Studio per questo esempio.
Avvia l'orchestrazione BizTalk Server.
Nota
Prima di provare a eseguire l'esempio, è necessario verificare che BizTalk non abbia segnalato errori durante il processo di compilazione e inizializzazione.
Nota
Se si sceglie di aprire e compilare il progetto dell'esempio senza eseguire il file Setup.bat, è necessario creare prima una coppia di chiavi con nome sicuro utilizzando l'utilità Nome sicuro di .NET Framework (sn.exe). Utilizzare questa coppia di chiavi per firmare l'assembly risultante.
Nota
Per annullare le modifiche apportate da Setup.bat, eseguire Cleanup.bat ed eliminare tutte le porte di ricezione ed invio precedute da SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. È necessario eseguire Cleanup.bat prima di eseguire Setup.bat una seconda volta.
Nella console di amministrazione di BizTalk Server individuare la porta di ricezione preceduta da SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Aggiornare il percorso di ricezione per questa porta di ricezione per puntare a una directory nel file system da usare come percorso di input.
Usando un programma come Blocco note, modificare il file SendMailInput.xml in modo che l'elemento Email specifica un indirizzo di posta elettronica legittimo in corrispondenza del quale si vuole ricevere il messaggio di posta elettronica generato da questo esempio.
Fare clic su Start, scegliere Programmi, scegliere Microsoft BizTalk Server 20xx e quindi fare clic su BizTalk Server Amministrazione.
Nella console di amministrazione di BizTalk Server espandere l'albero del gruppo BizTalk.
Espandere l'albero Impostazioni piattaforma nel riquadro sinistro.
Espandere la cartella Adapters , fare clic sul nodo SMTP e quindi fare doppio clic sulla riga dell'adattatore SMTP nel riquadro destro.
Nella finestra di dialogo Proprietà gestore adattatore- scheda fare clic su Proprietà.
Nella scheda Proprietà trasporto SMTP specificare i valori appropriati per il nome del server SMTP e Da (indirizzo di posta elettronica) e quindi fare clic su OK.
Questi valori verranno utilizzati per costruire l'indirizzo Da per tutti i messaggi di posta elettronica inviati tramite questo adapter SMTP.
Nota
Se è necessario eseguire l'autenticazione sul server SMTP, verificare che l'indirizzo Da appartenga allo stesso account utilizzato per l'autenticazione.
Arrestare e riavviare il servizio BizTalk (BizTalkServerApplication) in modo che le modifiche vengano applicate all'orchestrazione.
Per eseguire questo esempio
Inserire una copia del file SendMailInput.xml modificato nella cartella di input.
Osservare l'arrivo di un messaggio di posta elettronica all'indirizzo di posta elettronica specificato nella procedura precedente.
L'e-mail continua a essere il metodo di comunicazione principale, nonché quello preferito, per molte aziende. In alcune situazioni, i messaggi e-mail sono anche usati come forme elettroniche ufficiali di approvazione. Questo modulo presenta un elenco di procedure consigliate che è possibile seguire usando Microsoft Power Automate per i messaggi e-mail in uscita e in arrivo.