Microsoft Dynamics OData組態

資料整合

Microsoft Dynamics是客戶關係管理(CRM)和企業資源規劃(ERP)軟體,提供企業解決方案,以建立和管理客戶帳戶、連絡人、潛在客戶、商機和案例。 AEM Forms Data Integration 提供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 OData雲端服務(OData服務)
  • 使用預先設定的Microsoft Dynamics實體和服務來建立資料模型。

只有在AEM例項的執行模式設定為 samplecontent(預設)時,OData Cloud服務和表格資料模型(含預先設定的Microsoft Dynamics實體和服務)才可在您的AEM Forms例項上使用。 如需設定AEM例項執行模式的詳細資訊,請參閱「執 行模式」

必備條件

在開始設定和設定Microsoft Dynamics之前,請確定您有:

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

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

注意

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

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

    https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    Azure目錄

  2. 儲存設定。

為IFD配置Microsoft Dynamics

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

注意

只有在整合AEM Forms與內部Microsoft Dynamics伺服器時,才能使用此程式。

  1. 按照為Microsoft Dynamics配置IFD中所述,為IFD配置Microsoft Dynamics 內部實例

  2. 使用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伺服器時,才能使用此程式。

  1. 運行以下命令:

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

    其中:

    • Client-ID 是可使用任何GUID產生器產生的用戶端ID。

    • redirect-uri 是AEM Forms上Microsoft Dynamics OData雲端服務的URL。 隨AEM Forms套件安裝的預設雲端服務會部署在下列URL:

      https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

  2. 運行以下命令以授予對AD FS電腦的訪問權:

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

    其中:

    • resource 是Microsoft Dynamics組織URL。
  3. Microsoft Dynamics使用HTTPS通訊協定。 若要從Forms伺服器叫用AD FS端點,請使用執行AEM Forms之電腦上的命令,將Microsoft Dynamics網站憑證安裝 keytool 至Java憑證存放區。

為您的Microsoft Dynamics服務設定雲端服務

MS Dynamics OData Cloud Service(OData Service) Configuration隨附預設的OData組態。 要將其配置為與Microsoft Dynamics服務連接,請執行以下操作。

  1. 導覽至「 工具>雲端服務>資料來源」,然後點選 global 設定資料夾。

  2. 選擇 MS Dynamics OData Cloud Service(OData Service)配置 ,然後點選「 屬性」。 雲端服務設定屬性對話方塊隨即開啟。

    在「驗證設 定」標籤中 :

    1. 輸入「服務根 」欄位的值 。 前往Dynamics例項並導覽至「開 發人員資源 」,以檢視「服務根」欄位的值。 例如,https://<tenant-name>/api/data/v9.1/

    2. Client Id (也稱為 Application ID )、 Client Secret、 Client Secret、 OAUTH、 Refresh Refresh UrlGread Jurl Access、Jignath Recassing Token 和Microsoft Dynamicrosoft Dynamics服務設定的Tok Token Don Den Dokes中的預設值取代替Resource值。 必須在「資源」欄位中指定動態例項URL, ​才能使用表單資料模型來設定Microsoft Dynamics。 使用「服務根URL」衍生動態例項URL。 例如, https://org.crm.dynamics.com

    3. 在Microsoft Dynamics 的「授權範圍 ​」欄位中指定openid,以進行授權程式。

    驗證設定

  3. 按一 下「連線至OAuth」。 系統會將您重新導向至Microsoft Dynamics登入頁面。

  4. 使用您的Microsoft Dynamics憑證登入,並接受允許雲端服務設定連線至Microsoft Dynamics服務。 建立雲服務與服務之間的連接是一次性的任務。

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

MS Dynamics OData Cloud Service(OData Service)雲端服務已設定,並與您的Dynamics服務連線。

Create form data model

當您安裝AEM Forms套件時,表單資料模型​Microsoft Dynamics FDM,會部署在您的AEM例項上。 預設情況下,表單資料模型使用在MS Dynamics OData Cloud服務(OData服務)中配置的Microsoft Dynamics服務作為其資料源。

首次開啟表單資料模型時,它將連接到已配置的Microsoft Dynamics服務並從Microsoft Dynamics實例中提取實體。 Microsoft Dynamics的「連絡人」和「潛在客戶」實體已新增至表單資料模型。

若要檢閱表單資料模型,請前往「表 單>資料整合」。 選擇 Microsoft Dynamics FDM ,然後按一下「 編輯」 ,以在編輯模式下開啟表單資料模型。 或者,您也可以直接從下列URL開啟表單資料模型:

https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm

default-fdm-1

接下來,您可以根據表單資料模型建立自適應表單,並在各種自適應表單使用案例中使用,例如:

  • 從Microsoft Dynamics實體和服務查詢資訊以預先填寫最適化表單
  • 使用自適應表單規則調用在表單資料模型中定義的Microsoft Dynamics伺服器操作
  • 將提交的表單資料寫入Microsoft Dynamics實體

建議您建立隨AEM Forms套件提供的表單資料模型復本,並設定資料模型和服務以符合您的需求。 它將確保未來套件的任何更新不會覆寫您的表單資料模型。

如需在商業工作流程中建立和使用表單資料模型的詳細資訊,請參閱資 料整合

本頁內容