Microsoft Dynamics OData設定 microsoft-dynamics-odata-configuration
Microsoft Dynamics是客戶關係管理(CRM)和企業資源規劃(ERP)軟體,提供企業解決方案來建立和管理客戶帳戶、連絡人、潛在客戶、商機和案例。 Experience Manager Forms 資料整合提供OData雲端服務設定,將Forms與線上和內部部署Microsoft Dynamics伺服器整合。 它可讓您根據Microsoft Dynamics服務中定義的實體、屬性和服務來建立表單資料模型(FDM)。 表單資料模型(FDM)可用來建立與Microsoft Dynamics伺服器互動的Adaptive Forms,以啟用業務工作流程。 例如:
- 查詢Microsoft Dynamics伺服器以取得資料並預先填入Adaptive Forms
- 在提交最適化表單時將資料寫入Microsoft Dynamics
- 透過表單資料模型(FDM)中定義的自訂實體寫入Microsoft Dynamics中的資料,反之亦然
MS Dynamics ODataCloud Service(OData服務)適用於所有執行模式。 如需設定Experience Manager執行個體的執行模式的詳細資訊,請參閱執行模式。
AEM as a Cloud Service提供多種立即可用的提交動作,用於處理表單提交。 您可以在最適化表單提交動作文章中進一步瞭解這些選項。
先決條件 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
-
儲存設定。
為IFD設定Microsoft Dynamics configure-microsoft-dynamics-for-ifd
Microsoft Dynamics使用宣告式驗證來提供Microsoft Dynamics CRM伺服器上資料的存取權給外部使用者。 若要啟用此功能,請執行下列動作,為網際網路對向部署(IFD)設定Microsoft Dynamics並設定宣告設定。
-
設定Microsoft Dynamics內部部署執行個體以進行IFD,如設定IFD for Microsoft Dynamics中所述。
-
使用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
是Experience Manager Forms上Microsoft Dynamics OData雲端服務的URL。 與Experience Manager 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端點,請在執行Experience Manager Forms的電腦上使用
keytool
命令將Microsoft Dynamics站台憑證安裝到Java憑證存放區。
設定您Microsoft Dynamics服務的雲端服務 configure-cloud-service-for-your-microsoft-dynamics-service
OData服務由其服務根URL識別。 若要以Experience Manageras a Cloud Service設定OData服務,請確定您有服務的服務根URL,並執行下列動作:
-
移至 工具>Cloud Service>資料來源。 選取以選取您要建立雲端設定的資料夾。
請參閱設定雲端服務設定的資料夾,以取得關於建立和設定雲端服務設定的資料夾的資訊。
-
選取 建立 以開啟 建立資料Source設定精靈。 指定組態的名稱與標題,從 服務型別 下拉式清單中選取 OData服務,選擇性地瀏覽並選取組態的縮圖影像,然後選取 下一步。
在 驗證設定 索引標籤中:-
輸入 服務根 欄位的值。 移至Dynamics執行個體並導覽至 開發人員資源,以檢視[服務根目錄]欄位的值。 例如, https://<tenant-name>/api/data/v9.1/
-
選取 OAuth 2.0 做為驗證型別。
-
將 使用者端識別碼 (也稱為 應用程式識別碼)、使用者端密碼、OAuth URL、重新整理權杖URL、存取權杖URL 和 資源 欄位中的預設值,取代為您從Microsoft Dynamics服務設定中取得的值。 必須在 資源 欄位中指定動態執行個體URL,才能使用表單資料模型(FDM)設定Microsoft Dynamics。 使用服務根URL衍生動態執行個體URL。 例如,https://org.crm.dynamics.com。
-
在 授權範圍 欄位中指定 openid,以便在Microsoft Dynamics上進行授權程式。
表單資料模型(FDM)
-
-
按一下 連線至OAuth。 您被重新導向到Microsoft Dynamics登入頁面。
-
使用您的Microsoft Dynamics認證登入,並接受允許雲端服務設定連線到Microsoft Dynamics服務。 建立表單資料模型(FDM) 、雲端服務和服務是一次性工作。
您是雲端服務設定頁面的表單資料模型,此頁面會顯示OData設定已成功儲存的訊息。
MS Dynamics ODataCloud Service(OData服務)雲端服務已設定,並已與您的Dynamics服務連線。 表單資料模型(FDM)
建立表單資料模型(FDM) create-form-data-model
設定MS Dynamics OData雲端服務後,您可以在建立表單資料模型(FDM)時使用此服務。 如需詳細資訊,請參閱建立表單資料模型(FDM)。
接下來,您可以建立最適化表單式表單資料模型(FDM),並用於各種最適化表單使用案例,例如:
- 透過查詢Microsoft Dynamics實體和服務中的資訊預填調適型表單
- 使用最適化表單規則叫用表單資料模型(FDM)中定義的Microsoft Dynamics伺服器作業
- 將提交的表單資料寫入Microsoft Dynamics個實體
您可以為最適化表單設定表單資料模型提交動作,以將資料傳送至Microsoft Dynamics OData。
如需在業務工作流程中建立和使用表單資料模型(FDM)的詳細資訊,請參閱資料整合。