CustomComponent (Sampel Server BizTalk)
Sampel CustomComponent menunjukkan cara membuat dan menggunakan komponen alur kustom yang memodifikasi pesan yang dialirkan. Sampel ini juga menunjukkan konfigurasi komponen alur kustom di Pipeline Designer.
Apa yang Dilakukan Sampel Ini
Sampel ini mengimplementasikan komponen alur kustom yang dapat mengawali atau menambahkan string ke pesan input. BizTalk Server memproses pesan dalam mode streaming, yang berarti bahwa seluruh pesan tidak pernah dimuat ke dalam memori. Komponen alur kustom ditunjukkan menggunakan urutan langkah-langkah berikut:
BizTalk mengambil pesan teks dari file di folder tertentu.
Pesan teks dikirim melalui alur penerima yang berisi komponen alur kustom FixMsg. Anda mengonfigurasi komponen ini untuk menyisipkan string di awal pesan.
Anda mengirim pesan teks yang dihasilkan melalui alur kirim dengan komponen alur kustom FixMsg. Anda mengonfigurasi komponen untuk menambahkan string ke akhir pesan.
BizTalk Server menulis pesan teks yang dihasilkan ke file di folder tertentu.
Tempat Menemukan Sampel Ini
< Jalur> Sampel\Pipelines\CustomComponent\
Tabel berikut ini memperlihatkan file dalam sampel ini dan menjelaskan tujuannya.
| File | Deskripsi |
|---|---|
| Cleanup.bat | Digunakan untuk membatalkan penyebaran rakitan dan menghapusnya dari cache perakitan global (GAC). Menghapus port kirim dan terima. Menghapus direktori virtual Microsoft Internet Information Services (IIS) sesuai kebutuhan. |
| Input.txt | Contoh file input. |
| Setup.bat | Digunakan untuk membangun dan menginisialisasi sampel ini. |
| Di folder \FixMsg: AssemblyInfo.cs, FixMsg.csproj, FixMsg.sln |
File informasi proyek, solusi, dan perakitan untuk bagian komponen alur kustom dari sampel ini. |
| Di folder \FixMsg: FixMsg.cs |
Mengimplementasikan antarmuka komponen alur. |
| Di folder \FixMsg: FixMsgStream.cs |
Menerapkan pembungkus untuk kelas System.IO.Stream , memungkinkan pemrosesan aliran data. |
| Di folder \FixMsg: FixMsgDescription.cs |
Menyediakan metode untuk mengakses dan merender sumber daya antarmuka pengguna komponen di Alur Designer. |
| Di folder \FixMsg: FixMsg.resx |
Berisi deskripsi properti, ikon, dan pesan kesalahan. |
| Di folder \PipelineComponentSample: PipelineComponentSample.btproj, PipelineComponentSample.sln |
File proyek dan solusi untuk bagian proyek BizTalk dari sampel ini. |
| Di folder \PipelineComponentSample: PipelineComponentSampleBinding.xml |
Digunakan untuk penyiapan otomatis seperti pengikatan port. |
| Di folder \PipelineComponentSample: FixMsgReceivePipeline.btp, FixMsgSendPipeline.btp |
Alur BizTalk Server yang berisi komponen alur kustom FixMsg, untuk alur penerima dan kirim masing-masing. |
Membangun dan Menginisialisasi Sampel Ini
Untuk membangun dan menginisialisasi sampel CustomComponent
Di jendela perintah, navigasikan ke folder berikut:
< Jalur> Sampel\Pipelines\CustomComponent
Jalankan file Setup.bat, yang melakukan tindakan berikut:
Membuat folder input (In) dan output (Out) untuk sampel ini di folder :
< Jalur> Sampel\Pipelines\CustomComponent
Mengkompilasi dan menyebarkan proyek Visual Studio untuk sampel ini.
Membuat dan mengikat lokasi terima BizTalk Server, serta port kirim dan terima.
Catatan
Sampel ini menampilkan peringatan berikut saat membuat dan mengikat port:
Warning: Receive handler not specified for receive location "PCReceiveLocation"; updating with first receive handler with matching transport type.Warning: Host not specified for orchestration "CustomComponent"; updating with first available host.Anda dapat mengabaikan peringatan ini dengan aman. (Untuk mengakomodasi kemungkinan perbedaan penamaan dalam penginstalan pengguna, nama host dan handler penerima telah dihilangkan dari file pengikatan.)
Mengaktifkan lokasi terima, dan memulai port pengiriman.
Catatan
Anda harus mengonfirmasi bahwa BizTalk Server tidak melaporkan kesalahan apa pun 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 digunakan untuk menandatangani rakitan yang dihasilkan.
Catatan
Untuk membatalkan perubahan yang dibuat oleh Setup.bat, Anda harus terlebih dahulu menghentikan dan memulai ulang instans host dari konsol MMC Administrasi BizTalk Server. Selanjutnya, jalankan Cleanup.bat. Anda harus menjalankan Cleanup.bat sebelum menjalankan Setup.bat untuk kedua kalinya.
Menjalankan sampel ini
Untuk menjalankan sampel CustomComponent
Tempelkan salinan file teks Input.txt ke dalam folder Masuk.
Amati file teks yang dibuat di folder Keluar. File ini berisi konten file Input.txt dengan teks tambahan yang disisipkan di awal (oleh alur penerima) dan di akhir (oleh alur kirim). Format nama file ini adalah <MessageID>.xml, di mana <MessageID> adalah GUID yang dihasilkan untuk mengidentifikasi pesan secara unik.
Komentar
Anda dapat melihat alur yang telah dikonfigurasi sebelumnya di Alur Designer dengan mengikuti langkah-langkah berikut:
Di Penjelajah Solusi, klik dua kali ReceivePipeline.btp untuk membuka alur penerima di Alur Designer. Amati bahwa komponen FixMsg ditempatkan dalam tahap Validasi alur penerimaan.
Klik komponen FixMsg di tahap Validasi pada permukaan desain. Di jendela Properti, Anda dapat melihat properti konfigurasi komponen alur. Amati bahwa properti PrependData diatur ke Data untuk ditambahkan sebelumnya dalam string alur penerimaan.
Di Penjelajah Solusi, klik dua kali SendPipeline.btp untuk membuka alur pengiriman di Alur Designer. Amati bahwa komponen FixMsg ditempatkan dalam tahap Pra-Merakit alur kirim.
Klik komponen FixMsg di tahap Pra-Merakit pada permukaan desain. Perhatikan bahwa properti AppendData diatur ke Data untuk ditambahkan dalam mengirim string alur.