File Adapter
Adaptor File mentransfer file ke dalam dan ke luar Microsoft BizTalk Server. Adaptor File terdiri dari dua adaptor — adaptor penerima dan adaptor pengiriman.
Bagian ini membahas alur kerja dan dukungan batching untuk adaptor Penerima file dan adaptor Pengiriman file.
Adaptor penerima file
Gunakan adaptor Penerima file untuk membaca pesan dari file, dan mengirimkannya ke server. Adaptor penerima membaca file, dan membuat objek Pesan BizTalk, sehingga BizTalk Server dapat memproses pesan. Saat membaca dari file, adaptor mengunci file untuk memastikan bahwa tidak ada modifikasi yang dapat dilakukan pada konten file.
Catatan
Adaptor penerima file tidak mengambil file baca-saja atau file sistem. Untuk meningkatkan performa, pastikan untuk memiliki masker file yang tidak menyertakan file-file ini.
Adaptor Penerima file membaca pesan dari file pada sistem file lokal atau pada berbagi jaringan. Ketika lokasi yang ditentukan pada berbagi jaringan tidak tersedia karena masalah jaringan, adaptor penerima mencoba kembali operasi baca (jumlah percobaan ulang dapat dikonfigurasi di konsol Administrasi BizTalk Server). Setelah pesan dibaca dan berhasil diterima oleh BizTalk Messaging Engine, adaptor penerima menghapus file dari sistem file atau berbagi jaringan. Jika pesan dibaca tetapi alur tidak berhasil memproses pesan, adaptor menempatkan pesan dalam antrean yang ditangguhkan lalu menghapus file dari sistem file atau berbagi jaringan. Jika adaptor Penerima file tidak dapat mengirimkan atau menangguhkan pesan ke database MessageBox, itu tidak menghapus file asli dari sistem file atau berbagi jaringan.
Anda juga dapat mengonfigurasi adaptor Penerima file untuk mengganti nama file saat memprosesnya. Anda harus mengganti nama file untuk memastikan bahwa adaptor penerima tidak menghasilkan pesan duplikat jika lokasi terima dimatikan dan dimulai ulang. Ini adalah opsi yang dapat dikonfigurasi untuk lokasi penerimaan File. Secara default, penggantian nama dinonaktifkan. Saat penggantian nama diaktifkan, adaptor Penerima file menambahkan ekstensi . BTS-WIP ke file. Adaptor penerima kemudian membaca pesan dari file yang diganti namanya di lokasi terima dan mengirimkannya ke server. Setelah adaptor penerima berhasil mengirimkan file, adaptor terima menghapus file yang diganti namanya dari sistem file atau berbagi jaringan. Jika pesan telah dibaca tetapi gagal diproses dalam alur, adaptor penerima menempatkan pesan dalam antrean yang ditangguhkan database MessageBox, dan menghapus file yang diganti namanya dari berbagi jaringan.
Catatan
Mengganti nama file tidak berdampak pada performa.
Jika adaptor Penerima file berhasil membaca pesan tetapi tidak berhasil menyimpan pesan dalam database MessageBox, file yang diganti namanya kembali ke nama aslinya, tanpa . Ekstensi BTS-WIP. Perhatikan bahwa adaptor penerima tidak membaca file dengan ekstensi . BTS-WIP jika opsi penggantian nama diaktifkan.
Menggunakan pemberitahuan perubahan file dan polling
Adaptor penerima File bergantung pada Pemberitahuan Perubahan File Windows untuk menentukan kapan harus mengambil file dari direktori atau berbagi yang ditentukan. Jika Adaptor penerima File menerima Pemberitahuan Perubahan File Windows sebelum file ditulis sepenuhnya ke direktori yang ditentukan atau dibagikan maka file akan dikunci dan adaptor Penerima file tidak akan mengambil file. Dalam skenario ini, adaptor Penerima file akan secara aktif melakukan polling direktori atau berbagi yang ditentukan pada interval Polling (ms) yang ditentukan pada kotak dialog Pengaturan tingkat lanjut yang tersedia saat mengonfigurasi lokasi penerimaan File. Saat adaptor Penerima file melakukan polling direktori atau membagikannya mengambil file yang tidak terkunci dari berbagi dan mengirimkan file ke database MessageBox.
Catatan
Adaptor File BizTalk Server hanya telah diuji, dan didukung pada, sistem file NTFS.
Pemberitahuan Perubahan File Windows berikut akan menyebabkan adaptor penerima File mengambil file dari lokasi yang ditentukan:
FILE_NOTIFY_CHANGE_ATTRIBUTES
Setiap perubahan atribut di direktori atau subtree yang diawasi menyebabkan operasi tunggu pemberitahuan perubahan kembali.
FILE_NOTIFY_CHANGE_FILE_NAME
Setiap perubahan nama file di direktori atau subtree yang diawasi menyebabkan operasi tunggu pemberitahuan perubahan dikembalikan. Perubahan termasuk mengganti nama, membuat, atau menghapus nama file.
FILE_NOTIFY_CHANGE_SIZE
Setiap perubahan ukuran file di direktori atau subtree yang diawasi menyebabkan operasi tunggu pemberitahuan perubahan kembali. Sistem operasi mendeteksi perubahan ukuran file hanya ketika file ditulis ke disk. Untuk sistem operasi yang menggunakan penembolokan ekstensif, deteksi hanya terjadi ketika cache cukup dibersihkan.
FILE_NOTIFY_CHANGE_LAST_WRITE
Setiap perubahan pada waktu penulisan terakhir file di direktori atau subtree yang diawasi menyebabkan operasi tunggu pemberitahuan perubahan kembali. Sistem operasi mendeteksi perubahan pada write-time terakhir hanya ketika file ditulis ke disk. Untuk sistem operasi yang menggunakan penembolokan ekstensif, deteksi hanya terjadi ketika cache cukup dibersihkan.
Untuk informasi selengkapnya tentang fungsi FindFirstChangeNotification lihat https://msdn.microsoft.com/library/windows/desktop/aa364417(v=vs.85).aspx.
Dukungan Batching Adapter Penerimaan File
Adaptor Penerima file mengirimkan pesan ke server dalam batch. Adaptor penerima File dimulai dengan membangun satu batch per lokasi penerimaan dengan mengumpulkan semua file yang dapat dibaca yang tersedia di lokasi terima. Batch dikirimkan ke database MessageBox oleh adaptor terima ketika semua file yang tersedia telah dikumpulkan atau ketika jumlah file yang dikumpulkan melebihi ukuran batch maksimum.
Setelah semua pesan dalam batch berhasil dibaca dan dikirimkan ke database MessageBox, adaptor Penerima file menghapus file yang sesuai dari lokasi terima. Jika beberapa pesan dalam batch gagal diproses, adaptor Penerima file menangguhkannya dan menghapus file yang sesuai dari lokasi terima. Jika beberapa atau semua pesan gagal disimpan dalam database MessageBox, seluruh operasi batch digulung balik dan semua file terkait dibiarkan tidak berubah di lokasi terima.
Adapter Pengiriman File
Adaptor Pengiriman file mengirimkan pesan dari database MessageBox ke alamat tujuan (URL) tertentu. Anda menentukan URL, yang merupakan jalur file dan nama file, dengan menggunakan karakter kartubebas yang terkait dengan properti konteks pesan. Adaptor Pengiriman file menyelesaikan karakter kartubebas ke nama file aktual sebelum menulis pesan ke file.
Saat menulis pesan ke file, adaptor Pengiriman file mendapatkan konten pesan dari bagian isi objek Pesan BizTalk. Adaptor Pengiriman file mengabaikan bagian pesan lain di objek Pesan BizTalk. Setelah adaptor File menulis pesan ke file, adaptor file akan menghapus pesan dari database MessageBox. Adaptor File menulis file ke sistem file baik secara langsung atau dengan menggunakan cache sistem file, yang dapat meningkatkan performa, terutama untuk file besar.
Dukungan Batching Adapter Pengiriman File
Adaptor Pengiriman file mendapatkan batch pesan dari database MessageBox dan menulisnya ke file di lokasi tujuan pada sistem file atau berbagi jaringan. Ukuran batch adaptor Pengiriman file tidak dapat dikonfigurasi dan preset ke 20. Jika BizTalk Server gagal menulis beberapa pesan dalam batch ke file, sistem mengirimkan ulang pesan tersebut ke database MessageBox untuk diproses kembali. Anda dapat mengonfigurasi interval coba lagi dan mencoba kembali jumlah dengan menggunakan konsol Administrasi BizTalk Server.