建立自訂工作流程 (Master Data Services)

發行項
05/07/2013

Master Data Services 使用商務規則建立基本工作流程解決方案，以便根據您所指定的條件，自動更新與驗證資料，並傳送電子郵件通知。當您需要做的處理比內建工作流程動作所提供的處理還要複雜時，請使用自訂工作流程。自訂工作流程是您所建立的 .NET 組件。呼叫您的工作流程組件時，程式碼會採取您的情況所需的任何動作。例如，如果您的工作流程需要自訂的事件處理 (例如多層審核或複雜決策樹)，可以設定 Master Data Services 啟動一個自訂工作流程，這個工作流程會分析資料並決定將該資料傳送至何處以待審核。

如何處理自訂工作流程

與處理自訂工作流程有關的主要元件有三個：主資料管理員 Web 應用程式、SQL Server MDS 工作流程整合服務，以及工作流程處理常式組件。這些元件處理自訂工作流程的方式如下：

您要使用主資料管理員驗證啟動工作流程的實體。
主資料管理員會將符合商務規則條件的成員傳送至 Master Data Services 資料庫中的 Service Broker 佇列。
SQL Server MDS 工作流程整合服務會定期呼叫 Master Data Services 資料庫中的預存程序。
當此預存程序在 Service Broker 佇列中找到記錄時，會將其傳回 SQL Server MDS 工作流程整合服務。
SQL Server MDS 工作流程整合服務會將資料路由傳送至您的工作流程處理常式組件。

[!附註]

注意：SQL Server MDS 工作流程整合服務是要觸發單一處理序。如果您的自訂程式碼需要複雜處理，請在個別的執行緒中，或在工作流程處理序外部，完成您的處理。

設定自訂工作流程的 Master Data Services

建立自訂工作流程需要撰寫特定的自訂程式碼，並設定 Master Data Services 將工作流程資料傳遞至您的工作流程處理常式。遵循以下步驟啟用自訂工作流程處理：

建立一個實作 Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender 的 .NET 組件。
設定 SQL Server MDS 工作流程整合服務連線至您的 Master Data Services 資料庫，並讓某個標記與您的工作流程處理常式產生關聯。
啟動 SQL Server MDS 工作流程整合服務。
在主資料管理員中，建立一個啟動工作流程的商務規則，此工作流程會以您工作流程處理常式的名稱標記。
將商務規則套用至觸發您自訂工作流程的成員。

建立工作流程處理常式組件

自訂工作流程是一個實作 Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender 介面 .NET 類別庫組件。 SQL Server MDS 工作流程整合服務會呼叫 StartWorkflow 方法來執行您的程式碼。如需實作 StartWorkflow 的範例程式碼，請參閱＜自訂工作流程範例 (Master Data Services)＞。

請遵循以下步驟，使用 Visual Studio 2010 建立 SQL Server MDS 工作流程整合服務可以呼叫的組件，以處理自訂工作流程：

在 Visual Studio 2010 中，建立一個使用所選語言的新 [類別庫] 專案。若要建立 C# 類別庫，請選取 [Visual C#\Windows] 專案類型，然後選取 [類別庫] 範本。輸入您專案的名稱 (例如 MDSWorkflowTest)，然後按一下 [確定]。
加入 Microsoft.MasterDataServices.WorkflowTypeExtender.dll 的參考。此組件可以在 <您的安裝資料夾>\Master Data Services\WebApplication\bin 中找到。
將 ‘using Microsoft.MasterDataServices.Core.Workflow;’ 加入至您的 C# 程式碼檔案。
從類別宣告中的 Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender 繼承。類別宣告應該類似：‘public class WorkflowTester : IWorkflowTypeExtender’。
實作 Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender 介面。 SQL Server MDS 工作流程整合服務會呼叫 StartWorkflow 方法來啟動您的工作流程。
將您的組件複製到 SQL Server MDS 工作流程整合服務可執行檔的位置，也就是 <您的安裝資料夾>\Master Data Services\WebApplication\bin 中的 Microsoft.MasterDataServices.Workflow.exe。

設定 SQL Server MDS 工作流程整合服務

遵循以下步驟，編輯 Master Data Services 組態檔，以包含您 Master Data Services 資料庫的連線資訊，並讓某個標記與您的工作流程處理常式組件產生關聯：

在 <您的安裝資料夾>\Master Data Services\WebApplication\bin 中尋找 Microsoft.MasterDataServices.Workflow.exe.config。
將 Master Data Services 資料庫連線資訊加入至 “ConnectionString” 設定。如果您的 SQL Server 安裝使用區分大小寫的定序，資料庫的名稱就必須以資料庫中相同的大小寫輸入。例如，完整的設定標記可能如以下所示：
```
<setting name="ConnectionString" serializeAs="String">
    <value>Server=myServer;Database=myDatabase;Integrated Security=True</value>
</setting>
```
在 “ConnectionString” 設定下方加入 “WorkflowTypeExtenders” 設定，讓標記名稱與您的工作流程處理常式組件產生關聯。例如：
```
<setting name="WorkflowTypeExtenders" serializeAs="String">
    <value>TEST=MDSWorkflowTestLib.WorkflowTester, MDSWorkflowTestLib</value>
</setting>
```
<值> 標記的內部文字採用 <工作流程標記>=<assembly-qualified workflow type name> 的格式。 <工作流程標記> 是在您於主資料管理員中建立商務規則時，用來識別工作流程處理常式組件的名稱。 <組件限定工作流程類型名稱> 是您工作流程類別的命名空間限定名稱，後面加上一個逗號，再加上組件的顯示名稱。如果您的組件具備強式名稱，也必須包含版本資訊及其 PublicKeyToken。如果您已經為不同種類的工作流程建立多個工作流程處理常式，則可以包含多個 <設定> 標記。

[!附註]

根據您伺服器的組態，可以在嘗試儲存 Microsoft.MasterDataServices.Workflow.exe.config 檔案時，看到「存取遭到拒絕」錯誤。如果發生這個情形，請暫時停用伺服器上的 [使用者帳戶控制 (UAC)]。若要這麼做，開啟 [控制台]，然後按一下 [系統及安全性]。在 [行動作業中心] 底下，按一下 [變更使用者帳戶控制設定]。在 [使用者帳戶控制設定] 對話方塊中，將長條滑動到底部，讓您絕不會收到通知。重新啟動電腦，然後重複以上的步驟以編輯您的組態檔。儲存此檔案之後，將您的 UAC 設定重設為預設層級。

啟動 SQL Server MDS 工作流程整合服務

根據預設，不會安裝 SQL Server MDS 工作流程整合服務。您必須先安裝此服務，才能使用它。為獲得更大的安全性，請為服務建立本機使用者，並僅授與此使用者執行工作流程作業所需的權限。若要建立使用者，請安裝服務、啟動服務，然後遵循以下步驟進行：

使用 [本機使用者和群組] 管理員建立區域使用者，例如， mds_workflow_service。
使用 SQL Server Management Studio 授與 mds_workflow_service 使用者權限以執行 [mdm].[udpExternalActionsGet] 預存程序。若要這麼做，請為 mds_workflow_service account 建立一個新的登入，在 Master Data Services 資料庫中建立新使用者、將此使用者對應至 mds_workflow_service login，並授與使用者對於 [mdm].[udpExternalActionsGet] 預存程序的 EXECUTE 權限。
授與 mds_workflow_service 使用者權限以執行工作流程處理常式組件。若要這麼做，請將 mds_workflow_service user 加入至工作流程處理常式組件之 [內容] 的 [安全性] 索引標籤，然後授與 mds_workflow_service 使用者的 READ 和 EXECUTE 權限。
授與 mds_workflow_service 使用者權限以執行 SQL Server MDS 工作流程整合服務可執行檔。若要這麼做，請將 mds_workflow_service user 加入至 Microsoft.MasterDataServices.Workflow.exe (位於 <您的安裝資料夾>\Master Data Services\WebApplication\bin) 中，[內容] 的 [安全性] 索引標籤，並授與 mds_workflow_service user 的 READ 和 EXECUTE 權限。
使用名稱為 InstallUtil.exe 的 .NET 安裝公用程式，安裝 SQL Server MDS 工作流程整合服務。 InstallUtil.exe 可以在 .NET 安裝資料夾 (例如 C:\Windows\Microsoft.NET\Framework\v4.0.30319\) 中找到。在提升權限的命令提示字元下輸入以下內容，安裝 SQL Server MDS 工作流程整合服務：
```
C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil Microsoft.MasterDataServices.Workflow.exe
```
在安裝期間出現提示時，指定 mds_workflow_service user。
使用 Services 嵌入式管理單元啟動 SQL Server MDS 工作流程整合服務。若要這麼做，請在 Services 嵌入式管理單元中尋找 SQL Server MDS 工作流程整合服務，選取該服務，然後按一下 [啟動] 連結。

建立工作流程商務規則

使用主資料管理員建立並發佈套用時啟動工作流程的商務規則。您應該確定您的商務規則中包含變更屬性值的動作，讓規則在套用一次之後，評估為 false。例如，當 Price 屬性值大於 500，且 Approved 屬性值為空白時，您的商務規則可能會評估為 true。接著，此規則可能會包含兩個動作：一個是將 Approved 屬性值設定為 Pending，另一個是啟動工作流程。或者，您可能想要建立一個使用「已變更」條件的規則，並加入您的屬性以變更追蹤群組。如需有關商務規則的詳細資訊，請參閱＜商務規則 (Master Data Services)＞。

依照以下步驟，建立在主資料管理員中啟動自訂工作流程的商務規則。

在主資料管理員的商務規則編輯器中指定您商務規則的條件之後，將 [啟動工作流程] 動作從 [外部動作] 清單拖曳到 [THEN] 窗格的 [動作] 標籤中。
在 [編輯動作] 窗格的 [工作流程類型] 方塊中，輸入可識別您工作流程處理常式組件的標記。這是您在組態檔中，為組件指定的標記，例如 TEST。
或者，選取 [包含成員資料] 核取方塊。選擇此核取方塊以便在 XML 中包含傳遞至工作流程處理常式的屬性名稱和值。
在 [工作流程網站] 方塊中，輸入網站的名稱。這可能不適用於您的自訂工作流程，但是可用於加入的內容。
在 [工作流程名稱] 方塊中，從 Visual Studio 輸入工作流程的名稱。這可能不適用於您的自訂工作流程，但是可用於加入的內容。
儲存並發佈商務規則。

套用商務規則以啟動工作流程

將商務規則套用至您的資料以啟動工作流程。若要這麼做，請使用主資料管理員編輯包含您要驗證之成員的實體。按一下 [套用商務規則]。主資料管理員會擴展 Master Data Services 資料庫的 Service Broker 佇列，以回應商務規則。當 SQL Server MDS 工作流程整合服務檢查佇列時，會將資料傳送至指定的工作流程處理常式組件，然後清除佇列。工作流程處理常式組件會執行您已經為其撰寫程式碼的動作。

疑難排解自訂工作流程

如果您的工作流程處理常式組件沒有收到資料，可以嘗試為 SQL Server MDS 工作流程整合服務偵錯，或檢視 Service Broker 佇列。

為 SQL Server MDS 工作流程整合服務偵錯

若要為 SQL Server 工作流程整合服務偵錯，請採取下列步驟：

使用服務嵌入式管理單元停止服務。
開啟命令提示字元、導覽到服務的位置，然後在主控台模式下輸入 Microsoft.MasterDataServices.Workflow.exe -console 來執行服務。
在主資料管理員中，更新您的成員，然後再次套用商務規則。詳細的記錄顯示在主控台視窗中。

檢視 Service Broker 佇列

包含當做工作流程一部分傳遞之主資料的 Service Broker 佇列為：mdm.microsoft/mdm/queue/externalaction。佇列可以在 SQL Management Studio [物件總管] 之 Master Data Services 資料庫的 Service Broker 節點底下找到。請注意，如果服務已正確清除佇列，此佇列將是空的。

請參閱

概念

自訂工作流程範例 (Master Data Services)

自訂工作流程 XML 描述 (Master Data Services)

共用方式為