Menggunakan Komponen Alur untuk Membaca Rencana Perjalanan

Pesan yang tiba dalam alur penerima dapat berisi metadata di header SOAP-nya yang menentukan persyaratan pemrosesannya (rencana perjalanan sisi klien). Gambar 1 mengilustrasikan penggunaan komponen alur Rencana Perjalanan ESB dan Dispatcher ESB.

Gambar 1

Contoh komponen alur Rencana Perjalanan ESB

Komponen alur Rencana Perjalanan ESB dapat digunakan untuk mengambil metadata dari pesan sebagai properti konteks yang dapat menentukan pemrosesan yang diterapkan oleh ESB.

Bagian berikut menjelaskan langkah-langkah yang dilakukan oleh setiap komponen.

Langkah-langkah Proses Komponen Pipeline Itinerary ESB

Dalam contoh yang ditunjukkan pada Gambar 1, komponen alur Rencana Perjalanan ESB menjalankan langkah-langkah berikut:

• Ini membaca header SOAP rencana perjalanan. Pihak yang mengirimkan menetapkan rencana perjalanan dengan mengisi header SOAP ketika dia mengirimkan pesan. Serangkaian properti konteks pesan BizTalk mewakili header SOAP; properti ini bervariasi, tergantung pada jenis adaptor layanan Web yang digunakan. Berikut ini adalah adaptor layanan Web yang relevan:

  • Adapter WCF. Adaptor ini mengurai header SOAP dan mengisi properti konteks pesan BizTalk yang tercantum dalam tabel berikut.

    Karakteristik
    Nama = Rencana Perjalanan
    Namespace = http://schemas.microsoft.biztalk.practices.esb.com/itinerary

    Nota

    Secara default, adaptor Windows Communication Foundation (WCF) menggunakan nama akar skema bernama ItineraryDescription.xsd (skema ini digunakan untuk menghasilkan header SOAP Rencana Perjalanan ESB) sebagai argumen Nama konteks BizTalk, dan menggunakan namespace layanan target skema sebagai argumen Namespace konteks BizTalk.

  • Adaptor SOAP Adaptor ini mengurai header SOAP dan mengisi properti konteks pesan BizTalk yang tercantum dalam tabel berikut.

    Karakteristik
    Nama = Rencana Perjalanan
    Namespace = http://schemas.microsoft.com/BizTalk/2003/SOAPHeader

    Nota

    Secara default, Adaptor SOAP menggunakan nama akar skema bernama Itinerary.xsd (skema ini digunakan untuk menghasilkan header SOAP Itinerary ESB) sebagai argumen Nama konteks BizTalk, dan menggunakan namespace header SOAP sebagai argumen Namespace konteks BizTalk.

• Ini menghapus nilai rencana perjalanan asli dari konteks pesan.

• Ini memvalidasi rencana perjalanan dan mengatur properti tertentu ke nilai default jika null dalam rencana perjalanan; misalnya:

  • Jika Jumlah layanan kurang dari 1, komponen akan melemparkan pengecualian.

  • Komponen mengatur atribut akar rencana perjalanan menggunakan nilai untuk jumlah Layanan, pengidentifikasi (Uuid), waktu mulai (BeginTime), dan apakah ini adalah permintaan satu arah atau dua arah (IsRequestResponse).

  • Komponen memvalidasi layanan, mengatur pengidentifikasi, mengatur instans layanan saat ini (layanan untuk diproses berikutnya), dan memvalidasi penyelesai terkait.

  • Komponen mengatur Segmen BizTalk dari rencana perjalanan menggunakan properti berikut:

    • correlationToken

    • reqRespTransmitPipelineID

    • interchangeId

    • receiveInstanceId

    • epmRRCorrelationToken

  • Komponen menulis rencana perjalanan yang dimodifikasi ke properti konteks pesan BizTalk yang tercantum dalam tabel berikut menggunakan properti yang ditentukan dalam skema System-Properties.xsd.

    Karakteristik
    Nama = ItineraryHeader
    Namespace = http://schemas.microsoft.biztalk.practices.esb.com/itinerary/system-properties

  • Komponen mempromosikan empat properti konteks BizTalk yang tercantum dalam tabel berikut menggunakan nilai yang ditentukan dalam skema System-Properties.xsd.

    Harta benda	Nilai
    ServiceName	Nama instans layanan saat ini yang ditentukan dalam rencana perjalanan.
    ServiceType	Atur ke Orkestrasi atau Pesan
    IsRequestResponse	Atur ke Benar atau Salah
    ServiceState	Atur ke Tertunda

Langkah-langkah Proses Komponen Alur Dispatcher ESB

Dalam contoh yang ditunjukkan pada Gambar 1, komponen alur ESB Dispatcher menjalankan langkah-langkah berikut:

• Ini mengelola eksekusi langkah-langkah rencana perjalanan jenis Olahpesan dan memajukan rencana perjalanan. Komponen Dispatcher ESB sadar lokasi dan menjalankan logika berdasarkan lokasinya dalam siklus pemrosesan pesan, yang dapat berupa Terima Masuk, Kirim Kirim, Kirim Masuk, atau Terima Keluar. Komponen alur ESB Dispatcher memanggil layanan pesan rencana perjalanan ESB yang ditentukan dalam file Esb.config. Secara default, properti konfigurasi komponen ini untuk perutean dan transformasi dikaitkan dengan layanan berikut:

  • Microsoft.Practices.ESB.Services.Transform. Layanan ini menjalankan peta BizTalk terhadap payload pesan masuk. Layanan ini memvalidasi persyaratan transformasi dan memperbarui properti konteks BizTalk yang berisi nama spesifikasi dokumen dan jenis pesan. Dispatcher ESB menjalankan layanan ini hanya jika nama ini adalah nama layanan transformasi yang tertera pada properti terkait dari komponen jalur Dispatcher ESB.

  • Microsoft.Practices.ESB.Services.Routing.Layanan ini menggunakan Resolver dan Adapter Provider Framework untuk mengatur informasi perutean titik akhir yang sesuai. Dispatcher ESB menjalankan layanan ini hanya jika ini adalah nama layanan perutean seperti yang muncul di properti yang sesuai dari komponen pipeline Dispatcher ESB.