Bagikan melalui

Adapter File (Sampel BizTalk Server)

  • Artikel

Sampel Adaptor File ditulis dalam Microsoft Visual C# .NET untuk bekerja dengan Microsoft BizTalk Server. Ini menyediakan kode untuk membangun adaptor dinamis atau statis. Namun, prosedur berikut ini hanya menguraikan adaptor statis. Adaptor statis adalah adaptor dengan sekumpulan skema statis dan tanpa antarmuka pengguna kustom. Adaptor dinamis memiliki antarmuka pengguna kustom dan berpotensi menjadi sekumpulan skema dinamis. Adaptor statis dan dinamis menggunakan Wizard Tambahkan Adaptor untuk menambahkan skema mereka ke proyek BizTalk.

Catatan

Sampel adaptor File tidak sama dengan adaptor FILE asli yang dikirim dengan BizTalk Server. Dengan demikian saat memilih jenis transportasi dalam menggunakan sampel ini pilih "statis" alih-alih FILE.

Adaptor dinamis dengan antarmuka pengguna kustom dan set skema yang berpotensi dinamis akan memerlukan kode tambahan di sisi manajemen adaptor. Untuk lebih memahami penggunaan set skema dinamis, lihat Konfigurasi Adaptor Design-Time Dinamis.

Apa fungsi sampel ini

Adaptor sampel menyalin file dari folder file, dikirimkan ke BizTalk sebagai pesan, atau mengambil pesan dari BizTalk Server dan turun ke folder file. Ini menyediakan kode untuk membangun adaptor dinamis atau statis; namun, prosedur berikut hanya menguraikan adaptor statis. Adaptor statis adalah adaptor dengan sekumpulan skema statis dan tanpa antarmuka pengguna kustom. Adaptor dinamis memiliki antarmuka pengguna kustom dan berpotensi menjadi sekumpulan skema dinamis. Adaptor statis dan dinamis menggunakan Wizard Tambahkan Adaptor untuk menambahkan skema mereka ke proyek BizTalk.

Anda dapat menggunakan adaptor file sampel sebagai templat untuk membuat adaptor kustom lainnya.

Tempat Menemukan Sampel Ini

< Jalur> Sampel\AdaptersDevelopment\File Adapter

Catatan

Lokasi default untuk <Jalur> Sampel adalah %ProgramFiles%\Microsoft BizTalk Server\SDK\Samples ketika BizTalk Server diinstal pada komputer yang menjalankan Windows versi 32-bit. Lokasi default untuk <Jalur> Sampel adalah %ProgramFiles(x86)%\Microsoft BizTalk Server\SDK\Samples saat BizTalk Server diinstal pada komputer yang menjalankan Windows versi 64-bit. Untuk menentukan nilai yang terkait dengan variabel lingkungan %ProgramFiles% atau %ProgramFiles(x86)% tipe variabel lingkungan echo %ProgramFiles% atau gema %ProgramFiles(x86)% pada prompt perintah dan tekan ENTER. Jika menjalankan sampel ini pada sistem operasi 64-bit, Anda harus mengubah semua referensi dalam salah satu file .reg dari %ProgramFiles% menjadi %ProgramFiles(x86)% sebelum menjalankan file .reg.

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

\File Adapter file Deskripsi
\BizTalk Project files Berisi proyek harness adaptor, yang digunakan untuk menguji adaptor sampel.
\File Waktu Desain Berisi waktu desain dan proyek manajemen (AdapterManagement.csproj).
\File runtime Berisi salinan file run-time menerima dan mengirimkan proyek (DotNetFile.csproj).
DynamicAdapterManagement.reg Mendaftarkan adaptor dinamis sampel.
Instance.xml File sampel untuk melewati adaptor file.
StaticAdapterManagement.reg Mendaftarkan adaptor statis sampel.
\BizTalk Project\Adapter Harness files Deskripsi
AdapterHarness.odx, AdapterHarness.sln, AdapterHarnessProject.btproj Menyediakan proyek, solusi, dan file terkait untuk proyek BizTalk.
mySchema.xsd Menyediakan skema Instance.xml yang diharapkan oleh orkestrasi harness dari bagian penerima adaptor, serta skema Instance.xml diserahkan ke bagian pengiriman adaptor oleh orkestrasi.
\Design Time\Adapter Management files Deskripsi
AdapterManagement.cs, AdapterManagement.csproj, AdapterManagement.sln Proyek, solusi, dan file terkait untuk waktu desain adaptor.
AssemblyInfo.cs Berisi informasi rakitan untuk sampel ini.
CategorySchema2.xml Tidak digunakan oleh adaptor sampel.
CategorySchema.xml Berisi pohon organisasi layanan untuk adaptor statis.
DotNetFileResource.resx Berisi sumber daya.
ReceiveHandler.xsd, ReceiveLocation.xsd Berisi handler sisi penerima dan skema properti kustom titik akhir
service1.wsdl Berisi definisi operasi untuk adaptor.
TransmitHandler.xsd, TransmitLocation.xsd Berisi handler sisi transmisi dan skema properti kustom titik akhir
\File runtime Deskripsi
DotNetFile.csproj, DotNetFile.sln,

AssemblyInfo.cs,

DotNetFileExceptions.cs, DotNetFileProperties.cs, DotNetFileReceiver.cs, DotNetFileReceiverEndPoint.cs, DotNetFileTransmitter.cs,

DotNetFileTransmitterEndpoint.cs,

DotNetFileAsyncTransmitterBatch.cs,

BatchMessage.cs		 File untuk adaptor kirim dan terima salinan file run-time. Anda dapat mengubah dan menyimpan file-file ini dengan nama baru untuk komponen kustom.

DotNetFile.csproj dan DotNetFile.sln adalah file proyek dan solusi.

AssemblyInfo.cs berisi informasi perakitan untuk sampel ini.

DotNetFileReceiver.cs membaca file dari lokasi terima dan mengirimkannya ke BizTalk Server.

DotNetFileExceptions.cs, mengimplementasikan kode untuk menangani pengecualian selama pemrosesan pesan

DotNetFileProperties.cs, berisi properti umum untuk operasi Terima dan Kirim

BatchMessage.cs, mengimplementasikan olahpesan batch.

DotNetFileReceiverEndPoint.cs, adalah kelas yang terkait dengan Lokasi Penerimaan/URI. Ini menangani polling folder yang diberikan untuk pesan baru

DotNetFileTransmitter.cs adalah kelas singleton untuk adaptor pengiriman DotNetFile. Semua pesan, pergi ke berbagai port kirim dari jenis adaptor ini melewati kelas ini

DotNetFileTransmitterEndpoint.cs, menangani pengiriman pesan.
\SDK\Samples\AdaptersDevelopment\BaseAdapter\v1.0.2 files Deskripsi
Adapter.cs, AdapterException.cs, AsyncTransmitter.cs, batch.cs, ConfigProperties.cs, ControlledTermination.cs, IManageEndpoints.cs, Receiver.cs, ReceiverEndpoint.cs Menyediakan kelas yang merupakan Adaptor Dasar. Anda dapat menggunakannya untuk membuat adaptor Anda sendiri.

Cara Menggunakan Sampel Ini

Gunakan adaptor file sampel sebagai templat untuk membuat adaptor kustom lainnya.

Membangun sampel ini

Penting

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

Gunakan prosedur berikut untuk membangun dan menginisialisasi sampel Adapter File.

Untuk membuat kunci nama yang kuat untuk proyek DotNetFileAdapter dan proyek Base Adapter

  1. Mulai Perintah Visual Studio.

    Catatan

    Jalankan perintah sebagai Administrator.

  2. Ubah direktori saat ini ke < direktori Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0.2.

  3. Pada prompt perintah, ketik sn –k BaseAdapter.snk lalu tekan ENTER. File .snk ini mungkin sudah ada sebagai akibat dari sampel lain yang dijalankan sebelumnya. Jika demikian, Anda dapat langsung ke langkah 4 dan melewati langkah ini.

  4. Ubah direktori saat ini ke < direktori Samples Path>\AdaptersDevelopment\File Adapter\Runtime.

  5. Pada prompt perintah, ketik sn –k DotNetFileAdapter.snk lalu tekan ENTER.

  6. Pada prompt perintah, ketik keluar lalu tekan ENTER untuk menutup jendela prompt perintah.

Untuk membangun proyek run-time penerima

  1. Klik Mulai, arahkan ke Semua Program, arahkan ke Aksesori, lalu klik Windows Explorer.

  2. Navigasi ke < direktori Samples Path>"\AdaptersDevelopment\File Adapter\Runtime", lalu klik dua kali DotNetFile.sln.

  3. Untuk membangun kembali proyek run-time Penerima Adapter, di Penjelajah Solusi, klik kanan DotNetFile, lalu klik Bangun Ulang.

  4. Dari menu File , klik Keluar untuk menutup Visual Studio.

Untuk membangun proyek waktu desain adaptor

  1. Di Windows Explorer, navigasikan ke < direktori Samples Path>"\AdaptersDevelopment\File Adapter\Design Time\Adapter Management", lalu klik dua kali AdapterManagement.sln.

  2. Di Penjelajah Solusi, klik kanan AdapterManagement, lalu klik Bangun Ulang.

  3. Dari menu File , klik Keluar untuk menutup Visual Studio.

Untuk mendaftarkan sampel adaptor statis

  1. Di Windows Explorer, navigasikan ke < direktori Samples Path>"\AdaptersDevelopment\File Adapter".

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

    Catatan

    StaticAdapterManagement.reg menyertakan jalur yang dikodekan secara permanen ke C:\Program Files\Microsoft BizTalk Server\. Jika Anda tidak menginstal BizTalk Server di direktori %ProgramFiles%\Microsoft BizTalk Server\, jika Anda meningkatkan penginstalan BizTalk Server dari BizTalk Server 2009 atau BizTalk Server 2006 R2, atau jika Anda menginstal BizTalk Server di komputer yang menjalankan Windows versi 64-bit, Anda harus mengubah file StaticAdapterManagement.reg dengan jalur yang sesuai. Secara default, BizTalk Server diinstal ke direktori %ProgramFiles(x86)%\Microsoft BizTalk Server\ pada komputer yang menjalankan Windows versi 64-bit. Perbarui jalur yang terkait dengan nilai "InboundAssemblyPath", "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\ menjadi HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ dalam file registri StaticAdapterManagement.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.

Untuk menginstal adaptor statis sampel

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

  2. Di konsol Administrasi BizTalk Server, klik untuk memperluas Administrasi BizTalk Server, klik untuk memperluas Grup BizTalk, dan klik untuk memperluas Pengaturan Platform.

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

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

    Gunakan ini Untuk melakukan ini
    Nama Ketik Statis.
    Adaptor Pilih DotNetFile Statis dari daftar drop-down.
    Komentar Ketik Adapter Sampel.

  5. Klik OK.

    Adaptor statis sekarang muncul dalam daftar adaptor di jendela kanan konsol BizTalk Administration.

Untuk menghentikan dan memulai ulang instans host

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

  2. Di konsol Administrasi BizTalk Server, klik untuk memperluas Administrasi BizTalk Server, klik untuk memperluas Grup BizTalk, klik untuk memperluas Pengaturan Platform dan klik Instans Host. Pilih BizTalkServerApplication di panel kanan.

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

Menjalankan sampel ini

Untuk menjalankan sampel Adapter File

  1. Klik Mulai, arahkan ke Semua Program, arahkan ke Aksesori, lalu klik Windows Explorer.

  2. Buat folder berikut pada drive penginstalan BizTalk Server:

    • <drive>:\Temp

    • <drive>:\Temp\Send

    • <drive>:\Temp\Receive

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

  4. Klik Mulai, arahkan ke Semua Program, arahkan ke Microsoft BizTalk Server 20xx, lalu klik Administrasi BizTalk Server.

  5. Klik kanan simpul Administrasi BizTalk Server dan pilih Sambungkan ke Grup yang Sudah Ada.

  6. Dalam kotak dialog Sambungkan ke Database Konfigurasi BizTalk Server yang Sudah Ada , lakukan hal berikut ini.

    Catatan

    Database BizTalk Management juga disebut sebagai database Konfigurasi BizTalk.

    Gunakan ini Untuk melakukan ini
    SQL Server Ketik . (titik).
    Database Pilih nama database BizTalk Management yang dibuat oleh Panduan Konfigurasi. Nama database default yang digunakan oleh Panduan Konfigurasi adalah BizTalkMgmtDb.

  7. Klik OK.

  8. Perluas simpul BizTalk Group[nama server] di konsol Administrasi BizTalk Server, perluas simpul Aplikasi , perluas simpul Aplikasi BizTalk 1 .

  9. Klik kanan simpul Kirim Port , lalu klik Baru, pilih Statis One-Way Kirim Port, lalu klik OK.

  10. Dalam kotak dialog Kirim Properti Port , pilih Umum, dan lakukan hal berikut ini.

    Gunakan ini Untuk melakukan ini
    Nama Ketik AdapterSend.
    Jenis Transportasi Pilih Statis dari daftar drop-down dan klik Konfigurasikan.

    - Dalam kotak Direktori , ketik <drive>:\Temp\Send.
    - Dalam kotak Mode File , pilih BuatBaru.
    - Dalam kotak Nama File , ketik %MessageID%.xml.
    - Klik OK.
    - Bidang URI harus menampilkan <drive>:\Temp\Send\%MessageID%.xml.
    Kirim alur Pilih PassThruTransmit (Microsoft.BizTalk.DefaultPipelines.PassThruTransmit), lalu klik OK.

  11. Di bawah simpul BizTalk Application 1 klik Terima Port, dan pilih Baru / One-Way Terima Port.

  12. Dalam kotak dialog Buat Port Terima Baru , dalam kotak Tentukan jenis Port Terima , pilih Port Terima Satu Arah dari daftar drop-down, lalu klik OK.

  13. Dalam kotak dialog Terima Properti Port , dalam kotak Nama , ketik AdapterReceive, lalu klik OK.

  14. Di bawah simpul BizTalk Application 1 klik kanan Terima Lokasi, dan pilih Lokasi Penerimaan Baru / Satu Arah.

  15. Dalam dialog Pilih Port Terima , pilih AdapterReceive lalu klik OK.

  16. Dalam kotak dialog Terima Properti Lokasi , lakukan hal berikut ini.

    Gunakan ini Untuk melakukan ini
    Nama Jenis AdapterReceiveLocation
    Jenis Transportasi Pilih Statis dari daftar drop-down dan tekan Konfigurasikan untuk mengakses properti yang tersisa ini.
    URI - Klik tombol elipsis (...).
    - Dalam kotak Jumlah File Dalam Batch , ketik 20.
    - Dalam kotak Direktori , ketik <drive>:\Temp\Receive.
    - Pastikan properti File Mask diatur ke *.xml.
    - Dalam kotak Interval Polling , ketik 5, dan klik OK.
    - Pastikan label URI berisi <drive>:\Temp\Receive\*.xml.
    Handler Penerima Pilih BizTalkServerApplication dari daftar drop-down.
    Alur Penerimaan Pilih XMLReceive dari daftar drop-down.

  17. Klik OK.

    Lanjutkan ke Membangun, Menyebarkan, dan Mengikat Adaptor Sampel.

Membangun, Menyebarkan, dan Mengikat Adaptor Sampel

Sebelum adaptor ditayangkan, Anda harus membangun proyek, mengikat orkestrasi dengan port, dan mendaftarkan adaptor.

Untuk membuat kunci nama yang kuat untuk adaptor statis

  1. Mulai Perintah Visual Studio.

  2. Pada prompt perintah, ubah direktori saat ini ke < direktori Samples Path>\AdaptersDevelopment\File Adapter\BizTalk Project\Adapter Harness.

  3. Pada prompt perintah, ketik sn –k AdapterHarness.snk, lalu tekanENTER.

  4. Klik OK.

Untuk membangun proyek Adapter Harness
  • Di Penjelajah Solusi, klik kanan AdapterHarnessProject, lalu klik Bangun Ulang.
Untuk menyebarkan proyek Adapter Harness

  1. Di Penjelajah Solusi, ketika proyek telah dibangun kembali, klik kanan AdapterHarnessProject, lalu klik Sebarkan.

  2. Di konsol Administrasi BizTalk Server, pilih proyek yang telah Anda sebarkan, lalu klik Refresh.

Untuk mengikat orkestrasi dengan port

  1. Di konsol Administrasi BizTalk Server, di bawah aplikasi BizTalk Server yang sesuai, perluas simpul Orkestrasi .

  2. Klik kanan AdapterHarness.AdapterHarnessType, lalu klik Ikat.

  3. Dalam kotak dialog Properti Pengikatan Port - AdapterHarness.AdapterHarnessType- Konfigurasi Pengikatan , lakukan hal berikut.

    Gunakan ini Untuk melakukan ini
    AdapterFileReceivePort Pilih AdapterReceive dari daftar drop-down.
    AdapterFileSendPort Pilih AdapterSimpan dari daftar drop-down.

  4. Di panel kiri, klik Host.

  5. Dalam kotak Host , pilih BizTalkServerApplication dari daftar drop-down, lalu klik OK.

    Lanjutkan ke Mengelola Adaptor Sampel.

Mengelola Adaptor Sampel

Anda menyelesaikan tugas administrasi untuk adaptor sampel di konsol Administrasi BizTalk.

Untuk mengelola sampel Adaptor File

  1. Klik Mulai, arahkan ke Semua Program, arahkan ke Microsoft BizTalk Server 20xx, lalu klik Administrasi BizTalk Server.

  2. Di panel kiri, klik untuk memperluas Aplikasi, klik untuk memperluas Aplikasi BizTalk 1, dan klik Terima Lokasi.

  3. Pastikan status AdapterReceiveDiaktifkan.

    Jika status tidak Diaktifkan, klik kanan AdapterReceive di panel kanan, lalu klik Aktifkan.

  4. Di panel kiri, klik Orkestrasi dan pastikan AdapterHarness.AdapterHarnessTypeterdaftar. Klik kanan AdapterHarness.AdapterHarnessType, lalu klik Enlist (jika AdapterHarness.AdapterHarnessType sudah terdaftar, opsi menu Daftar tidak tersedia).

  5. Klik kanan AdapterHarness.AdapterHarnessType dan pilih Mulai. Status orkestrasi ini harus berubah menjadi Berjalan.

    Lanjutkan ke Menguji Adaptor Sampel.

Menguji Adaptor Sampel

Setelah Menyebarkan adaptor sampel, Anda harus menghentikan dan memulai ulang instans host. Sangat penting bagi Anda untuk menguji adaptor sampel sebelum Menempatkannya ke dalam produksi.

Untuk menghentikan dan memulai ulang instans host

  1. Di konsol Administrasi BizTalk Server , klik untuk memperluas Administrasi BizTalk Server, klik untuk memperluas Grup BizTalk, klik untuk memperluas Pengaturan Platform dan klik Instans Host. Pilih BizTalkServerApplication di panel kanan.

  2. Klik kanan instans host (biasanya, nama komputer), lalu klik Hentikan.

    Status instans host berubah menjadi Dihentikan.

  3. Klik kanan instans host, lalu klik Mulai.

    Status instans host berubah menjadi Berjalan.

Untuk menguji sampel runtime adaptor statis

  1. Di Windows Explorer, navigasikan ke < direktori Samples Path>\AdaptersDevelopment\File Adapter, dan salin file InstanceXML.xml ke clipboard Anda.

  2. Navigasi ke <drive>:\Temp\Receive dan tempel file Instance.xml ke dalam folder.

    Jika adaptor transmisi dan terima berfungsi, file harus berpindah dari <folder drive>:\Temp\Receive ke <folder drive>:\Temp\Send .

Untuk menguji contoh fungsionalitas Tambahkan Adapter Wizard untuk sampel adaptor statis

  1. Di Visual Studio, di Penjelajah Solusi, klik kanan AdapterHarnessProject, arahkan ke Tambahkan, lalu klik Tambahkan Item yang Dihasilkan.

  2. Dalam kotak dialog Tambahkan Item yang Dihasilkan - AdapterHarnessProject , klik Tambahkan Metadata Adapter, lalu klik Buka.

    Daftar adaptor terdaftar muncul.

  3. Pilih DotNetFile Statis, lalu klik Berikutnya.

    Organisasi layanan yang diekspos oleh adaptor muncul.

  4. Perluas Organisasi Layanan, Perawatan Kesehatan, lalu klik Administratif.

    Perhatikan bahwa Kelayakan ditampilkan secara berbeda dari simpul lain. Kelayakan adalah simpul layanan yang dapat Anda pilih. Simpul lain adalah simpul organisasi yang tidak menjelaskan layanan tertentu.

  5. Pilih simpul Kelayakan , lalu klik Selesai.

    BizTalk mengimpor file .odx dan file .xsd ke dalam proyek.

    Anda sekarang dapat menggunakan skema, PortTypes, Operations, dan MessageTypes yang diimpor dari adaptor dalam jadwal untuk proyek BizTalk.

Kelas atau Metode yang digunakan dalam Sampel ini

Antarmuka: IBaseMessage, IPropertyBag, IBTTransportProxy

Kelas (dari Adaptor Dasar): AsyncTransmitterEndpoint, AsyncTransmitter, BatchMessage, ControlledTermination, ReceiverEndpoint, DotNetFileCommonProperties, BatchOperationType

Komentar

Setelah menyelesaikan adaptor sampel, Anda dapat memodifikasi adaptor sampel untuk membuat adaptor statis atau dinamis kustom Untuk informasi selengkapnya, lihat Adaptor Design-Time Konfigurasi.

Lihat juga

Sampel Adapter - Penggunaan
Mendaftarkan Adapter