Bagikan melalui

Membuat Alur Kerja Kustom (Master Data Services)

Berlaku untuk:SQL Server di Windows Azure SQL Managed Instance

Penting

Master Data Services (MDS) dihapus di SQL Server 2025 (17.x). Kami terus mendukung MDS di SQL Server 2022 (16.x) dan versi yang lebih lama.

Master Data Services menggunakan aturan bisnis untuk membuat solusi alur kerja dasar, seperti memperbarui dan memvalidasi data secara otomatis dan mengirim pemberitahuan email, berdasarkan kondisi yang Anda tentukan. Saat Anda memerlukan pemrosesan yang lebih kompleks daripada apa yang disediakan oleh tindakan alur kerja bawaan, gunakan alur kerja kustom. Alur kerja kustom adalah rakitan .NET yang Anda buat. Saat rakitan alur kerja Anda dipanggil, kode Anda dapat mengambil tindakan apa pun yang diperlukan situasi Anda. Misalnya, jika alur kerja Anda memerlukan pemrosesan peristiwa yang kompleks, seperti persetujuan multi-tingkat atau pohon keputusan yang rumit, Anda dapat mengonfigurasi Layanan Data Master untuk memulai alur kerja kustom yang menganalisis data dan menentukan tempat mengirimnya untuk disetujui.

Bagaimana Alur Kerja Kustom Diproses

Ada tiga komponen utama yang terlibat untuk memproses alur kerja kustom: aplikasi web Master Data Manager, SQL Server MDS Workflow Integration Service, dan rakitan handler alur kerja. Komponen-komponen ini memproses alur kerja kustom sebagai berikut:

  1. Anda menggunakan Master Data Manager untuk memvalidasi entitas yang memulai alur kerja.

  2. Master Data Manager mengirimkan anggota yang memenuhi kondisi aturan bisnis ke antrean Service Broker di database Master Data Services.

  3. Secara berkala, SQL Server MDS Workflow Integration Service memanggil prosedur tersimpan dalam database Master Data Services.

  4. Ketika prosedur tersimpan ini menemukan rekaman dalam antrean Service Broker, prosedur ini mengembalikannya ke SQL Server MDS Workflow Integration Service.

  5. SQL Server MDS Workflow Integration Services merutekan data ke rakitan handler alur kerja Anda.

Catatan

Catatan: SQL Server MDS Workflow Integration Service dimaksudkan untuk memicu proses sederhana. Jika kode kustom Anda memerlukan pemrosesan yang kompleks, selesaikan pemrosesan Anda baik di utas terpisah atau di luar proses alur kerja.

Mengonfigurasi Layanan Data Master untuk Alur Kerja Kustom

Membuat alur kerja kustom memerlukan penulisan beberapa kode kustom dan mengonfigurasi Layanan Data Master untuk meneruskan data alur kerja ke penangan alur kerja Anda. Ikuti langkah-langkah ini untuk mengaktifkan pemrosesan alur kerja kustom:

  1. Buat rakitan .NET yang mengimplementasikan Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.

  2. Konfigurasikan SQL Server MDS Workflow Integration Service untuk menyambungkan ke database Master Data Services Anda dan untuk mengaitkan tag dengan handler alur kerja Anda.

  3. Mulai SQL Server MDS Workflow Integration Service.

  4. Buat aturan bisnis di Master Data Manager yang memulai alur kerja yang ditandai dengan nama handler alur kerja Anda.

  5. Terapkan aturan bisnis ke anggota yang memicu alur kerja kustom Anda.

Membuat Rakitan Handler Alur Kerja

Alur kerja kustom adalah rakitan pustaka kelas .NET yang mengimplementasikan antarmuka Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender . SQL Server MDS Workflow Integration Service memanggil metode Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow* untuk menjalankan kode Anda. Misalnya kode yang mengimplementasikan Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow* , lihat Contoh Alur Kerja Kustom (Master Data Services).

Ikuti langkah-langkah ini untuk menggunakan Visual Studio 2010 untuk membuat rakitan yang dapat dipanggil SQL Server MDS Workflow Integration Service untuk menangani alur kerja kustom:

  1. Di Visual Studio 2010, buat proyek Pustaka Kelas baru yang menggunakan bahasa pilihan Anda. Untuk membuat Pustaka Kelas C#, pilih jenis proyek Visual C#\Windows dan pilih templat Pustaka Kelas. Masukkan nama untuk proyek Anda, seperti MDSWorkflowTest, dan klik OK.

  2. Tambahkan referensi ke Microsoft.MasterDataServices.WorkflowTypeExtender.dll. Rakitan ini dapat ditemukan di <folder> penginstalan Anda\Master Data Services\WebApplication\bin.

  3. Tambahkan 'menggunakan Microsoft.MasterDataServices.Core.Workflow;' ke file kode C#Anda.

  4. Warisi dari Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender dalam deklarasi kelas Anda. Deklarasi kelas harus mirip dengan: 'WorkflowTester kelas publik : IWorkflowTypeExtender'.

  5. Terapkan antarmuka Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender . Metode Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow* dipanggil oleh SQL Server MDS Workflow Integration Service untuk memulai alur kerja Anda.

  6. Salin rakitan Anda ke lokasi SQL Server MDS Workflow Integration Service yang dapat dieksekusi, bernama Microsoft.MasterDataServices.Workflow.exe, di <folder> penginstalan Anda\Master Data Services\WebApplication\bin.

Mengonfigurasi SQL Server MDS Workflow Integration Service

Edit file konfigurasi Master Data Services untuk menyertakan informasi koneksi untuk database Master Data Services Anda dan untuk mengaitkan tag dengan rakitan handler alur kerja Anda dengan mengikuti langkah-langkah berikut:

  1. Temukan Microsoft.MasterDataServices.Workflow.exe.config di <folder> penginstalan Anda\Master Data Services\WebApplication\bin.

  2. Tambahkan informasi koneksi database Master Data Services ke pengaturan "ConnectionString". Jika penginstalan SQL Server Anda menggunakan kolase peka huruf besar/kecil, nama database harus dimasukkan dalam kasus yang sama seperti dalam database. Misalnya, tag pengaturan lengkap mungkin terlihat seperti ini:

    <setting name="ConnectionString" serializeAs="String">  
    <value>Server=myServer;Database=myDatabase;Integrated Security=True</value>  
</setting>

  3. Di bawah pengaturan "ConnectionString" tambahkan pengaturan "WorkflowTypeExtenders" untuk mengaitkan nama tag dengan rakitan handler alur kerja Anda. Contohnya:

    <setting name="WorkflowTypeExtenders" serializeAs="String">  
    <value>TEST=MDSWorkflowTestLib.WorkflowTester, MDSWorkflowTestLib</value>  
</setting>

    Teks <dalam tag nilai> berada dalam bentuk <tag> Alur Kerja=<nama> jenis alur kerja yang memenuhi syarat rakitan. <Tag> alur kerja adalah nama yang Anda gunakan untuk mengidentifikasi rakitan handler alur kerja saat Anda membuat aturan bisnis di Master Data Manager. <nama> jenis alur kerja yang memenuhi syarat assembly adalah nama kelas alur kerja Anda yang memenuhi syarat namespace, diikuti dengan koma, diikuti dengan nama tampilan rakitan. Jika assembly Anda diberi nama yang kuat, Anda juga harus menyertakan informasi versi dan PublicKeyToken-nya. Anda dapat menyertakan beberapa <tag pengaturan> jika Anda telah membuat beberapa penanganan alur kerja untuk berbagai jenis alur kerja.

Catatan

Bergantung pada konfigurasi server Anda, Anda mungkin melihat kesalahan "Akses ditolak" ketika Anda mencoba menyimpan file Microsoft.MasterDataServices.Workflow.exe.config. Jika ini terjadi, nonaktifkan Kontrol Akun Pengguna (UAC) untuk sementara pada server. Untuk melakukan ini, buka Panel Kontrol, klik Sistem dan Keamanan. Di bawah Pusat Tindakan, klik Ubah Pengaturan Kontrol Akun Pengguna. Dalam dialog Pengaturan Kontrol Akun Pengguna, geser bilah ke bagian bawah sehingga Anda tidak pernah diberi tahu. Hidupkan ulang komputer Anda dan ulangi langkah-langkah sebelumnya untuk mengedit file konfigurasi Anda. Setelah menyimpan file, reset pengaturan UAC Anda ke tingkat default.

Mulai Layanan Integrasi Alur Kerja SQL Server MDS

Secara default, SQL Server MDS Workflow Integration Service tidak diinstal. Anda harus menginstal layanan sebelum dapat digunakan. Untuk keamanan terbesar, buat pengguna lokal untuk layanan dan berikan pengguna ini hanya izin yang diperlukan untuk melakukan operasi alur kerja. Untuk membuat pengguna, instal layanan, dan mulai layanan, ikuti langkah-langkah berikut:

  1. Gunakan manajer Pengguna dan Grup Lokal untuk membuat pengguna lokal bernama, misalnya, mds_workflow_service.

  2. Gunakan SQL Server Management Studio untuk memberikan izin pengguna mds_workflow_service untuk menjalankan [mdm]. [udpExternalActionsGet] prosedur tersimpan. Untuk melakukan ini, buat login baru untuk akun mds_workflow_service, buat pengguna baru di database Master Data Services, petakan pengguna ini ke login mds_workflow_service, dan beri pengguna izin EXECUTE ke [mdm]. [udpExternalActionsGet] prosedur tersimpan.

  3. Berikan izin pengguna mds_workflow_service untuk menjalankan rakitan handler alur kerja. Untuk melakukan ini, tambahkan pengguna mds_workflow_service ke tab Keamanan dari Properti rakitan handler alur kerja dan berikan izin READ dan EXECUTE pengguna mds_workflow_service.

  4. Berikan izin pengguna mds_workflow_service untuk menjalankan SQL Server MDS Workflow Integration Service yang dapat dieksekusi. Untuk melakukan ini, tambahkan pengguna mds_workflow_service ke tab Keamanan properti Microsoft.MasterDataServices.Workflow.exe, di <folder> penginstalan Anda\Master Data Services\WebApplication\bin dan berikan izin READ and EXECUTE pengguna mds_workflow_service.

  5. Instal SQL Server MDS Workflow Integration Service dengan menggunakan utilitas penginstalan .NET, bernama InstallUtil.exe. InstallUtil.exe dapat ditemukan di folder penginstalan .NET, seperti C:\Windows\Microsoft.NET\Framework\v4.0.30319\. Instal SQL Server MDS Workflow Integration Service dengan memasukkan berikut ini dalam prompt perintah yang ditingkatkan:

    C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil Microsoft.MasterDataServices.Workflow.exe

    Tentukan pengguna mds_workflow_service saat diminta selama penginstalan.

  6. Mulai SQL Server MDS Workflow Integration Service dengan menggunakan snap-in Layanan. Untuk melakukan ini, temukan SQL Server MDS Workflow Integration Service di snap-in Layanan, pilih, dan klik tautan Mulai .

Membuat Aturan Bisnis Alur Kerja

Gunakan Master Data Manager untuk membuat dan menerbitkan aturan bisnis yang akan memulai alur kerja saat diterapkan. Anda harus memastikan bahwa aturan bisnis Anda berisi tindakan yang mengubah nilai atribut, sehingga aturan dievaluasi menjadi false setelah diterapkan sekali. Misalnya, aturan bisnis Anda mungkin mengevaluasi ke true saat nilai atribut Harga lebih besar dari 500 dan nilai atribut yang disetujui kosong. Aturan kemudian dapat menyertakan dua tindakan: satu untuk mengatur nilai atribut yang Disetujui ke Tertunda dan satu untuk memulai alur kerja. Atau, Anda mungkin ingin membuat aturan yang menggunakan kondisi "telah berubah" dan menambahkan atribut Anda untuk mengubah grup pelacakan. Untuk informasi selengkapnya tentang aturan bisnis, lihat Aturan Bisnis (Master Data Services).

Buat aturan bisnis yang memulai alur kerja kustom di Master Data Manager dengan mengikuti langkah-langkah berikut:

  1. Di editor aturan bisnis Master Data Manager, setelah Anda menentukan kondisi aturan bisnis Anda, seret tindakan Mulai Alur Kerja dari daftar Tindakan eksternal ke label Tindakan panel LALU.

  2. Di panel Edit Tindakan , dalam kotak Jenis alur kerja, ketik tag yang mengidentifikasi rakitan handler alur kerja Anda. Ini adalah tag yang Anda tentukan dalam file konfigurasi untuk rakitan Anda, misalnya, TEST.

  3. Secara opsional, pilih kotak centang Sertakan data anggota. Pilih ini untuk menyertakan nama atribut dan nilai dalam XML yang diteruskan ke handler alur kerja.

  4. Dalam kotak Situs alur kerja, ketik nama situs web. Untuk alur kerja kustom Anda, ini mungkin tidak berlaku, tetapi dapat digunakan untuk konteks tambahan.

  5. Dalam kotak Nama alur kerja, ketik nama alur kerja Anda dari Visual Studio. Untuk alur kerja kustom Anda, ini mungkin tidak berlaku, tetapi dapat digunakan untuk konteks tambahan.

  6. Simpan dan terbitkan aturan bisnis.

Menerapkan Aturan Bisnis untuk Memulai Alur Kerja

Terapkan aturan bisnis ke data Anda untuk memulai alur kerja. Untuk melakukan ini, gunakan Master Data Manager untuk mengedit entitas yang berisi anggota yang ingin Anda validasi. Klik Terapkan aturan bisnis. Menanggapi aturan bisnis, Master Data Manager mengisi antrean Service Broker database Master Data Services. Ketika SQL Server MDS Workflow Integration Service memeriksa antrean, SQL Server MDS mengirim data ke rakitan handler alur kerja yang ditentukan dan menghapus antrean. Rakitan handler alur kerja melakukan tindakan apa pun yang telah Anda kodekan ke dalamnya.

Memecahkan Masalah Alur Kerja Kustom

Jika rakitan handler alur kerja Anda tidak menerima data, Anda dapat mencoba men-debug SQL Server MDS Workflow Integration Service atau melihat antrean Service Broker.

Debug Layanan Integrasi Alur Kerja MDS SQL Server

Untuk men-debug SQL Server Workflow Integration Service, lakukan langkah-langkah berikut:

  1. Gunakan snap-in Layanan untuk menghentikan layanan.

  2. Buka prompt perintah, navigasikan ke lokasi layanan, dan jalankan layanan dalam mode konsol dengan memasukkan: Microsoft.MasterDataServices.Workflow.exe -console.

  3. Di Master Data Manager, perbarui anggota Anda dan terapkan aturan bisnis lagi. Log terperinci ditampilkan di jendela konsol.

Lihat Antrean Service Broker

Antrean Service Broker yang berisi data master yang diteruskan sebagai bagian dari alur kerja adalah: mdm.microsoft/mdm/queue/externalaction. Antrean dapat ditemukan di Object Explorer SQL Management Studio di bawah node Service Broker database Master Data Services. Ketahuilah bahwa, jika layanan menghapus antrean dengan benar, antrean ini akan kosong.

Lihat Juga

Contoh Alur Kerja Kustom (Layanan Data Master)
Deskripsi XML Alur Kerja Kustom (Layanan Data Master)

  • Last updated on