Bagikan melalui

Cara: Membuat Rencana Perjalanan untuk Merutekan Pesan secara Dinamis ke Alamat Email Menggunakan Kueri LDAP

Maksud

Bagian ini menunjukkan cara membuat rencana perjalanan yang meminta alamat email melalui LDAP (Lightweight Directory Access Protocol) lalu mengirim pesan email ke titik akhir yang diselesaikan menggunakan adaptor BizTalk Server SMTP.

Dalam topik Panduan ini, Anda akan menyelesaikan langkah-langkah berikut:

  • Buat lembar perutean untuk merutekan pesan secara otomatis menggunakan kueri LDAP.

  • Uji rencana perjalanan menggunakan aplikasi sampel Klien Uji Rencana Perjalanan.

Prasyarat

Prosedur dalam topik Panduan ini memerlukan penyelesaian Prasyarat untuk Aktivitas Pengembangan.

Komputer tempat Anda akan menyelesaikan bagian ini harus memiliki layanan direktori Microsoft Active Directory yang dikonfigurasi dan dijalankan (tidak diperlukan bahwa komputer adalah pengendali domain, tetapi harus terhubung ke domain). Selain itu, server SMTP harus dikonfigurasi dan dijalankan; untuk menguji hasil topik Panduan ini, Anda harus memiliki klien untuk memeriksa email yang dikirim oleh ESB.

Instruksi di bagian ini mengasumsikan organisasi bernama Global Bank, dengan domain globalbank.com, dengan Unit Organisasi Direktori Aktif bernama Karyawan yang berisi pengguna bernama John Evans dengan alamat email yang valid di profilnya (seperti johne@globalbank.com). Tidak perlu mereplikasi faktor lingkungan ini; namun, untuk tujuan membuat ulang implementasi ini di lingkungan Anda, harap perhitungkan faktor-faktor ini dan buat substitusi seperlunya.

Langkah-langkah

Untuk membuat model bahasa khusus domain rencana perjalanan ESB (DSL)

  1. Di Visual Studio, buka C:\HowTos\Patterns\Patterns.sln.

  2. Di Penjelajah Solusi, klik kanan proyek ItineraryLibrary , arahkan ke Tambahkan, lalu klik Rencana Perjalanan Baru.

  3. Dalam kotak dialog Tambahkan Item Baru , ketik LdapResolution di kotak Nama , lalu klik Tambahkan.

Untuk mengonfigurasi properti rencana perjalanan

  1. Di Visual Studio, klik permukaan desain LdapResolution.itinerary. Di jendela Properti LdapResolution , konfigurasikan properti berikut:

    1. Di daftar drop-down Pengekspor Model , klik Pengekspor Rencana Perjalanan XML.

    2. Di bawah bagian Pengaturan Extender, di samping properti file Itinerary XML, klik tombol elipsis (...).

    3. Dalam kotak dialog Pilih File XML , ketik C:\HowTos\Itineraries\LdapResolution di kotak Nama file , lalu klik Simpan.

      Nota

      Langkah ini memungkinkan Anda mengekspor rencana perjalanan sebagai XML ke lokasi file lokal. Dengan mengekspor rencana perjalanan ke lokasi file lokal, alih-alih ke database rencana perjalanan, memungkinkan pengujian rencana perjalanan menggunakan aplikasi Klien Uji ESB. Anda akan menyelesaikan proses ini nanti dalam topik Panduan ini.

Untuk menentukan struktur rencana perjalanan

  1. Dari Kotak Alat, seret elemen model On-Ramp ke permukaan desain. Di jendela Properti OnRamp1 , konfigurasikan properti berikut ini:

    1. Klik properti Nama , lalu ketik ReceiveNAOrder.

    2. Di daftar drop-down Extender , klik On-Ramp ESB Extender.

    3. Di daftar drop-down Aplikasi BizTalk , klik Microsoft.Practices.ESB.

    4. Di daftar drop-down Terima Port , klik OnRamp.Itinerary.

  2. Dari Kotak Alat, seret elemen model Layanan Itinerary ke permukaan desain, lalu letakkan di sebelah kanan elemen model On-Ramp . Di jendela Properti ItineraryService1 , konfigurasikan properti berikut:

    1. Klik properti Nama , lalu ketik RouteMessageEmail.

    2. Di daftar drop-down Itinerary Service Extender, klik Extender Olah Pesan.

      Nota

      Properti ini mendefinisikan bahwa proses akan berlangsung dalam jalur (pesan). Secara bergantian, jika proses akan berlangsung dalam orkestrasi, atur properti Itinerary Service Extender ke Orchestration Extender.

    3. Di daftar drop-down Kontainer, perluas ReceiveNAOrder, lalu klik Terima Handlers.

    4. Di daftar drop-down Nama Layanan , klik Microsoft.Practices.ESB.Services.Routing.

  3. Klik kanan kumpulan Resolver elemen model RouteMessageEmail , lalu klik Tambahkan Resolver baru. Di jendela Properti Resolver1 , konfigurasikan properti berikut ini:

    1. Klik properti Nama , lalu ketik LdapResolver.

    2. Pada daftar drop-down Implementasi Resolver, klik Ekstensi Resolver LDAP.

    3. Di daftar drop-down Nama Transportasi , klik SMTP.

    4. Klik properti Lokasi Transportasi , lalu ketik {mail}

    5. Klik properti SearchRoot , lalu ketik ou=Employees,dc=globalbank,dc=com

      Nota

      Jika Anda belum menyiapkan lingkungan sesuai dengan spesifikasi di bagian "Prasyarat", ganti nilai di properti sebelumnya dengan yang sesuai untuk lingkungan Anda.

    6. Klik properti Filter , lalu ubah nilai menjadi (&(objectClass=User)(|( givenName=john)))

      Nota

      Ketik nilai sebelumnya untuk mengganti teks yang ada.

    7. Pada daftar drop-down ThrowErrorIfNotFound, klik True.

  4. Di jendela Properti, klik properti Konfigurasi Titik Akhir , lalu klik tombol elipsis (...).

    1. Dalam kotak dialog Konfigurasi Titik Akhir , klik properti EmailBodyText , lalu ketik Order siap untuk diproses.

    2. Klik properti Dari , lalu ketik orders@globalbank.com.

    3. Klik properti MessagePartsAttachment , lalu ketik 2.

    4. Klik properti Subjek , lalu ketik Urutan untuk {givenName}.

    5. Konfigurasikan properti SMTPAuthentication, SMTPHost, UserName, dan Password menggunakan informasi koneksi untuk lingkungan lokal Anda.

    6. Klik OK untuk menutup kotak dialog Konfigurasi Titik Akhir .

  5. Klik kanan pemecah masalah LdapResolver , lalu klik Konfigurasi Pemecah Masalah Uji.

  6. Di jendela Output, verifikasi subjek dalam nilai Konfigurasi Titik Akhir yang diselesaikan adalah Pesanan untuk John, lalu verifikasi bahwa Lokasi Transportasi yang diselesaikan adalah alamat email yang terkait dengan akun pengguna di Direktori Aktif (misalnya, johne@globalbank.com).

  7. Di Kotak Alat, klik Konektor. Seret koneksi dari elemen model ReceiveNAOrder ke elemen model RouteMessageEmail .

  8. Dari Kotak Alat, seret elemen model Off-Ramp ke permukaan desain, lalu letakkan di sebelah kanan elemen model RouteMessageEmail . Di jendela Properti OffRamp1 , konfigurasikan properti berikut ini:

    1. Klik properti Nama , lalu ketik EmailNAOrderDoc.

    2. Di daftar drop-down Extender , klik Off-Ramp ESB Extender.

    3. Di daftar drop-down Aplikasi BizTalk , klik GlobalBank.ESB.

    4. Di daftar drop-down Kirim Port , klik DynamicResolutionOneWay.

  9. Dari Kotak Alat, seret elemen model Layanan Rencana Perjalanan ke permukaan desain, lalu letakkan di antara elemen model RouteMessageEmail dan elemen model EmailNAOrderDoc . Di jendela Properti ItineraryService1 , konfigurasikan properti berikut:

    1. Klik properti Nama , lalu ketik SendPortFilter.

    2. Di daftar drop-down Itinerary Service Extender , klik Off-Ramp Extender.

    3. Di daftar drop-down Off-Ramp , perluas EmailNAOrderDoc, lalu klik Kirim Handler.

  10. Di Kotak Alat, klik Konektor. Seret koneksi dari elemen model RouteMessageEmail ke elemen model SendPortFilter .

  11. Di Kotak Alat, klik Konektor. Seret koneksi dari elemen model SendPortFilter ke elemen model EmailNAOrderDoc .

Untuk mengekspor model untuk digunakan dengan Klien Uji Rencana Perjalanan

  1. Di Visual Studio, klik kanan permukaan desain itinerary LdapResolution , lalu klik Ekspor Model.

    Nota

    Versi XML dari rencana perjalanan terbuka di Visual Studio.

  2. Simpan semua artefak proyek.

  3. Di Windows Explorer, navigasikan ke C:\HowTos\Itineraries and notice the creation of your itinerary XML (LdapResolution.xml).

Untuk menguji rencana perjalanan

  1. Buka aplikasi sampel Klien Uji Rencana Perjalanan menggunakan pintasan yang dibuat selama Prasyarat untuk Aktivitas Pengembangan (C:\HowTos\ESB.Itinerary.Test.exe - Pintasan).

  2. Di Klien Uji Rencana Perjalanan, kosongkan kotak centang Gunakan Layanan WCF , lalu klik Muat Rencana Perjalanan.

  3. Dalam kotak dialog Buka File Rencana Perjalanan , telusuri ke C:\HowTos\Itineraries. Pilih LdapResolution.xml, lalu klik Buka untuk memuat rencana perjalanan.

  4. Klik OK untuk menghapus pesan Itinerary Loaded Successfully .

  5. Di Klien Uji Rencana Perjalanan, klik tombol elipsis (...) di samping kotak Muat Pesan .

  6. Dalam kotak dialog Pilih Dokumen XML untuk memuat , telusuri ke C:\HowTos. Pilih NAOrderDoc.xml, lalu klik Buka untuk memuat pesan pengujian.

  7. Klik tombol Kirim Permintaan . Setelah pengujian selesai, klik OK untuk menutup konfirmasi yang muncul.

  8. Buka Microsoft Outlook Express (atau klien email pilihan Anda) dan verifikasi pengiriman pesan ke email John Evans.

Sumber Daya Tambahan

Untuk informasi selengkapnya, lihat topik terkait berikut ini: