Cara Mengonfigurasi Lokasi Penerimaan HTTP

Anda dapat mengatur variabel adaptor lokasi penerima HTTP baik secara terprogram atau dengan menggunakan konsol Administrasi BizTalk Server. Jika properti tidak diatur di lokasi terima, nilai handler penerima default yang diatur di konsol Administrasi BizTalk Server digunakan.

Nota

Sebelum menyelesaikan prosedur berikut, Anda harus sudah menambahkan port penerima. Untuk informasi selengkapnya, lihat Cara Membuat Port Penerima.

Cara Mengonfigurasi Lokasi PenerimaAN HTTP Secara Terprogram

Adaptor HTTP menyimpan informasi konfigurasinya dalam database BizTalk Management (juga dikenal sebagai database Konfigurasi). Konfigurasi disimpan dalam tas properti XML kustom.

Model objek BizTalk Explorer mengekspos antarmuka konfigurasi IReceiveLocation , yang memiliki properti baca/tulis TransportTypeData . Properti ini menerima kumpulan properti konfigurasi lokasi penerimaan HTTP dalam bentuk string XML pasangan nama-nilai.

Mengatur properti TransportTypeData dari IReceiveLocation tidak diperlukan. Jika tidak diatur, nilai default untuk konfigurasi lokasi penerima HTTP digunakan. Tabel berikut mencantumkan nilai default, dan juga mencantumkan properti konfigurasi yang bisa Anda atur dalam model objek BizTalk Explorer untuk lokasi penerima HTTP.

Nama properti	Tipe	Deskripsi	Pembatasan	Komentar
ResponseContentType	benang	Tipe isi pesan respons HTTP yang dikirim adaptor HTTP kembali ke klien dari lokasi penerimaan ini. Properti ini hanya valid untuk port penerima permintaan-respons dan diabaikan untuk port penerima satu arah.	string Panjang minimum: 0 Panjang maksimum: 256	Nilai default: Teks/XML
Loopback	Boolean (tipe data yang hanya memiliki dua nilai: true atau false)	Menentukan bahwa pesan permintaan yang diterima di lokasi ini akan dirutekan baik ke port kirim atau kembali ke lokasi terima untuk dikirim sebagai respons. Properti ini hanya valid untuk port penerima permintaan-respons. Ini diabaikan untuk port penerima satu arah.	Tidak ada	Nilai default: Palsu
ReturnCorrelationHandle	Boolean (tipe data yang hanya memiliki dua nilai: true atau false)	Menentukan bahwa token korelasi dari pesan yang dikirimkan akan diteruskan oleh adaptor HTTP pada respon HTTP ke klien jika pengiriman berhasil. Properti ini hanya berlaku untuk port penerima satu arah dan diabaikan untuk port penerima permintaan-respons.	Tidak ada	Nilai default: Benar
TangguhkanPermintaanYangGagal	Boolean (tipe data yang hanya memiliki dua nilai: true atau false)	Menentukan apakah akan menangguhkan permintaan HTTP yang gagal. Nilai True menunjukkan untuk menangguhkan permintaan yang gagal dan mengirim kode status "Diterima" (202) ke klien untuk port penerima satu arah atau kode status "Kesalahan" (500) ke klien untuk port penerima dua arah.	Tidak ada	Nilai default: Palsu
UseSSO	Boolean (tipe data yang hanya memiliki dua nilai: true atau false)	Menentukan apakah adaptor HTTP akan mengeluarkan tiket SSO ke pesan yang tiba di lokasi penerimaan ini.	Tidak ada	Nilai default: Palsu

Format string XML untuk mengatur properti ini adalah sebagai berikut:

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>  

Cara Mengonfigurasi Lokasi Penerimaan HTTP dengan Konsol Administrasi BizTalk Server

Untuk mengonfigurasi lokasi terima dengan menggunakan konsol Administrasi BizTalk Server, gunakan prosedur berikut.

Untuk mengonfigurasi variabel untuk lokasi penerimaAN HTTP

1. Konfigurasikan Layanan Informasi Internet (IIS) untuk bekerja dengan lokasi penerima HTTP. Untuk petunjuk tentang mengonfigurasi IIS, lihat Cara Mengonfigurasi IIS untuk Lokasi PenerimaAN HTTP.

2. Di konsol Administrasi BizTalk Server, perluas BizTalk ServerAdministration, perluas BizTalk Group, perluas Aplikasi, lalu perluas aplikasi tempat Anda ingin membuat lokasi penerima.

3. Di panel kiri, klik simpul Penerimaan Ports. Kemudian di panel kanan, klik kanan port terima yang terkait dengan lokasi penerima yang sudah ada atau yang ingin Anda kaitkan dengan lokasi penerimaan baru, lalu klik Properti.

4. Dalam kotak dialog Properti Port Penerimaan, di panel kiri, pilih Lokasi Penerimaan, dan di panel kanan, klik ganda lokasi penerimaan yang sudah ada atau klik Baru untuk membuat lokasi penerimaan baru.

5. Dalam kotak dialog Terima Properti Lokasi , di bagian Transportasi di samping Jenis, pilih HTTP dari daftar drop-down lalu klik Konfigurasikan.

6. Dalam kotak dialog Properti Transportasi HTTP , lakukan hal berikut:

   Gunakan ini	Untuk melakukan ini
   Direktori virtual ditambah ekstensi ISAPI	Tentukan nama direktori virtual tempat Anda memposting pesan yang diterima oleh lokasi penerima HTTP/HTTPS. Direktori virtual menyertakan nama DLL lokasi penerima dan string kueri opsional. Contoh nama direktori virtual adalah: /<virtual directory>/BTSHTTPReceive.dll /<virtual directory>/BTSHTTPReceive.dll? Beli%20Order Lokasi ini tidak boleh berisi lebih dari satu ekstensi ISAPI BTSHTTPReceive.dll, termasuk semua subfolder. Jenis: String Panjang maksimum: 256 Catatan: URI untuk port kirim atau lokasi terima tidak boleh melebihi 256 karakter.
   Alamat Publik	Tentukan URI yang sepenuhnya memenuhi syarat untuk lokasi penerima ini. Nilai untuk properti ini adalah kombinasi dari nama server dan direktori virtual. BizTalk Messaging Engine mengekspos alamat ini ke mitra eksternal. URI yang ditentukan harus menunjuk URL situs Web publik untuk disambungkan oleh mitra dagang saat mengirim pesan ke BizTalk Server. Informasi ini bersifat opsional dan tidak digunakan oleh BizTalk Server. Parameter ini tersedia untuk memungkinkan administrator mendokumen URL publik tempat lokasi penerima terikat. Jenis: String Panjang minimum: 0 Panjang maksimum: 256
   Mengembalikan tipe isi	Tentukan tipe konten pesan respons HTTP yang dikirim kembali lokasi penerima ke klien. Properti ini hanya berlaku untuk lokasi penerimaan permintaan-tanggapan. Nilai default: teks/xml Jenis: String Panjang minimum: 0 Panjang maksimum: 256
   loopback	Tentukan bahwa pesan permintaan yang diterima di lokasi ini dirutekan ke port kirim atau dikembalikan ke lokasi terima ini untuk dikirim sebagai respons. Properti ini hanya berlaku untuk lokasi penerimaan permintaan-tanggapan. Nilai default: Palsu Jenis: Boolean
   Mengembalikan handle korelasi jika berhasil (Hanya untuk port satu arah)	Tentukan bahwa jika berhasil, lokasi terima mengirimkan token korelasi pesan yang dikirimkan pada respons HTTP ke klien. Properti ini hanya berlaku untuk lokasi penerimaan satu arah. Nilai default: Benar Jenis: Boolean
   Gunakan Single Sign On	Tunjukkan bahwa Enterprise Single Sign-On digunakan. Nilai default: Palsu Jenis: Catatan Boolean : Jika opsi ini diaktifkan, Anda juga harus mengaktifkan opsi untuk Mengizinkan Tiket di tingkat Sistem SSO . Opsi Izinkan Tiket dapat dikonfigurasi pada tab Opsi dari kotak dialog Properti Sistem SSO yang tersedia di antarmuka MMC Administrasi SSO . Jika opsi ini diaktifkan dan opsi Izinkan Tiket di tingkat Sistem SSO tidak diaktifkan, pesan apa pun yang diterima oleh lokasi penerima ini akan ditangguhkan.
   Menangguhkan Permintaan yang Gagal	Menunjukkan apakah akan menangguhkan permintaan HTTP yang gagal diproses masuk atau tidak. Nilai False menunjukkan untuk membuang permintaan yang gagal dan mengirim kode status kesalahan (401 atau 500) ke klien. Nilai True menunjukkan untuk menangguhkan permintaan yang gagal dan mengirim kode status "Diterima" (200) ke klien untuk port penerima satu arah atau kode status "Kesalahan" (500) ke klien untuk port penerima dua arah. Nilai default: Palsu Jenis: Boolean

7. Klik OK untuk menyimpan pengaturan.

8. Masukkan nilai yang sesuai dalam kotak dialog Terima Properti Lokasi untuk menyelesaikan konfigurasi lokasi terima dan klik OK untuk menyimpan pengaturan. Untuk informasi tentang kotak dialog Properti Lokasi Penerimaan, lihat Cara Membuat Lokasi Penerimaan.

   Saat klien HTTP memanggil Lokasi HTTP, adaptor HTTP mengautentikasi klien HTTP dengan menggunakan autentikasi Anonim, Dasar, Hash, atau Windows Terintegrasi. Jika pengguna diverifikasi, konteks pengguna diteruskan ke handler penerima.

Nota

Konfigurasi IIS apa pun yang mengarah ke SOAP dan HTTP yang berbagi proses yang sama tidak valid. Anda hanya dapat memiliki satu penerima terisolasi per proses.