Bagikan melalui

Cara Mengonfigurasi Aplikasi Workflow Foundation untuk Intersepsi

Anda harus menginstal perangkat lunak pencegat BAM dan mengonfigurasi aplikasi Anda untuk menggunakan layanan pencegat Windows Workflow Foundation (WF) sebelum Anda dapat mulai mengumpulkan data aktivitas BAM. Diasumsikan bahwa Anda telah berhasil menginstal BizTalk Server dan dependensinya dan telah membuat setidaknya satu grup BizTalk.

Menginstal Perangkat Lunak BAM-Eventing

Sebelum Anda dapat mengonfigurasi aplikasi WF untuk menggunakan pencegat BAM pada WF, Anda harus menginstal perangkat lunak BAM-Eventing dengan menggunakan program Pengaturan BizTalk Server. Untuk informasi selengkapnya tentang menginstal perangkat lunak BAM-Eventing dan mendaftarkan penghitung kinerja, lihat Menginstal Perangkat Lunak BAM-Eventing.

Mengonfigurasi Aplikasi Windows Workflow Foundation untuk Pelacakan

Empat tugas harus diselesaikan sebelum aplikasi WF Anda dapat mulai menulis informasi peristiwa BAM:

  • Model pengamatan harus dibuat dengan menggunakan alat BAM BizTalk Server lalu disebarkan dengan menggunakan alat baris perintah Pengelola BAM (bm.exe).

  • File konfigurasi pencegat harus dibuat dan disebarkan dengan menggunakan alat baris perintah BAM Manager (bm.exe).

  • Pengguna yang menjalankan aplikasi host harus menjadi anggota peran SQL Server penulis peristiwa aktivitas BAM (bam_<activity>_EventWriter) yang sesuai untuk memungkinkan aplikasi membaca informasi konfigurasi pencegat dan menulis ke aktivitas BAM.

  • File App.config atau aplikasi itu sendiri harus dimodifikasi untuk memuat layanan pelacakan BAM dan kemudian memulai ulang aplikasi.

    Hanya setelah tugas-tugas ini berhasil diselesaikan, peristiwa akan mulai muncul di database BAM BizTalk Server.

Menyebarkan Model Pengamatan

Anda harus memiliki model pengamatan yang disebarkan sebelum dapat menyebarkan file konfigurasi pencegat atau mengambil aktivitas BAM di aplikasi Anda.

Untuk menerapkan model pengamatan dengan menggunakan bm.exe

  1. Klik Mulai lalu klik Jalankan untuk membuka prompt perintah Windows.

  2. Ketik cmd di bidang Buka , lalu klik OK.

  3. Gunakan perintah ubah direktori untuk berpindah ke direktori yang berisi model pengamatan untuk disebarkan. Misalnya, cd c:\businessprocess\Orders.

  4. Sebarkan model pengamatan dengan menggunakan bm.exe:

    c:\Program Files (x86)\Microsoft BizTalk Server <VERSION>\Tracking\BM.exe deploy-all -definitionfile:<definitionfile.xml>

    Pastikan Anda mengganti <definitionfile.xml> dengan nama file pengamatan yang ingin Anda sebarkan. Untuk opsi lainnya, lihat Perintah Manajemen Pencegat.

    Nota

    Pada sistem yang mendukung Kontrol Akun Pengguna (UAC), Anda mungkin perlu menjalankan alat dengan hak istimewa Administratif.

  5. Ketik Exit, lalu tekan ENTER untuk menutup prompt perintah.

Menyebarkan File Konfigurasi Pencegat

Anda harus menyebarkan file konfigurasi interseptor sebelum aplikasi Anda dapat merekam aktivitas BAM.

Untuk mengonfigurasikan file konfigurasi pencegat dengan menggunakan bm.exe

  1. Klik Mulai lalu klik Jalankan untuk membuka prompt perintah Windows.

  2. Ketik cmd di bidang Buka , lalu klik OK.

  3. Gunakan perintah ubah direktori untuk berpindah ke direktori yang berisi file konfigurasi pencegat untuk disebarkan. Misalnya, cd c:\businessprocess\Orders.

  4. Sebarkan file konfigurasi pencegat dengan menggunakan bm.exe:

    \Program Files (x86)\Microsoft BizTalk Server VERSION <>Tracking\BM.exe deploy-interceptor -filename:<icfile.xml>

    Pastikan Anda mengganti <icfile.xml> dengan nama file konfigurasi pencegat yang ingin Anda sebarkan.

    Nota

    Anda dapat menggunakan bendera -Force:True untuk mengambil alih sumber peristiwa yang ada dengan nama yang sama dengan yang ada di file konfigurasi pencegat Anda. Jika Anda melakukannya, pastikan Anda mencadangkan konfigurasi yang ada dengan menggunakan perintah get-interceptor. Menggunakan bendera -Force:True dapat menghapus konfigurasi pencegat apa pun yang mereferensikan sumber peristiwa yang ditimpa.

    Nota

    Pada sistem yang mendukung Kontrol Akun Pengguna (UAC), Anda mungkin perlu menjalankan alat dengan hak istimewa Administratif.

  5. Ketik Exit, lalu tekan ENTER untuk menutup prompt perintah.

    Jika Anda telah menyebarkan aplikasi WF, konfigurasi baru tidak akan dimuat hingga interval pengecekan berikutnya. Namun, jika Anda mengonfigurasi ulang aplikasi Anda dan memulai ulang, konfigurasi akan segera diterapkan.

Menambahkan Pengguna ke Peran Aktivitas BAM yang Sesuai

BAM Interceptor Framework menggunakan peran SQL Server per aktivitas untuk mengontrol akses ke aktivitas dan informasi konfigurasi. Anda harus menambahkan akun pengguna yang menjalankan aplikasi WF Anda ke peran aktivitas BAM yang sesuai dalam database Impor Utama BAM.

Mengonfigurasi Aplikasi untuk Memuat Layanan Pelacakan BAM

Ada tiga skenario untuk memuat layanan pelacakan BAM di aplikasi WF Anda:

  • Jika aplikasi WF Anda sudah menggunakan WorkflowRuntime untuk memuat bagian konfigurasi WF, Anda dapat menambahkan informasi layanan pelacakan BAM ke bagian yang ada.

  • Jika aplikasi WF Anda tidak menggunakan WorkflowRuntime untuk memuat bagian konfigurasi WF, Anda harus menambahkan kode untuk memuat bagian kustom dari file konfigurasi aplikasi Anda. Anda harus membuat bagian dan menambahkan informasi layanan pelacakan BAM ke dalamnya.

  • Jika Anda lebih suka mengkodekan konfigurasi secara permanen, Anda dapat menggunakan API WF untuk memuat layanan pelacakan secara terprogram tanpa file konfigurasi, atau memuat konfigurasi dari sumber kustom.

    Saat mengonfigurasi aplikasi WF, perhatikan pertimbangan berikut:

  • Pencegat WF hanya mendukung satu BamTrackingService untuk setiap WorkflowRuntime.

  • Interceptor WF mendukung beberapa instans BamTrackingService untuk setiap domain aplikasi.

    • Sebanyak N BamTrackingService didukung untuk sebanyak N WorkflowRuntime.

  • Pencegat menimbulkan pengecualian jika string koneksi yang berbeda digunakan untuk instans BamTrackingService terpisah di domain aplikasi yang sama.

  • Pencegat memperoleh nilai interval polling IC dari instance BamTrackingService pertama yang dimulai.

  • Pencegat menghentikan utas polling IC ketika BamTrackingService terakhir di domain aplikasi dihentikan

    Untuk informasi selengkapnya tentang WorkflowRuntime dan pemuatan informasi konfigurasi, lihat https://go.microsoft.com/fwlink/?LinkId=83314.

Untuk mengonfigurasi file App.config untuk layanan pelacakan BAM

  1. Buka file App.config yang terkait dengan aplikasi Anda. Anda bisa menggunakan Notepad.exe atau editor teks lain untuk tugas ini.

  2. Tambahkan layanan Pelacakan BAM dengan menyisipkan informasi konfigurasi berikut ke dalam file App.config. Ini harus diposisikan sehingga menjadi anak elemen dari configuration.

    Nota

    Elemen bagian harus sesuai dengan nama yang digunakan oleh kode aplikasi Anda saat menggunakan kelas WorkflowRuntime.

    Perhatian

    Contoh atau panduan ini mereferensikan informasi sensitif, seperti string koneksi atau nama pengguna dan kata sandi. Jangan pernah melakukan hardcode nilai-nilai ini dalam kode Anda, dan pastikan Anda melindungi data rahasia dengan menggunakan autentikasi paling aman yang tersedia. Untuk informasi selengkapnya, lihat dokumentasi berikut:

    <!-- The element name must match the one expected by WorkflowRuntime in your WF application -->
<WorkflowServiceContainer>
  <Services>
    <add type="Microsoft.BizTalk.Bam.Interceptors.Workflow.BamTrackingService, Microsoft.BizTalk.Bam.Interceptors, Version=3.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
   ConnectionString="Integrated Security=SSPI;Data Source=.;Initial Catalog=BAMPrimaryImport"
      PollingIntervalSec="5"/>
    </Services>
</WorkflowServiceContainer>

  3. Ubah atribut ConnectionString agar sesuai dengan lingkungan Anda.

  4. Mulai ulang aplikasi Anda.

Untuk mengubah aplikasi Anda untuk memuat bagian konfigurasi kustom

  1. Buka proyek Windows Workflow Foundation Anda di Visual Studio.

  2. Tambahkan instans baru BamTrackingService dengan parameter yang sesuai ke instans aplikasi WorkflowRuntime:

    // !! Replace "WorkflowServiceContainer" with the section name
// you used in your App.config file.
WorkflowRuntime workflowRuntime = new WorkflowRuntime("WorkflowServiceContainer");

  3. Kompilasi ulang dan sebarkan aplikasi yang dimodifikasi.

Untuk mengubah aplikasi Anda agar memuat layanan pelacakan BAM secara terprogram

  1. Buka proyek Windows Workflow Foundation Anda di Visual Studio.

  2. Tambahkan instans baru BamTrackingService dengan parameter yang sesuai ke instans aplikasi WorkflowRuntime:

    string connectionString = "Integrated Security=SSPI;Data Source=.;Initial Catalog=BAMPrimaryImport"
int pollingInterval = 5;
WorkflowRuntime workflowRuntime = new WorkflowRuntime();
workflowRuntime.AddService(new BamTrackingService(connectionString, pollingInterval));

    Anda dapat menambahkan atau menghapus parameter berdasarkan lingkungan spesifik Anda.

  3. Kompilasi ulang dan sebarkan aplikasi yang dimodifikasi.