Microsoft Dynamics OData配置

透過表單資料模型，運用、整合及使用線上和內部Microsoft Dynamics服務。

資料整合

Microsoft Dynamics是客戶關係管理(CRM)和企業資源規劃(ERP)軟體，提供企業解決方案，以建立和管理客戶帳戶、連絡人、潛在客戶、商機和案例。 AEM Forms資料整合提供OData雲端服務組態，將Forms與線上和內部Microsoft Dynamics伺服器整合。它可讓您根據Microsoft Dynamics服務中定義的實體、屬性和服務來建立表單資料模型。表單資料模型可用來建立與Microsoft Dynamics伺服器互動的最適化表單，以啟用商業工作流程。例如：

查詢Microsoft Dynamics Server中的資料和預先填入最適化表單
在自適應表單提交時，將資料寫入Microsoft Dynamics
透過表單資料模型中定義的自訂實體，在Microsoft Dynamics中寫入資料，反之亦然

AEM Forms附加套件也包含參考OData組態，您可運用此組態來快速整合Microsoft Dynamics與AEM Forms。

安裝軟體包後，您的AEM Forms實例上將提供以下實體和服務：

MS Dynamics ODataCloud Service（OData服務）
使用預先設定的Microsoft Dynamics實體和服務來建立資料模型。

只有在實例的運行模式設定為samplecontent（預設值）時，ODataCloud Service和表單資料模型（帶有預配置的Microsoft Dynamics實體和服務）才可在AEM Forms實例上使用AEM。有關為實例配置運行模式的詳AEM細資訊，請參見運行模式。

必備條件

在開始設定和設定Microsoft Dynamics之前，請確定您有：

已安裝AEM 6.4Forms附加軟體包
已線上設定Microsoft Dynamics 365，或安裝下列其中一個Microsoft Dynamics版本的例項：
- Microsoft Dynamics 365內部
- Microsoft Dynamics 2016內部版
已在Microsoft Azure Active Directory中註冊Microsoft Dynamics線上服務的應用程式。記下註冊服務的用戶端ID（也稱為應用程式ID）和用戶端密碼的值。這些值在為您的Microsoft Dynamics服務配置雲服務時使用。

為已註冊的Microsoft Dynamics應用程式設定回覆URL

請執行下列動作，為註冊的Microsoft Dynamics應用程式設定回覆URL:

注意

只有在將AEM Forms與線上Microsoft Dynamics伺服器整合時，才使用此過程。

前往Microsoft Azure Active Directory帳戶，並在您註冊的應用程式的「回覆URL」設定中新增下列雲端服務設定URL:

https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
儲存設定。

為IFD配置Microsoft Dynamics

Microsoft Dynamics使用以理賠為基礎的驗證，將Microsoft Dynamics CRM伺服器上的資料存取權提供給外部使用者。若要啟用此功能，請執行下列動作，以設定Microsoft Dynamics for Internet-facing deployment(IFD)，並設定索賠設定。

注意

僅在將AEM Forms與內部Microsoft Dynamics伺服器整合時使用此過程。

按照 Configure IFD for Microsoft Dynamics中所述，為IFD配置Microsoft Dynamics內部實例。

使用Windows PowerShell運行以下命令，在啟用IFD的Microsoft Dynamics上配置聲明設定：

Add-PSSnapin Microsoft.Crm.PowerShell 
 $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings 
 $ClaimsSettings.Enabled = $true 
 Set-CrmSetting -Setting $ClaimsSettings

如需詳細資訊，請參閱內部CRM(IFD)應用程式註冊。

在AD FS機器上設定OAuth用戶端

請執行下列動作，在Active Directory Federation Services(AD FS)機器上註冊OAuth用戶端，並授與AD FS機器的存取權：

注意

僅在將AEM Forms與內部Microsoft Dynamics伺服器整合時使用此過程。

運行以下命令：

Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

其中：
- Client-ID 是可使用任何GUID產生器產生的用戶端ID。
- redirect-uri 是AEM FormsMicrosoft Dynamics OData雲端服務的URL。隨AEM Forms軟體包安裝的預設雲服務部署在以下URL中：
```
http://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
```
運行以下命令以授予對AD FS電腦的訪問權：

Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

其中：
- resource 是Microsoft Dynamics組織URL。
Microsoft Dynamics使用HTTPS通訊協定。要從Forms伺服器調用AD FS端點，請在運行AEM Forms的電腦上使用keytool命令將Microsoft Dynamics站點證書安裝到Java證書儲存。

為您的Microsoft Dynamics服務配置雲端服務

MS Dynamics ODataCloud Service（OData服務）配置隨預設OData配置一起提供。要將其配置為與Microsoft Dynamics服務連接，請執行以下操作。

導覽至「工具>Cloud Services> Data Sources」，然後點選「global組態」資料夾。
選擇MS Dynamics ODataCloud Service（OData服務）配置並按一下屬性。雲端服務設定屬性對話方塊隨即開啟。

在驗證設定頁籤中：
1. 輸入服務根欄位的值。轉至Dynamics實例並導航至Developer Resources以查看「服務根」欄位的值。例如，https://<tenant-name>/api/data/v9.1/
2. 取代用戶端ID（也稱為應用程式ID）、用戶端密碼、OAuth URL、重新整理Token URL、使用Microsoft Dynamics服務組態的值存取Token URL和資源欄位。必須在資源欄位中指定動態例項URL，才能使用表單資料模型來設定Microsoft Dynamics。使用「服務根URL」衍生動態例項URL。例如，https://org.crm.dynamics.com。
3. 在授權範圍欄位中指定openid，以便在Microsoft Dynamics上進行授權程式。
按一下「連線至OAuth ]」。[系統會將您重新導向至Microsoft Dynamics登入頁面。
使用您的Microsoft Dynamics憑證登入，並接受允許雲端服務設定連線至Microsoft Dynamics服務。建立雲服務與服務之間的連接是一次性的任務。

然後，您會被重新導向至雲端服務設定頁面，此頁面會顯示訊息，指出OData設定已成功儲存。