逐步解說：利用外掛程式註冊工具來註冊外掛程式

發行︰ 2016年11月

適用於： Dynamics CRM 2015

此逐步解說示範如何使用 SDK 所提供的 Plug-in Registration 工具來註冊外掛程式。 註冊的外掛程式是 範例：建立基本外掛程式 主題中的 FollowupPlugin。

外掛程式在 account 實體、CreateRequest 訊息、在後置事件和在沙箱中註冊。 外掛程式在您的使用者帳戶具有系統自訂員或系統管理員角色的任何 Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新 部署上可以註冊。

下列先決條件必須完成，才能開始此逐步解說：

• 取得 PluginRegistration.exe 工具，位於 SDK 的 Tools\PluginRegistration 資料夾。下載 Microsoft Dynamics CRM SDK 套件。

• 取得 Microsoft Dynamics 365 伺服器的系統使用者帳戶。

• 您的使用者帳戶必須具備系統自訂員或系統管理員角色。 請參閱角色型安全性如何用於控制 Microsoft Dynamics CRM 2015 實體的存取。

連線至 Microsoft Dynamics CRM 伺服器

1. 執行 Plug-in Registration 工具。

2. 選擇 [建立新連線]。

3. 在 [登入] 對話方塊中，選取部署類型選項按鈕，其對應於您要註冊外掛程式的 Microsoft Dynamics 365 伺服器。 [內部部署] 選項按鈕包含 IFD 部署，[Online] 按鈕表示 Microsoft Dynamics CRM Online 的 Windows Live 提供者，而 [Office 365] 按鈕則表示 Microsoft Dynamics CRM Online 的 Microsoft Online Services 提供者。

   線上部署的登入視窗

   內部部署的登入視窗

4. 如果選取 [一律顯示可用組織清單]，在選擇 [登入] 之後，會顯示您所屬組織的清單。 這可讓您選取想要註冊外掛程式的組織。 否則會使用預設組織。

5. 輸入關於伺服器和登入帳戶的指定資訊，然後選擇 [登入]。

您應該會看到註冊的外掛程式或自訂工作流程活動組件和服務端點的摺疊清單。 需要活動摘要和 Microsoft.Crm.ObjectModel 組件，Microsoft Dynamics 365 才能正常運作，因此工具防止您修改。 選取清單的項目，會造成 [屬性] 和 [詳細資料] 索引標籤顯示了該清單項目的相關資訊。

應用程式的主視窗

註冊外掛程式組件

1. 選取組織索引標籤使其使用中。

2. 在索引標籤的工具列中，選擇 [註冊]，然後選擇 [註冊新組件]。

3. 在 [註冊新組件] 對話方塊中，選擇 [步驟 1] 欄位右邊的省略符號 […] 按鈕。

4. 在 [開啟] 對話方塊中，瀏覽至已編譯 SamplePlugin.dll 組件的位置。 預設位置為 SDK\SampleCode\CS\Plug-ins\bin\Debug。 選取組件，然後選擇 [開啟]。

5. 在 [步驟 2] 區段中，展開 [SamplePlugins] 組件檢視該組件的所有外掛程式。 只選取 (勾選) [Microsoft.Crm.Sdk.Samples.FollowupPlugin] 外掛程式。

6. 在 [步驟 3] 區段中，選取 [沙箱] 選項。

7. 在 [步驟 4] 區段中，選取 [資料庫] 選項。

   

   註冊組件的對話方塊

8. 選擇 [註冊選取的外掛程式]。 您可以關閉任何開啟的對話方塊。

   

   在樹狀檢視中顯示的已註冊外掛程式

   提示

   是否在 [記錄檔] 區域中看到錯誤，而記錄檔包含下列訊息？

   <Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

   如果有的話，必須在伺服器上啟用自訂程式碼和再試一次。 如需詳細資訊，請參閱啟用或停用自訂程式碼執行。

SamplePlugins.dll 組件和 FollowupPlugin 外掛程式現在已註冊並部署至伺服器。 如果您使用工具註冊自訂工作流程活動組件，註冊步驟的下一節不適用。

註冊事件的外掛程式步驟

1. 在 [註冊的外掛程式及自訂工作流程活動] 樹狀檢視，展開 [(組件) SamplePlugins] 節點並選取註冊的外掛程式。

2. 瀏覽至工具列中的 [註冊] 功能表，然後選擇 [註冊新步驟]。

   注意

   外掛程式已註冊，在事件執行管線中處理事件時執行。 每個事件都有階段名稱與編號，指示它在管線中核心平台作業之前或之後的位置。步驟代表 SDK 訊息處理步驟實體，用來設定外掛程式何時以及如何執行。

3. 完成 [註冊新步驟] 對話方塊，如下圖所示。

   

   註冊新步驟的對話方塊

4. 選擇 [註冊新步驟]。

5. 展開 [(組件) SamplePlugins] 節點和子節點，查看您建立的外掛程式和步驟節點。 您現在可以關閉工具，但是，您可能想要將它保持開啟，直到測試外掛程式和取消註冊組件之後。

   注意

   若要取消註冊步驟、外掛程式或組件，在樹狀檢視中選取其節點，然後選擇工具列中的 [取消註冊]。 若要修改組件或步驟註冊，按兩下樹狀檢視中的組件或步驟節點。 此外，您也可以選取節點，然後選擇工具列中的 [更新]。

外掛程式現在已註冊，可在沙箱中執行、為客戶建立事件執行，並在核心作業之後執行。 因為後續跟進工作活動建立並非時間關鍵，所以您註冊外掛程式，以非同步方式執行。 在建立客戶後，下次非同步服務處理其佇列時，外掛程式會執行。

測試外掛程式

在註冊外掛程式之後，使用下列程序，您可以選擇性測試其執行。

1. 為您註冊外掛程式組件的相同組織開啟 Microsoft Dynamics 365 Web 應用程式。

2. 移至工作地方，選取 [客戶]，然後選擇 [新增]。

3. 在 [客戶名稱] 方塊中輸入客戶名稱，例如 Adventure Works Cycle，然後選擇 [儲存後關閉]。

4. 在 [帳戶] 格線中，按兩下表單名稱，以開啟表單。

5. 選擇 [活動]，顯示該客戶的相關活動清單。 您應該會看到外掛程式建立、名為 “Send email to the new customer“ 的活動。

6. 如果您註冊外掛程式以非同步方式執行，但未選取 [註冊新步驟] 表單上的 [Delete AsyncOperation if StatusCode = Successful] 選項，將有名為 “FollowupPlugin: Create of account” 的新系統作業。 若要檢視相關的系統作業，選擇 [設定]，然後選擇 [系統作業]。 按兩下先前提及的系統作業。

如果需要，您現在可以取消註冊步驟、外掛程式和組件。 您可能也希望刪除所建立的系統作業與客戶。

另請參閱

外掛程式開發
逐步解說：設定離線外掛程式的組件安全性
註冊和部署外掛程式
事件執行準銷售案源
外掛程式隔離、信任和統計資料
外掛程式支援的訊息和實體

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權