Penelusuran Kesalahan Alur Kerja Kustom

Saat pemrosesan pesan gagal di alur kustom, Anda dapat menggunakan penelusuran kesalahan tingkat sumber untuk mengidentifikasi dan memperbaiki masalah. Debugging tingkat sumber dilakukan menggunakan debugger Visual Studio dengan menghubungkan ke BTSNTSVC.exe (jika pipeline kustom di-deploy) atau Pipeline.exe (jika menggunakan alat pipeline mandiri).

Prosedur

Gunakan prosedur berikut untuk men-debug alur kustom.

Cara Men-debug Alur yang Disebarkan

Melacak kueri dari halaman Grup Hub dan penampil peristiwa memberikan informasi berguna tentang kegagalan pemrosesan pesan pada komponen yang sudah disebarkan. Informasi ini sering digunakan untuk mempersempit asal masalah. Setelah alur kustom diimplikasi, penelusuran kesalahan tingkat sumber dapat digunakan untuk mengidentifikasi kode yang bermasalah.

Untuk Men-debug Pipeline Kustom yang Telah Diterapkan menggunakan Visual Studio

1. Muat solusi proyek alur kustom ke Visual Studio.

2. Ubah jalur output untuk solusi Anda menjadi <Folder Instalasi>\Komponen Pipeline. Di Penjelajah Solusi, klik kanan proyek Anda, klik tab Build, lalu ubah Jalur Output dengan mengklik tombol Telusuri dan pilih direktori <Folder Instalasi>\Komponen Pipeline.

3. Dari dalam Visual Studio, sebarkan solusi dengan mengklik Build | Deploy.

4. Mulai ulang instans host yang menjalankan jalur pemrosesan. Menggunakan konsol Manajemen BizTalk Server, navigasikan ke instans host yang menjalankan alur, klik kanan instans host lalu klik Mulai Ulang.

5. Lampirkan debugger Visual Studio ke BTSNTSVC.exe. Ini dapat dilakukan dengan mengklik Debug | Lampirkan ke Proses, klik Tampilkan proses di semua sesi, lalu klik dua kali BTSNTSVC.exe.

6. Atur titik henti.

7. Letakkan pesan di lokasi yang sesuai untuk memulai komponen alur kustom. Pemrosesan harus berhenti pada titik henti yang Anda tetapkan.

Nota

Jika kode Anda melemparkan pengecualian, BizTalk Server akan menangkapnya dan akhirnya menangguhkan pesan. Untuk menghindari perilaku ini, Anda harus memutuskan pengecualian kesempatan pertama.

Cara Men-debug Menggunakan Pipeline.exe

Anda juga dapat menguji alur kustom menggunakan Pipeline.exe. Ini memiliki keuntungan karena tidak mengharuskan Anda untuk menyebarkan alur, tetapi dengan kompromi bahwa tidak berjalan dalam kondisi yang mirip dengan produksi.

Nota

Jika pipeline kustom Anda menggunakan perakit/pemecah berkas datar, Pipeline.exe tidak akan berfungsi dengan benar. Ini karena Pipeline.exe tidak mengakses database BizTalk. Salah satu solusinya adalah menghapus komponen perakitan / pembongkar dan mengujinya secara terpisah dengan FFDasm.exe dan FFAsm.exe. Lihat Alat Pipeline untuk informasi selengkapnya.

Untuk Men-debug Alur Kustom menggunakan Pipeline.exe dan Visual Studio

1. Muat solusi proyek alur kustom ke Visual Studio.

2. Ubah jalur output untuk solusi Anda menjadi <Folder Instalasi>\Pipeline Components. Di Solution Explorer, klik kanan proyek Anda, klik tab Build, lalu ubah Jalur Output dengan mengklik tombol Telusuri dan pilih direktori <Folder Instalasi>\Pipeline Components.

3. Ubah tindakan mulai untuk solusi Anda. Di Penjelajah Solusi, klik kanan proyek Anda, klik tab Debug, klik Mulai program eksternal, lalu klik ... dan navigasi ke <Folder> Penginstalan\SDK\Utilities\PipelineTools and choose Pipeline.exe. Di bawah Opsi Mulai, masukkan argumen baris perintah yang sesuai untuk komponen Anda. Untuk informasi selengkapnya tentang Pipeline.exe, lihat Alat Pemipaan. Konfigurasi umum menentukan alur dan file sampel:

   <Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -c  
   

4. Atur titik henti Anda.

5. Tekan F5 untuk memulai debugging.

Lihat Juga

Alat Alur