Mengonfigurasi adaptor File

Cara mengonfigurasi adaptor File, membaca rekomendasi keamanan, dan melihat izin yang diperlukan.

Anda dapat membuat lokasi terima dan mengirim port menggunakan BizTalk Server Administration, atau secara terprogram. Topik ini berfokus pada konsol Administrasi BizTalk Server. Untuk langkah-langkah terprogram, buka Membuat lokasi penerima atau mengirim port secara terprogram.

Rekomendasi keamanan

Adaptor File mentransfer file ke dalam dan ke luar BizTalk Server dari dan ke direktori. Disarankan agar Anda mengikuti panduan ini untuk mengamankan dan menyebarkan adaptor File di lingkungan Anda:

• Jangan buka port untuk menyambungkan ke berbagi file di jaringan sekitar. Anda harus menggunakan adaptor File di lingkungan di mana ada tingkat kepercayaan yang tinggi, seperti intranet.

• Atur daftar kontrol akses diskresi (DACL) yang kuat di direktori drop lokasi penerima. Misalnya, Anda harus mengatur izin baca, tulis, hapus file, dan hapus subfolder dan file ke direktori tempat file menerima lokasi mengambil pesan, sehingga hanya pengguna yang berwenang yang dapat menjatuhkan pesan di lokasi ini.

• Ketika Anda menggunakan adaptor File untuk mengambil data penting, disarankan untuk menggunakan Keamanan Protokol Internet (IPSec.)

Memerlukan izin

Handler adapter berjalan di bawah konteks keamanan instans host yang dipilih untuk handler adapter. Instans Logon host menggunakan properti dalam Nama host - Properti Instans Host di Administrasi BizTalk. Akun ini Logon harus memiliki izin khusus ke folder atau berbagi apa pun yang digunakan oleh adaptor File.

Akun pengguna instans host yang digunakan oleh handler memerlukan izin berikut. ✔ Berarti izin diperlukan. Entri kosong berarti izin tidak diperlukan.

Mengonfigurasi lokasi penerimaan

1. Di konsol Administrasi BizTalk Server, perluas Administrasi BizTalk Server, perluas Grup BizTalk, perluas Aplikasi, lalu perluas aplikasi di bawah Anda ingin membuat lokasi penerima.

2. Di panel kiri, klik simpul Terima Port . 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.

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

4. Dalam kotak dialog Terima Properti Lokasi , di bagian Transportasi , pilih Jenis FILE dari daftar drop-down, lalu klik Konfigurasikan untuk mengonfigurasi properti transportasi untuk lokasi penerima.

5. Di tab Umum , lakukan hal berikut ini:

   Gunakan ini	Untuk melakukan ini
   Menerima folder	Wajib diisi. Masukkan jalur ke folder pada sistem file, berbagi jaringan, atau berbagi file Azure tempat penangan penerima file membaca file. Anda dapat memasukkan jalur langsung di kotak teks Terima folder , atau memilihnya dari sistem file menggunakan tombol Telusuri . Saat menelusuri folder, Anda juga dapat membuat folder baru menggunakan Buat Folder Baru. Jika menggunakan berbagi Azure File Storage, masukkan \\yourfilestoragename.file.core.windows.net\yourfilesharename. Jenis: String Catatan: Jangan atur properti Folder terima ke folder yang menggunakan Sistem File Terdistribusi NT dengan tautan simbolis. Jika Anda menggunakan Sistem File Terdistribusi NT, Anda hanya dapat menggunakan folder dengan jalur jaringan lurus di lokasi penerimaan adaptor File. Untuk pembatasan pada properti ini, lihat Pembatasan saat mengonfigurasi adaptor File. Catatan: URI untuk port kirim atau lokasi terima tidak boleh melebihi 256 karakter.
   Masker file	Wajib diisi. Tentukan masker untuk file. Masker ini dapat berisi nilai kartubebas standar "*". Nilai default: *.xml Jenis: String Untuk pembatasan pada properti ini, lihat Pembatasan saat mengonfigurasi adaptor File.
   Alamat publik	Tentukan alamat publik lokasi ini. BizTalk Server mengekspos alamat ini ke mitra eksternal. Jika properti ini tidak ditentukan, mesin runtime menggantikannya sebagai: < folder file:// Receive>/<Masker file> Nilai untuk properti ini memerlukan awalan adapter. Jenis: String Panjang minimum: 0 Panjang maksimum: 256
   Jumlah coba lagi	Tentukan jumlah upaya untuk mengakses lokasi terima pada berbagi jaringan jika sementara tidak tersedia. Nilai default: 5 Jenis: Lama Nilai minimum: 0 Nilai maksimum: MAX_LONG
   Interval coba lagi (min)	Tentukan waktu interval coba lagi (dalam menit) antara upaya untuk mengakses lokasi terima pada berbagi jaringan jika sementara tidak tersedia. Nilai default: 5 menit Jenis: Lama Nilai minimum: 0 Nilai maksimum: MAX_LONG

6. Pada tab Autentikasi , lakukan hal berikut ini:

   Gunakan ini	Untuk melakukan ini
   Gunakan kredensial ini ketika host tidak memiliki akses ke berbagi jaringan	Diperlukan hanya saat menggunakan berbagi jaringan, atau berbagi file Azure. Nilai Default: Palsu Jenis: Boolean
   Nama pengguna	Jika menggunakan berbagi jaringan, masukkan nama pengguna yang memiliki akses ke berbagi. Jika menggunakan berbagi penyimpanan file Azure, masukkan nama akun penyimpanan Anda. Jenis: String Catatan: Jika beberapa lokasi penerima yang dipetakan ke berbagi jaringan yang sama dikonfigurasi dengan kredensial alternatif, kredensial yang sama harus digunakan untuk semua lokasi penerima. Windows tidak memperbolehkan Anda membuat beberapa sambungan ke server jaringan berbagi dari komputer yang sama jika Anda mencoba menggunakan lebih dari satu set mandat.
   Kata sandi	Jika menggunakan berbagi jaringan, masukkan kata sandi untuk akun yang memiliki akses ke berbagi jaringan. Jika menggunakan berbagi penyimpanan file Azure, masukkan kunci akses akun penyimpanan; yang tercantum dalam portal Azure. Jenis: String

7. Di tab Batching , lakukan hal berikut:

   Gunakan ini	Untuk melakukan ini
   Jumlah pesan dalam batch	Tentukan jumlah maksimum pesan yang akan dikirimkan dalam batch. Nilai Default: 5 Jenis: Int Nilai minimum: 1 Nilai maksimum: 256
   Ukuran batch maksimum (dalam byte)	Tentukan total byte maksimum untuk batch. Nilai Default: 102400 Jenis: Int Nilai minimum: 1024 Nilai maksimum: MAX_LONG

   Adaptor File akan membatasi batch ke nilai mana pun yang tercapai terlebih dahulu, jumlah maksimum pesan atau byte maksimum yang diizinkan.

8. PilihOK.

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

Mengonfigurasi port kirim

1. Di konsol Administrasi BizTalk Server, buat port kirim baru atau klik dua kali port kirim yang ada untuk memodifikasinya. Lihat Cara Membuat Port Kirim. Konfigurasikan semua opsi kirim port dan tentukan FILE untuk opsi Jenis di bagian Transportasi pada tab Umum .

2. Pilih tombol Konfigurasi di samping Ketik.

3. Di tab Umum , lakukan hal berikut ini:

   Gunakan ini	Untuk melakukan ini
   Lokasi Tujuan	Wajib diisi. Masukkan jalur ke lokasi pada sistem file, berbagi publik, atau berbagi file Azure untuk menulis pesan output. Anda dapat memasukkan jalur langsung di Lokasi Tujuan, atau memilihnya dari sistem file menggunakan tombol Telusuri . Saat menelusuri folder dalam kotak dialog Telusuri Folder , Anda juga bisa membuat folder baru dengan mengklik Buat Folder Baru. Jika menggunakan berbagi penyimpanan file Azure, masukkan \\yourfilestoragename.file.core.windows.net\yourfilesharename. Jenis: String Catatan: URI untuk port kirim atau lokasi terima tidak boleh melebihi 256 karakter.
   Nama file	Tentukan nama file tempat penangan Pengiriman file menulis pesan. Untuk pembatasan pada properti ini, termasuk menggunakan makro dalam nama file, lihat Pembatasan saat mengonfigurasi adaptor File.
   Mode salin	Tentukan mode salin yang akan digunakan saat menulis pesan ke file. Nilai yang valid adalah: Menambahkan. Handler Pengiriman file membuka file jika ada dan menambahkan pesan ke akhir file. Jika file tidak ada, handler Pengiriman file akan membuat file baru. Timpa. Handler Pengiriman file membuka file jika ada dan menimpa isinya. Jika file tidak ada, handler Pengiriman file akan membuat file baru. Buat baru Jika file tidak ada, handler Pengiriman file membuat file baru dan menulis ke file tersebut. Jika file sudah ada, handler Pengiriman file melaporkan kesalahan lalu mengikuti logika coba lagi adaptor umum untuk port pengiriman. Ini adalah mode salin default untuk handler Pengiriman file.
   Izinkan Cache menulis	Tentukan apakah akan menggunakan penembolokan sistem file saat menulis pesan ke file. Opsi yang valid adalah: Palsu Jangan gunakan singgahan sistem file. Benar Gunakan cache sistem file. Nilai Default:False Important: Mengatur properti ini ke True dapat meningkatkan performa adaptor File dengan risiko potensi kehilangan data ketika ada kehilangan daya dan tidak semua data ditulis ke disk.
   Gunakan file sementara saat menulis	Tentukan apakah akan menulis file output ke file sementara terlebih dahulu lalu mengganti nama file setelah operasi tulis selesai. Jika opsi ini diaktifkan, maka file sementara akan dibuat dengan ekstensi BTS-WIP. Opsi yang valid adalah Benar Adapter File membuat file sementara saat menulis ke folder target. Palsu Adapter File tidak membuat file sementara saat menulis ke folder target. Nilai Default:Catatan Palsu: Opsi ini hanya tersedia saat properti CopyMode diatur ke nilai Buat baru

4. Pada tab Autentikasi , lakukan hal berikut ini:

   Gunakan ini	Untuk melakukan ini
   Gunakan kredensial ini ketika host tidak memiliki akses ke berbagi jaringan	Diperlukan hanya saat menggunakan berbagi jaringan, atau berbagi file Azure. Nilai Default: Palsu Jenis: Boolean
   Nama pengguna	Jika menggunakan berbagi jaringan, masukkan nama pengguna yang memiliki akses ke berbagi. Jika menggunakan berbagi penyimpanan file Azure, masukkan nama akun penyimpanan Anda. Jenis: String
   Kata sandi	Jika menggunakan berbagi jaringan, masukkan kata sandi untuk akun yang memiliki akses ke berbagi jaringan. Jika menggunakan berbagi penyimpanan file Azure, masukkan kunci akses akun penyimpanan; yang tercantum dalam portal Azure. Jenis: String

5. Pilih OK untuk menyimpan pengaturan Anda.

Mengatur properti untuk port pengiriman dinamis

Port pengiriman dinamis tidak menyediakan opsi konfigurasi transportasi apa pun di konsol Administrasi BizTalk Server karena diharapkan properti ini akan disediakan dengan properti konteks yang terkait dengan pesan. Properti ini dapat diatur dalam alur kustom atau dalam orkestrasi. Untuk mengatur properti konfigurasi pesan dalam orkestrasi, Anda bisa melakukan hal berikut:

• Tambahkan bentuk Pesan Konstruksi ke orkestrasi Anda.

• Konfigurasikan bentuk Buat Pesan untuk membuat pesan baru. (misalnya Message_2)

• Tambahkan bentuk Penetapan Pesan ke bentuk Buat Pesan .

• Tambahkan kode ke bentuk Penetapan Pesan untuk menginisialisasi pesan yang Anda buat dan untuk mengatur properti konfigurasi yang sesuai untuk pesan tersebut. Kode berikut menginisialisasi pesan bernama Message_2 yang dibangun dengan bentuk Pesan Konstruksi lalu mengatur dua properti konfigurasi untuk pesan tersebut. Dalam skenario ini, Message_1 awalnya diterima oleh orkestrasi:

  Message_2=Message_1;  
  Message_2(FILE.CopyMode)= 0; //0=Append  
  Message_2(FILE.AllowCacheOnWrite)= true;  
  Message_2(FILE.UseTempFileOnWrite)= true;  
  

Mengonfigurasi handler terima atau kirim

1. Di konsol Administrasi BizTalk Server, perluas Administrasi BizTalk Server, perluas Grup BizTalk, perluas Pengaturan Platform, lalu klik Adaptor.

2. Di daftar adaptor yang diperluas, klik FILE, di panel kanan, klik kanan handler terima atau kirim yang ingin Anda konfigurasi. Pilih Properti.

3. Di daftar Nama Host , pilih host untuk menjalankan handler.

4. Klik OK.

Topik lainnya di bagian ini

Membuat lokasi penerimaan File atau mengirim port secara terprogram

Skema dan properti properti adaptor file

Pembatasan saat mengonfigurasi adaptor File

Lihat juga

Port untuk Server Terima dan Kirim
Hak Pengguna Keamanan Minimum