Microsoft Dynamics OData設定 microsoft-dynamics-odata-configuration
Microsoft Dynamics是一款客戶關係管理(CRM)和企業資源規劃(ERP)軟體,提供企業解決方案,用於建立和管理客戶帳戶、聯絡人、銷售機會、機會和案例。 AEM Forms資料整合提供OData雲端服務設定,將Forms與線上和內部部署Microsoft Dynamics伺服器整合。 它可讓您根據Microsoft Dynamics服務中定義的實體、屬性和服務來建立表單資料模型。 表單資料模型可用來建立與Microsoft Dynamics伺服器互動的最適化表單,以啟用業務工作流程。 例如:
- 查詢Microsoft Dynamics伺服器以取得資料並預先填入最適化表單
- 提交最適化表單時將資料寫入Microsoft Dynamics
- 透過表單資料模型中定義的自訂實體在Microsoft Dynamics中寫入資料,反之亦然
AEM Forms附加元件套件也包含參考OData設定,可用來快速將Microsoft Dynamics與AEM Forms整合。
安裝套件後,您的AEM Forms執行個體上有以下實體和服務可用:
- MS Dynamics ODataCloud Service(OData服務)
- 具有預先設定之Microsoft Dynamics實體和服務的表單資料模型。
表單資料模型中預先設定的Microsoft Dynamics實體和服務僅在AEM執行個體的執行模式設定為samplecontent
(預設)時,才能在您的AEM Forms執行個體上使用。 MS Dynamics ODataCloud Service(OData服務)也可用於其他執行模式。 如需設定AEM執行個體的執行模式的詳細資訊,請參閱執行模式。
先決條件 prerequisites
在開始設定和設定Microsoft Dynamics之前,請確定您擁有:
-
已線上上設定Microsoft Dynamics 365,或已安裝下列其中一個Microsoft Dynamics版本的執行個體:
- Microsoft Dynamics 365內部部署
- Microsoft Dynamics 2016內部部署
-
已在Microsoft Azure Active Directory中註冊Microsoft Dynamics線上服務的應用程式。 記下註冊服務的使用者端ID (也稱為應用程式ID)和使用者端密碼的值。 在為您的Microsoft Dynamics服務設定雲端服務時會使用這些值。
設定已註冊Microsoft Dynamics應用程式的回覆URL set-reply-url-for-registered-microsoft-dynamics-application
執行下列動作,為已註冊的Microsoft Dynamics應用程式設定回覆URL:
-
移至Microsoft Azure Active Directory帳戶,並為您註冊的應用程式在 回覆URL 設定中新增下列雲端服務設定URL:
https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
-
儲存設定。
設定Microsoft Dynamics以使用IFD configure-microsoft-dynamics-for-ifd
Microsoft Dynamics使用宣告式驗證,為外部使用者提供對Microsoft Dynamics CRM伺服器上資料的存取權。 若要啟用此功能,請執行以下動作來設定Microsoft Dynamics的網際網路對向部署(IFD)並設定宣告設定。
-
依照設定Microsoft Dynamics的IFD中的說明設定Microsoft Dynamics內部部署執行個體以進行IFD。
-
使用Windows PowerShell執行以下命令,在啟用IFD的Microsoft Dynamics上設定宣告設定:
code language-shell Add-PSSnapin Microsoft.Crm.PowerShell $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings $ClaimsSettings.Enabled = $true Set-CrmSetting -Setting $ClaimsSettings
如需詳細資訊,請參閱CRM內部部署(IFD)的應用程式註冊。
在AD FS電腦上設定OAuth使用者端 configure-oauth-client-on-ad-fs-machine
執行下列動作,在Active Directory Federation Services (AD FS)電腦上註冊OAuth使用者端並授與AD FS電腦上的存取權:
-
執行以下命令:
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
-
-
執行以下命令來授予AD FS電腦上的存取權:
Grant-AdfsApplicationPermission -ClientRoleIdentifier "<Client-ID>" -ServerRoleIdentifier <resource> -ScopeNames openid
其中:
resource
是Microsoft Dynamics組織URL。
-
Microsoft Dynamics使用HTTPS通訊協定。 若要從Forms伺服器叫用AD FS端點,請在執行Microsoft的電腦上,使用
keytool
命令將AEM Forms Dynamics網站憑證安裝到Java憑證存放區。
為您的Microsoft Dynamics服務設定雲端服務 configure-cloud-service-for-your-microsoft-dynamics-service
MS Dynamics ODataCloud Service(OData服務) 設定包含預設的OData設定。 若要將其設定為連線至您的Microsoft Dynamics服務,請執行下列動作。
-
導覽至 工具>Cloud Service>資料來源,然後選取
global
設定資料夾。 -
選取 MS Dynamics ODataCloud Service(OData服務) 設定並選取 屬性。 雲端服務設定屬性對話方塊隨即開啟。
在 驗證設定 索引標籤中:
-
輸入 服務根 欄位的值。 移至Dynamics執行個體並導覽至 開發人員資源,以檢視[服務根目錄]欄位的值。 例如, https://<tenant-name>/api/data/v9.1/
-
將 使用者端識別碼 (也稱為 應用程式識別碼)、使用者端密碼、OAuth URL、重新整理權杖URL、存取權杖URL 及 資源 欄位中的預設值,取代為您的Microsoft Dynamics服務組態中的值。 必須在 資源 欄位中指定動態執行個體URL,才能使用表單資料模型設定Microsoft Dynamics。 使用服務根URL衍生動態執行個體URL。 例如,https://org.crm.dynamics.com。
-
在 授權範圍 欄位中指定 openid,以便在Microsoft Dynamics上進行授權程式。
-
-
按一下 連線至OAuth。 系統會將您重新導向至Microsoft Dynamics登入頁面。
-
使用您的Microsoft Dynamics憑證登入,並接受以允許雲端服務設定連線到Microsoft Dynamics服務。 在雲端服務和服務之間建立連線是一項單次性的工作。
系統會將您重新導向至雲端服務設定頁面,其中顯示OData設定已成功儲存的訊息。
MS Dynamics ODataCloud Service(OData服務)雲端服務已設定,並已與您的Dynamics服務連線。
建立表單資料模型 create-form-data-model
安裝AEM Forms套件時,會在AEM執行個體上部署表單資料模型 Microsoft Dynamics FDM。 依預設,表單資料模型會使用MS Dynamics ODataCloud Service(OData服務)中設定的Microsoft Dynamics服務作為其資料來源。
首次開啟表單資料模型時,它會連線至已設定的Microsoft Dynamics服務,並從Microsoft Dynamics例項中擷取實體。 Microsoft Dynamics中的「聯絡人」和「銷售機會」實體已新增至表單資料模型。
若要檢閱表單資料模型,請前往 Forms >資料整合。 選取 Microsoft Dynamics FDM,然後按一下 編輯 以編輯模式開啟表單資料模型。 或者,您也可以直接從下列URL開啟表單資料模型:
https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm
接著,您可以根據表單資料模型建立最適化表單,並在各種最適化表單使用案例中使用,例如:
- 從Microsoft Dynamics實體和服務查詢資訊,預先填寫最適化表單
- 使用最適化表單規則叫用表單資料模型中定義的Microsoft Dynamics伺服器作業
- 將提交的表單資料寫入Microsoft Dynamics實體
建議您建立AEM Forms套件隨附的表單資料模型副本,並設定資料模型和服務以符合您的需求。 它將確保封裝的任何未來更新都不會覆蓋您的表單資料模型。
如需在業務工作流程中建立和使用表單資料模型的詳細資訊,請參閱資料整合。