SendMail
Sampel SendMail menunjukkan bagaimana Anda dapat menggunakan adaptor Simple Mail Transfer Protocol (SMTP) untuk mengirim pesan email dari dalam orkestrasi Microsoft BizTalk Server. Informasi dinamis yang digunakan untuk mengirim pesan email diambil dari pesan XML menggunakan fungsionalitas promosi properti.
Sampel ini mengirim pesan email menggunakan informasi yang diperoleh dari properti yang dipromosikan dari pesan pesan pesanan pembelian (PO) XML masuk, menggunakan urutan langkah-langkah berikut:
Orkestrasi BizTalk Server mengambil pesan PO XML input.
Orkestrasi BizTalk Server mempromosikan properti PONumber dan Email untuk akses yang lebih mudah di masa depan.
Orkestrasi BizTalk Server menggunakan nilai properti yang dipromosikan untuk mengatur alamat tujuan port pengiriman dinamis dan untuk mengatur subjek pesan email.
Orkestrasi BizTalk Server mengirimkan pesan email yang dibangun melalui adaptor SMTP.
<Jalur> Sampel\AdaptersUsage\SendMail\
Tabel berikut ini memperlihatkan file dalam sampel ini dan menjelaskan tujuannya.
File | Deskripsi |
---|---|
AssemblyInfo.cs, SendMail.btproj, SendMail.sln | Menyediakan file informasi proyek, solusi, dan perakitan untuk sampel ini. |
Cleanup.bat | Membatalkan penyebaran rakitan dan menghapusnya dari cache perakitan global (GAC); menghapus port kirim dan terima; menghapus direktori virtual Microsoft Internet Information Services (IIS) sesuai kebutuhan. |
PropertySchema.xsd, PurchaseOrder.xsd | Menyediakan skema untuk properti yang ingin Anda promosikan, dan untuk pesan XML PO, masing-masing. |
ReceiveSend.odx | Menyediakan orkestrasi BizTalk Server yang memproses pesan PO XML masuk dan mengirim pesan email berdasarkan informasi dalam pesan. |
SendMailInput.xml | Berisi contoh file input dengan PO yang ditentukan menggunakan XML. |
Setup.bat | Menyusun dan menginisialisasi sampel ini. Catatan: File penyiapan ini membuat dan mengikat port, dan sebagainya, menggunakan mekanisme yang berbeda dari sebagian besar file penyiapan untuk sampel SDK. Ini tidak memerlukan file .xml pendamping. |
Di jendela perintah, navigasikan ke folder berikut:
<Jalur> Sampel\AdaptersUsage\SendMail
Jalankan file Setup.bat, yang melakukan tindakan berikut:
Membuat folder input berikut untuk sampel ini:
<Jalur> Sampel\AdaptersUsage\SendMail\In
Kompilasi proyek Visual Studio untuk sampel ini.
Memulai orkestrasi BizTalk Server.
Catatan
Anda harus mengonfirmasi bahwa BizTalk tidak melaporkan kesalahan selama proses build dan inisialisasi sebelum mencoba menjalankan sampel ini.
Catatan
Jika Anda memilih untuk membuka dan membangun proyek dalam sampel ini tanpa menjalankan Setup.bat file, Anda harus terlebih dahulu membuat pasangan kunci nama yang kuat menggunakan Utilitas Nama Kuat .NET Framework (sn.exe). Gunakan pasangan kunci ini untuk menandatangani rakitan yang dihasilkan.
Catatan
Untuk membatalkan perubahan yang dibuat oleh Setup.bat, jalankan Cleanup.bat dan hapus semua port penerima dan kirim yang diawali dengan SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Anda harus menjalankan Cleanup.bat sebelum menjalankan Setup.bat untuk kedua kalinya.
Di konsol Administrasi BizTalk Server , temukan port terima yang diawali oleh SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail. Perbarui lokasi terima untuk port penerima ini untuk menunjuk ke direktori pada sistem file Anda untuk digunakan sebagai lokasi input.
Menggunakan program seperti Notepad, ubah file SendMailInput.xml sehingga elemen Email menentukan alamat email yang sah tempat Anda ingin menerima pesan email yang dihasilkan oleh sampel ini.
Klik Mulai, arahkan ke Program, arahkan ke Microsoft BizTalk Server 20xx, lalu klik Administrasi BizTalk Server.
Di konsol Administrasi BizTalk Server , perluas pohon Grup BizTalk.
Perluas pohon Pengaturan Platform di panel kiri.
Perluas folder Adapter , klik simpul SMTP , lalu klik dua kali baris adaptor SMTP di panel kanan.
Dalam kotak dialog Properti SMTP - Adapter Handler , klik Properti.
Dalam kotak dialog Properti Transportasi SMTP , pada tab Properti , berikan nilai yang sesuai untuk properti Nama server SMTP dan Dari (alamat email), lalu klik OK.
Nilai-nilai ini akan digunakan untuk membuat alamat email Dari untuk setiap pesan email yang dikirim melalui adaptor SMTP ini.
Catatan
Jika Anda perlu mengautentikasi dengan server SMTP, Anda harus memastikan bahwa alamat email Dari milik akun yang sama dengan yang Anda gunakan untuk autentikasi.
Hentikan lalu mulai ulang layanan BizTalk (BizTalkServerApplication) sehingga orkestrasi akan mengadopsi perubahan ini.
Letakkan salinan file yang dimodifikasi SendMailInput.xml ke dalam folder input.
Amati kedatangan pesan email ke alamat email yang Anda tentukan di prosedur sebelumnya.