Bagikan melalui

Adaptor HTTP (Sampel BizTalk Server)

  • Artikel

Sampel Adapter HTTP menunjukkan cara mengimplementasikan paradigma komunikasi permintaan/respons dan ajakan/respons yang digunakan di BizTalk Server.

Tempat Menemukan Sampel Ini

<Samples Path>\AdaptersDevelopment\HttpAdapter\

Tabel berikut ini memperlihatkan file dalam sampel ini dan menjelaskan tujuannya.

File Deskripsi
\Design-Time\Adapter Management Berisi proyek yang mengimplementasikan bagian waktu desain adaptor ini.
\Run-Time\HttpReceive Berisi proyek yang mengimplementasikan pola komunikasi adaptor permintaan/respons. Ini adalah penerima yang terisolasi.
\Run-Time\HttpSend Berisi proyek yang mengimplementasikan pola komunikasi adaptor ajakan/respons.

Cara Menggunakan Sampel Ini

Sampel ini dimaksudkan sebagai kerangka kerja untuk Anda gunakan dalam mengembangkan adaptor kustom. Dalam beberapa kasus, BizTalk Server mungkin perlu mengangkut pesan ke aplikasi kustom tertentu atau menggunakan protokol yang adaptor aslinya tidak ada. Perusahaan pihak ketiga telah menulis adaptor untuk mendukung protokol tambahan. Anda mungkin ingin menentukan apakah ada adaptor untuk protokol Anda sebelum memutuskan untuk menulis adaptor kustom. Jika Anda tidak dapat menemukan adaptor untuk mendukung persyaratan komunikasi, Anda dapat mengembangkan adaptor kustom Anda sendiri.

Menulis adaptor kustom bisa menjadi latihan yang menantang. Untuk menyederhanakan proses ini, Microsoft telah mengembangkan fondasi yang disebut Kerangka Kerja Adapter. Anda dapat menggunakan kerangka kerja ini sebagai dasar untuk pengembangan Anda bersama dengan sampel kode sumber adaptor di BizTalk Server SDK. Untuk informasi selengkapnya tentang adaptor kustom, dan Kerangka Kerja Adapter, silakan lihat bagian Lihat Juga di akhir dokumen ini.

Membangun dan Menginisialisasi Adapter Sampel

Penting

Jika penginstalan BizTalk adalah 64-bit atau lokasi penginstalan dimodifikasi, OutboundAssemblyPath, InboundAssemblyPath, AdapterMgmtAssemblyPath perlu diubah.

Untuk membangun dan menginisialisasi sampel Adapter HTTP

  1. Di jendela perintah, navigasikan ke folder berikut:

    < Jalur> Sampel\AdaptersDevelopment\HttpAdapter

  2. Jalankan Setup.bat file, yang melakukan tindakan berikut:

    • Mengkompilasi HTTPAdapter dan semua dependensinya.

    • Membuat aplikasi Internet Information Services (IIS) yang digunakan oleh sisi penerima adaptor.

    Pada IIS 7.0, Anda harus memastikan identitas kumpulan aplikasi yang menjalankan aplikasi IIS ini adalah anggota grup berikut:

  • Grup Pengguna Host Terisolasi BizTalk.

  • IIS_WPG grup.

  • Pada IIS 7.0, Anda harus memigrasikan aplikasi untuk bekerja dengan mode .NET Terintegrasi. Anda dapat memigrasikan konfigurasi aplikasi, termasuk konten <bagian konfigurasi httpHandlers> , dengan menggunakan yang berikut dari jendela baris perintah (jendela harus berjalan sebagai Administrator):

    %systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"

  • Setelah Anda memigrasikan aplikasi, aplikasi akan berjalan dalam mode Klasik dan Terintegrasi .NET, serta pada platform downlevel.

Catatan

Anda harus mengonfirmasi bahwa tidak ada kesalahan yang dilaporkan 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.

Mendaftarkan Adapter Sampel

Untuk mendaftarkan sampel Adapter HTTP

  1. Di Windows Explorer, navigasikan ke drive penginstalan untuk BizTalk Server, lalu navigasikan ke <Jalur Sampel>\AdaptersDevelopment\HTTPAdapter.

  2. Untuk menambahkan adaptor sampel ke registri, klik dua kali HTTP. NET.reg.

    Catatan

    HTTP. NET.reg menyertakan jalur yang dikodekan secara permanen ke direktori penginstalan BizTalk Server. Jika Anda tidak menginstal BizTalk Server di lokasi default atau jika Anda meningkatkan penginstalan BizTalk Server dari versi BizTalk Server sebelumnya, Anda harus mengubah HTTP file. NET.reg dengan jalur yang sesuai. Perbarui jalur yang terkait dengan nilai "OutboundAssemblyPath" dan "AdapterMgmtAssemblyPath" untuk menunjuk ke lokasi yang benar dari file yang ditentukan.

    Penting

    Jika Anda menginstal BizTalk pada komputer 64 bit, ubah semua instans entri registri HKEY_CLASSES_ROOT\CLSID\ ke HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ di HTTP. File registri NET.reg .

  3. Dalam kotak dialog Editor Registri , klik Ya untuk menambahkan adaptor sampel ke registri, lalu klik OK.

  4. Untuk menutup Windows Explorer, pada menu File , klik Tutup.

Menginstal Adapter Sampel

Untuk menginstal sampel Adapter HTTP

  1. Klik menu Mulai , pilih Semua Program, pilih Microsoft BizTalk Server 20xx, lalu pilih Administrasi BizTalk Server.

  2. Di konsol Administrasi BizTalk Server, perluas pohon Administrasi BizTalk Server, lalu perluas pohon BizTalk Group , lalu perluas pohon Pengaturan Platform .

  3. Klik kanan Adapter, klik Baru, lalu klik Adapter.

  4. Dalam kotak dialog Properti Adapter , lakukan hal berikut ini.

    Gunakan ini Untuk melakukan ini
    Nama Ketik HTTP.NET.
    Adaptor Pilih HTTP.NET dari daftar drop-down.
    Deskripsi Ketik Sampel HTTP.NET Adapter.

  5. Klik OK.

  6. Adaptor sekarang muncul dalam daftar adaptor di jendela kanan konsol Administrasi BizTalk.

Menghentikan dan Memulai Ulang Instans Host

Untuk menghentikan dan memulai ulang instans host untuk sampel Adapter HTTP

  1. Klik menu Mulai , pilih Semua Program, pilih Microsoft BizTalk Server 20xx, dan pilih Administrasi BizTalk Server.

  2. Di konsol Administrasi BizTalk Server, perluas pohon Administrasi BizTalk Server, lalu perluas Pengaturan Platform, dan klik Instans Host.

  3. Di panel hasil, klik kanan instans host (biasanya, nama komputer), lalu klik Hentikan.

    Status instans host berubah menjadi Dihentikan.

  4. Di panel hasil, klik kanan instans host, lalu klik Mulai.

    Adaptor HTTP.NET sekarang siap digunakan oleh aplikasi Anda. Saat mengonfigurasi adaptor, format untuk properti transportasi Direktori Virtual adalah formulir: /httpreceive/httpreceive.aspx?optionalQueryString.

Komentar

Adaptor HTTP.NET menggunakan kelas BaseAdapter yang disediakan dalam <Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0.. 2\. Kelas yang disediakan dalam proyek BaseAdapter dimaksudkan untuk mempercepat pengembangan adaptor. Lihat komentar kode BaseAdapter untuk detail tentang kelas yang disediakan.

Lihat juga

Mendaftarkan Adapter
Sampel Adapter - Penggunaan
Mengembangkan Adaptor Kustom
Apa itu Kerangka Kerja Adapter?
Menggunakan Alat Kerangka Kerja Adapter
Mengembangkan Adapter Penerima
Mengembangkan Adapter Kirim
Cara Menyebarkan Adapter Kustom
Tips untuk Merancang Adapter Anda
Konfigurasi Design-Time Adapter