HTTPSolicitResponse
Sampel HTTPSolicitResponse menunjukkan cara membuat orkestrasi Microsoft BizTalk Server yang memanfaatkan aplikasi ASP.NET untuk membantu memproses data orkestrasi. Dalam sampel ini, orkestrasi menggunakan port permintaan/respons untuk mengirim pesan ke aplikasi ASP.NET dan untuk mengambil respons. Anda mencapai integrasi antara orkestrasi BizTalk Server dan aplikasi ASP.NET dengan menggunakan adaptor HTTP. Untuk informasi selengkapnya, lihat Adaptor HTTP.
Sampel ini terdiri dari orkestrasi BizTalk Server yang menerima permintaan yang berisi dua angka yang akan dikalikan, dan memenuhi permintaan tersebut menggunakan urutan langkah-langkah berikut:
Orkestrasi BizTalk Server mengambil file input .xml dari folder tertentu.
Orkestrasi menggunakan permintaan HTTP untuk meneruskan XML dari file ke aplikasi ASP.NET pengali.
Pengali ASP.NET aplikasi merespons permintaan HTTP dengan melakukan perkalian dan mengembalikan hasilnya sebagai XML dalam respons HTTP.
Orkestrasi menerima hasilnya sebagai XML dalam respons HTTP, dan menulis yang menghasilkan file .xml di folder tertentu.
<Jalur> Sampel\AdaptersUsage\HTTPSolicitResponse
Tabel berikut ini memperlihatkan file dalam sampel ini dan menjelaskan tujuannya.
File | Deskripsi |
---|---|
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. |
HttpSolicitResponse.btproj, HttpSolicitResponse.sln | Menyediakan file proyek dan sumber untuk proyek BizTalk yang berisi orkestrasi yang menggunakan aplikasi ASP.NET pengali, skema terkait, dan sebagainya. |
HttpSolicitResponseBinding.xml | Menyediakan penyiapan otomatis seperti pengikatan port. |
MultiplyRequest.xsd, MultiplyResponse.xsd | Menyediakan skema untuk permintaan perkalian dan pesan XML respons. |
MultiplyTwoIntegers.odx | Menyediakan orkestrasi BizTalk Server yang menerima file .xml yang meminta operasi perkalian, meneruskan permintaan ke aplikasi ASP.NET pengali, dan menulis responsnya ke file. |
request_in.xml | Contoh file input. |
Setup.bat | Menyusun dan menginisialisasi sampel ini. |
Di folder \Pengali: Multiplier.aspx, Multiplier.aspx.cs, Multiplier.sln |
Berisi file yang merupakan aplikasi ASP.NET yang mengimplementasikan layanan pengali, termasuk file proyek dan solusi, file ASPX, file sumber .NET Microsoft Visual C#, dan sebagainya. |
Gunakan prosedur berikut untuk membangun dan menginisialisasi sampel HTTPSolicitResponse.
Catatan
Sampel ini tidak berfungsi jika nama lokasi penerima berisi karakter huruf besar apa pun.
Di jendela perintah, navigasikan ke folder berikut:
<Jalur> Sampel\AdaptersUsage\HTTPSolicitResponse
Jalankan file Setup.bat, yang melakukan tindakan berikut:
Membuat folder input dan output untuk sampel ini:
<Jalur> Sampel\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseInput
<Jalur> Sampel\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseOutput
Mengkompilasi dan mengonfigurasi aplikasi ASP.NET pengali yang digunakan oleh sampel ini.
Catatan
Saat membuat kumpulan aplikasi di IIS Manager, atur versi .NET Framework DefaultAppPool ke .Net Framework v4.0.
Mengkompilasi dan menyebarkan orkestrasi BizTalk Server yang digunakan dalam sampel ini.
Membuat dan mengikat lokasi dan port penerimaan BizTalk Server yang diperlukan.
Catatan
Sampel ini menampilkan peringatan berikut saat membuat dan mengikat port:
Catatan
Warning: Receive handler not specified for receive location "HttpSolicitResponseReceiveLocation"; updating with first receive handler with matching transport type.
Catatan
Warning: Host not specified for orchestration "Microsoft.Samples.BizTalk.HttpSolicitResponse.MultiplyTwoIntegers"; updating with first available host.
Mengaktifkan lokasi terima, dan memulai port pengiriman.
Catatan
Orkestrasi dalam sampel ini menggunakan port dua arah untuk interaksi HTTP dengan aplikasi ASP.NET.
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. Anda harus menjalankan Cleanup.bat sebelum menjalankan Setup.bat untuk kedua kalinya.
Gunakan prosedur berikut untuk menjalankan sampel HTTPSolicitResponse.
Tempel salinan file request_in.xml ke folder HttpSolicitResponseInput.
Amati file .xml yang dibuat di folder HttpSolicitResponseOutput. Nama file .xml ini didasarkan pada GUID ID pesan. File ini berisi hasil yang diformat XML dari operasi perkalian.
Catatan
Anda dapat mengubah nilai operand dalam file input untuk melakukan operasi perkalian yang berbeda.
Anda dapat menyesuaikan sampel ini untuk berkomunikasi dengan sistem eksternal berbeda yang mengekspos antarmuka HTTP.
File MultiplyRequest.xsd dan MultiplyResponse.xsd adalah skema XML yang menentukan format data input dan output untuk aplikasi ASP.NET pengali. Orkestrasi menggunakan file-file ini untuk menentukan jenis pesan permintaan dan respons.