逐步解說:利用 CRM 外掛程式註冊工具來註冊 Azure 感知外掛程式
發行︰ 2016年11月
適用於: Dynamics CRM 2015
本逐步解說示範如何使用外掛程式註冊工具,設定 Microsoft Azure Active Directory 存取控制服務 (ACS) 及註冊服務端點步驟。 設定後,Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 可以將目前作業的執行內容張貼至 Microsoft Azure 解決方案端點。 在此逐步解說,註冊步驟是要將 Account 實體的CreateRequest 訊息執行內容張貼到 Microsoft Azure 服務匯流排。
下列先決條件必須完成,才能開始此逐步解說:
Plug-in Registration 工具的存取。 您可以在 SDK 的 Tools\PluginRegistration 資料夾中找到工具的可執行檔。下載 Microsoft Dynamics CRM SDK 套件。
取得 Microsoft Dynamics CRM 2015 或 Microsoft Dynamics CRM Online 的帳戶。
您的系統使用者帳戶必須具備系統自訂員或系統管理員角色。 如需詳細資訊,請參閱角色型安全性如何用於控制 Microsoft Dynamics CRM 2015 實體的存取。
存取使用 ACS 版本 2 (Microsoft Dynamics 365 會張貼訊息給它) 的 Microsoft Azure 平台服務命名空間。如需建立 ACS 命名空間,請參閱建立新服務命名空間。
如果您使用 Microsoft Dynamics CRM 2015,必須根據主題設定 Azure 與 Microsoft Dynamics CRM 2015 整合中的指示,設定伺服器的 Microsoft Azure 整合。
必須有接聽程式應用程式主動接聽指定的解決方案端點,Microsoft Dynamics 365 才能成功張貼到 Microsoft Azure 服務匯流排。 如需詳細資訊,請參閱為 Microsoft Azure 解決方案撰寫接聽程式。
步驟
本逐步解說包含下列步驟:
連線至 Microsoft Dynamics CRM 伺服器
建立服務端點設定
設定 ACS
註冊事件的服務端點步驟
測試端點註冊
連線至 Microsoft Dynamics CRM 伺服器
依照下列步驟,使用外掛程式註冊工具連線至 Microsoft Dynamics 365 伺服器。
執行 Plug-in Registration 工具。
選擇 [建立新連線]。
在 [登入] 對話方塊中,選取部署類型選項按鈕,其對應於您要註冊服務端點的 Microsoft Dynamics 365 伺服器。 [內部部署] 選項按鈕包含 IFD 部署,[Online] 按鈕表示 Microsoft Dynamics CRM Online 的 Windows Live 提供者,而 [Office 365] 按鈕則表示 Microsoft Dynamics CRM Online 的 Microsoft Online Services 提供者。
線上部署的登入表單
內部部署的登入表單
如果選取 [一律顯示可用組織清單],在選擇 [登入] 之後,會顯示您所屬組織的清單。 這可讓您選取想要註冊服務端點的組織。 否則會使用預設組織。
輸入關於伺服器和登入帳戶的指定資訊,然後選擇 [登入]。
建立服務端點設定
依照下列步驟註冊 Microsoft Azure 服務端點。
選取您想要註冊服務端點的組織。
在索引標籤的工具列中,選擇 [註冊],然後選擇 [註冊新服務端點]。
使用您解決方案的相關資訊填入 [服務端點註冊] 對話方塊,如下圖所示和下表描述。 確定指定的合約是您的解決方案的接聽程式應用程式所用的相同合約。
UI 元素
description
名稱 (欄位)
您的服務端點註冊的名稱。
描述 (欄位)
此端點註冊的描述。
解決方案命名空間 (欄位)
解決方案的服務命名空間名稱。
路徑 (欄位)
您的專案路徑。 例如,如果服務端點 URL 為 https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo,則路徑為 TwoWayService/Demo。
合約 (下拉式功能表)
端點合約。 接聽程式應用程式必須使用此合約來讀取張貼的訊息。 如需詳細資訊,請參閱為 Microsoft Azure 解決方案撰寫接聽程式。
宣告 (下拉式功能表)
傳送給 Microsoft Azure 的宣告。 使用 [無] 表示標準宣告。 指定 [UserId] 或 [UserInfo],傳送登入使用者的其他資訊。
同盟模式 (核取方塊)
選取此方塊使用同盟模式。
識別碼 (欄位)
不可寫入的欄位,使用您的端點設定識別碼自動填入。
儲存並設定 ACS (按鈕)
儲存輸入的設定,並自動設定 ACS 程序。 提供互動方式來完成主題逐步解說:設定 Microsoft Azure ACS 與 Microsoft Dynamics CRM 2015 整合的描述內容。
儲存並驗證 (按鈕)
儲存輸入的設定,並確認 ACS 正確設定。
儲存 (按鈕)
儲存輸入的設定並關閉對話方塊。
如果尚未設定 ACS 與 Microsoft Dynamics 365 整合,而且希望外掛程式註冊工具進行設定,選擇 [儲存並設定 ACS],然後遵循本逐步解說下一節的指示執行。 如果已設定 ACS,請選擇 [儲存並驗證] 或 [儲存],然後依照註冊事件的服務端點步驟中的指示繼續執行。
設定 ACS
依照下列步驟設定 Microsoft Azure Active Directory 存取控制服務 (ACS)。
選擇 [儲存並設定 ACS] 之後,[ACS 設定] 對話方塊隨即出現。 在表單欄位中輸入適當的資料值,如下表將描述。
欄位名稱
描述
管理金鑰
解決方案的管理金鑰。 您可以從 Azure 管理入口網站 取得此金鑰值。
取得服務匯流排命名空間的管理金鑰
在左窗格,選擇 [服務匯流排],然後在清單中選取目標命名空間。
選擇頁面底部的 [連線資訊]。
在 [存取連線資訊] 對話方塊,[預設金鑰] 會顯示。 這是管理金鑰。
注意
如果您已變更對稱金鑰,請在 [管理金鑰] 欄位中輸入該金鑰而非預設金鑰。 如果無法這樣做,可能會收到包含下列描述的錯誤:「ACS50012:驗證失敗」。
憑證檔案
用來設定 Microsoft Dynamics 365 與 Microsoft Azure 整合的公用憑證檔。
對於 Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新,請從伺服器下載此憑證檔案。 在 Microsoft Dynamics 365 Web 應用程式中,選擇 [設定] > [自訂],然後選擇 [開發人員資源]。 使用 [Microsoft Azure 服務匯流排 簽發者憑證] 下提供的連結,下載並儲存憑證檔。
簽發者名稱
簽發者的名稱。 此名稱必須是用來設定 Microsoft Azure 與 Microsoft Dynamics 365 整合的相同名稱。 您可以從先前描述所提及的 [開發人員資源] 網頁取得簽發者名稱。
如需詳細資訊,請參閱設定 Azure 與 Microsoft Dynamics CRM 2015 整合。
選擇 [設定 ACS]。 設定程序的記錄會在表單的輸出區域中顯示。
選擇 [關閉]。
在 [服務端點註冊] 對話方塊中,選擇 [儲存並確認驗證]。 在驗證完成後即可關閉對話方塊。
註冊事件的服務端點步驟
依照下列步驟,註冊服務端點上的事件步驟。
在工具的樹狀檢視中選取先前已註冊的服務端點。
瀏覽至 [註冊] 功能表,然後選擇 [註冊新步驟]。
為客戶建立事件填入 [註冊新步驟] 對話方塊,如下圖所示。
選擇 [註冊新步驟]。
當建立客戶時,Microsoft Dynamics 365 現在會將包含執行內容的目前訊息張貼至服務匯流排。 張貼以非同步方式執行且不會立即執行。
測試端點註冊
在註冊端點後可以測試端點。 接聽程式必須執行或目標端點有佇列,外掛程式才能張貼至服務匯流排。
為您註冊服務端點的相同組織開啟 Microsoft Dynamics 365 Web 應用程式。
選擇 [建立] 按鈕 ,然後選擇 [客戶]。
在 [客戶名稱] 欄位中輸入客戶名稱,例如 Adventure Works Cycle,然後選擇 [儲存]。
等待大約 10 分鐘,才能發生 Microsoft Azure 服務匯流排 張貼。
選擇 [設定] > [系統作業]。
開啟與您指定給服務端點相同名稱的系統作業。 檢查狀態是否張貼成功、正在等候或失敗。
您現在可以取消註冊端點,如果需要,可以在工具的樹狀檢視中選取端點,然後選擇 [取消註冊]。
另請參閱
Microsoft Dynamics CRM 2015 Azure 擴充功能
Azure 與 Microsoft Dynamics CRM 整合
Active Directory 和宣告型驗證
© 2017 Microsoft. 著作權所有,並保留一切權利。 著作權