Bagikan melalui


Adaptor BizTalk untuk Konfigurasi File Host

Gambaran Umum

Adaptor BizTalk untuk File Host adalah adaptor kirim dan terima yang memungkinkan orkestrasi BizTalk berinteraksi dengan sistem host. Secara khusus, adaptor memungkinkan operasi kirim dan terima melalui koneksi TCP/IP dan APPC ke file host yang berjalan pada platform mainframe dan IBM i. Berdasarkan teknologi Host Integration Server, adaptor menggunakan rakitan metadata Pustaka Akses Data untuk mengonfigurasi koneksi, dan penyedia data Microsoft .NET Framework untuk file host untuk mengeluarkan perintah SQL dan prosedur tersimpan.

Adaptor melayani dua fungsi utama:

  • Untuk operasi Kirim (Baik One Way maupun Solicit Response), adaptor mengirim perintah SQL dan perintah sistem ke instans file host, dengan opsi meminta respons.

  • Untuk Operasi penerimaan (hanya Satu Arah) adaptor membuat perintah SQL yang melakukan polling objek file host dan membuat pesan per baris, yang kemudian dikirimkan ke sistem pesan BizTalk.

    Selain itu, Adaptor BizTalk untuk File Host menggunakan alat pelacakan BizTalk Adapter standar sebagai mekanisme pemecahan masalah.

Catatan

Adaptor BizTalk untuk File Host adalah adaptor non-transaksi. Ini berarti bahwa setelah tindakan dilakukan, tindakan tidak dapat dibatalkan atau digulung balik.

Membuat rakitan metadata

Setelah menginstal adaptor, Anda dapat membuat rakitan metadata yang menjelaskan sistem jarak jauh Anda ke BizTalk Server.

Bagian dari proses pembuatan aplikasi File Host di Visual Studio adalah menjelaskan tata letak sistem file host. Proses ini membuat rakitan metadata dan skema. Rakitan metadata adalah representasi terprogram dari sistem file host jarak jauh, sedangkan skema adalah representasi XML dari sistem file host. Anda akan menggunakan rakitan metadata untuk menjelaskan sistem file host ke BizTalk Server.

Untuk informasi selengkapnya tentang cara membuat aplikasi File Host di Visual Studio, lihat Membuat Aplikasi dengan Penyedia Data Terkelola untuk File Host.

Membuat port kirim

Masuk dengan akun yang merupakan anggota grup Administrator BizTalk Server.

  1. Di Administrasi BizTalk Server, perluas BizTalk Group, perluas Aplikasi, lalu pilih aplikasi Anda.

  2. Klik kanan Kirim Port, pilih Baru, lalu pilih Port Kirim Satu Arah Statis atau Port Kirim Respons Ajakan.

  3. Di Kirim Properti Port, atur Jenis Transportasi ke File Host. Pilih Konfigurasikan, dan masukkan properti berikut ini:

    Gunakan ini Untuk melakukan ini
    String Koneksi Nama string koneksi yang digunakan untuk menyambungkan ke database File Host.

    Untuk mengonfigurasi string koneksi baru atau yang sudah ada, klik elipsis (...). Ini memulai Panduan Sumber Data. Untuk mengakses Bantuan, klik Bantuan pada halaman wizard, atau buka Bantuan Server Integrasi Host dan lihat di Panduan Sumber Data (File Host).
    Namespace Target Dokumen Namespace layanan target yang digunakan dalam dokumen XML yang dikirim ke host.
    Nama Elemen Akar Respons Nama elemen akar yang digunakan dalam dokumen XML yang diterima dari host. (Properti ini mungkin kosong untuk port satu arah.)
    URI Pengidentifikasi sumber daya seragam. Nama untuk mengidentifikasi lokasi port pengiriman.
  4. Pilih OK untuk menyimpan perubahan Anda.

  5. Untuk Pengirim Handler, pilih instans host untuk menjalankan adaptor, dan pilih Kirim Alur.

  6. Pilih OK untuk menyimpan perubahan Anda.

  7. Di Port Kirim, klik kanan port kirim baru Anda, dan pilih Daftarkan lalu Mulai.

Membuat port dan lokasi penerima

Masuk dengan akun yang merupakan anggota grup Administrator BizTalk Server.

  1. Di Administrasi BizTalk Server, perluas BizTalk Group, perluas Aplikasi, lalu pilih aplikasi Anda.

  2. Klik kanan Terima Port, pilih Baru, lalu pilih Port Terima Satu Arah Statis. Konfigurasikan Properti Port Penerimaan Anda, dan pilih OK untuk menyimpan perubahan Anda.

  3. Klik kanan Terima Lokasi, pilih Baru, lalu pilih Lokasi Terima Satu Arah. Pilih port terima yang Anda buat, lalu OK.

  4. Di Properti Lokasi Terima, atur Jenis Transportasi ke HostFiles. Pilih Konfigurasikan, dan masukkan properti berikut ini:

    Gunakan ini Untuk melakukan ini
    String Koneksi Masukkan nama string koneksi yang akan digunakan untuk menyambungkan ke database host.

    Untuk mengonfigurasi string koneksi baru atau yang sudah ada, klik elipsis (...). Ini memulai Panduan Sumber Data. Untuk mengakses Bantuan, klik Bantuan pada layar wizard, atau buka Bantuan Server Integrasi Host dan lihat di Panduan Sumber Data (File Host).

    Saat mengonfigurasi lokasi terima atau mengirim port berdasarkan Adapter BizTalk untuk File Host, definisi metadata harus dibuat sebagai file metadata Host Integration Designer XML (HIDX) untuk mengodekan dan mendekode rekaman. Untuk petunjuk tentang cara membuat file HIDX, lihat Membuat Aplikasi dengan Penyedia Data Terkelola untuk File Host.
    Nama Elemen Akar Dokumen Nama elemen akar yang digunakan dalam dokumen XML yang diterima dari host.
    Namespace Target Dokumen Namespace layanan target yang digunakan dalam dokumen XML yang diterima dari host.
    Perintah SQL Perintah Pilih yang dijalankan satu kali untuk setiap interval polling.
    Perbarui Perintah Perintah yang dijalankan setelah setiap baris dalam operasi terima diproses. Ini bisa berupa pernyataan hapus yang menghapus baris dari tabel dalam perintah SQL, atau perintah pembaruan yang secara statis memodifikasi satu atau beberapa baris. Ketika opsi ini ditentukan, perintah SQL harus berupa pernyataan Pilih dan mengakses satu tabel.

    Anda dapat menentukan properti tambahan dengan mengklik tombol elipsis (...). Ini membuka kotak dialog Ubah Perintah , yang menyediakan tiga opsi:

    - Jangan menghapus dua opsi lainnya jika dipilih.
    - Hapus setelah dibaca akan menghapus baris setelah adaptor membacanya.
    - Pembaruan memungkinkan Anda mengetik perintah SQL yang akan diperbarui.
    URI Pengidentifikasi sumber daya seragam. Nama yang mengidentifikasi lokasi port penerima.
    Polling Interval Jumlah unit antara permintaan polling. Rentang yang diizinkan adalah 1 - 65535.
    Satuan Pengukuran Polling Satuan pengukuran (detik, menit, atau jam) yang digunakan di antara permintaan polling. Defaultnya adalah detik.
  5. Pilih OK untuk menyimpan perubahan Anda.

  6. Untuk Handler Penerima, pilih instans host. Handler penerima harus berjalan pada host ini. Pilih Alur Terima Anda.

  7. Pilih OK untuk menyimpan perubahan Anda.

  8. Di Lokasi Terima, klik kanan lokasi terima, dan pilih Aktifkan.

Membuat Skema

Gunakan Wizard Pembuatan Skema File Host untuk membuat skema XSD untuk Adaptor BizTalk untuk File Host. Setelah membuat skema, Anda siap untuk melanjutkan konfigurasi di sisi BizTalk Server.

  1. Buka proyek BizTalk Server Visual Studio Anda.

  2. Klik kanan proyek, pilih Tambahkan, pilih Tambahkan Item yang Dihasilkan, lalu pilih Tambahkan Metadata Adapter.

  3. Di Wizard Tambahkan Adapter, pada halaman Pilih Adapter , pilih File Host, lalu pilih Berikutnya.

  4. Di Wizard Pembuatan Skema Adaptor File Host:

    1. Di Informasi Database, telusuri ke string koneksi yang sudah ada atau buat yang baru.

      Ini dapat berupa Katalog Awal, Koleksi Paket, (Alamat dan Port TCP) atau (LU Lokal APPC, LU Jarak Jauh, dan Mode), (Nama Pengguna dan Kata Sandi), atau (Keamanan Terintegrasi). Panjang maksimum adalah 1024.

    2. Di Informasi Skema, tentukan namespace default, elemen akar, dan jenis port yang ingin Anda gunakan dalam skema.

      Jika Anda memilih Terima port, hanya nama elemen akar dokumen permintaan yang diperlukan. Jika Anda memilih Kirim port, nama elemen akar dokumen permintaan dan respons diperlukan.

    3. Di Informasi Jenis Pernyataan, pilih jenis perintah database yang akan dikeluarkan.

      Jika Anda memilih kirim port di halaman sebelumnya, Anda dapat memilih untuk mengeluarkan updategram, prosedur tersimpan, atau pernyataan SELECT. Jika Anda memilih menerima port, langkah ini tidak perlu.

    4. Di Informasi Pernyataan, masukkan detail tentang file host. Bergantung pada informasi yang sebelumnya Anda masukkan di halaman sebelumnya, masukkan properti berikut ini. Jika Anda memilih kirim port:

      • Kirim Updategram Jika Anda memilih untuk menggunakan port kirim dan updategram, Anda dapat memilih operasi updategram di sini, dan juga tabel dan kolom yang akan ada dalam updategram.

      • Perintah Kirim Sistem Jika Anda memilih untuk menggunakan port kirim dan mengeluarkan prosedur tersimpan, Anda dapat memilih prosedur tersimpan dari katalog koneksi saat ini. Anda tidak perlu memasukkan nilai untuk semua parameter di halaman ini.

      • Kirim Pernyataan Pilih Jika Anda memilih untuk menggunakan port kirim dengan pernyataan SQL Select, Anda dapat memilih atau menelusuri pernyataan di sini.

      Jika Anda memilih menerima port:

      • Terima Pernyataan Pilih Jika Anda memilih untuk menggunakan port penerima dengan pernyataan SQL, Anda dapat memilih atau menelusuri pernyataan di sini.

      • Kirim Updategram Jika Anda memilih untuk menggunakan port kirim dan updategram, Anda dapat memilih operasi updategram di sini, dan juga tabel dan kolom yang akan ada dalam updategram.

      • Kirim Prosedur Tersimpan Jika Anda memilih untuk menggunakan port kirim dan mengeluarkan prosedur tersimpan, Anda dapat memilih prosedur tersimpan dari katalog koneksi saat ini. Anda tidak perlu memasukkan nilai untuk semua parameter di halaman ini.

      • Kirim Pernyataan Pilih Jika Anda memilih untuk menggunakan port kirim dengan pernyataan SQL Select, Anda dapat memilih atau menelusuri pernyataan di sini.

  5. Pilih Selesai setelah selesai.

Membuat Aplikasi BizTalk

Setelah membuat skema, Anda dapat membuat kode aplikasi BizTalk Anda. Aplikasi Anda menggunakan rakitan metadata yang Anda buat di Visual Studio, selain skema dan port yang Anda buat..

  1. Buat proyek BizTalk di Visual Studio.

  2. Gunakan skema yang Anda buat untuk menjelaskan sistem File Host ke aplikasi BizTalk.

  3. Gunakan port kirim yang Anda buat untuk mengirim data ke sistem file host.

  4. Jika perlu, gunakan port penerima dan lokasi yang Anda buat.

  5. Tambahkan orkestrasi, komponen, atau kode tambahan, seperlunya.

  6. Uji aplikasi Anda.

  7. Setelah selesai menguji aplikasi, buat paket .msi untuk memindahkan aplikasi Anda ke pementasan atau server langsung. Saat Anda membuat paket .msi BizTalk Server, pastikan untuk menyertakan rakitan metadata file host yang Anda buat.

Lihat juga

Penyedia Data Terkelola untuk File Host