Microsoft Dynamics OData配置 microsoft-dynamics-odata-configuration

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

初学者
用户
开发人员

版本

文章链接

AEM 6.5

单击此处

AEM as a Cloud Service

本文

数据集成

Microsoft Dynamics是一个客户关系管理(CRM)和企业资源规划(ERP)软件，它提供用于创建和管理客户帐户、联系人、潜在客户、机会和案例的企业解决方案。 Experience Manager Forms 数据集成提供OData云服务配置以将Forms与在线和本地Microsoft Dynamics服务器集成。它使您能够根据在Microsoft Dynamics服务中定义的实体、属性和服务来创建表单数据模型(FDM)。表单数据模型(FDM)可用于创建与Microsoft Dynamics服务器交互以启用业务工作流的自适应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：

NOTE

仅在将Experience Manager 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 configure-microsoft-dynamics-for-ifd

Microsoft Dynamics使用基于声明的身份验证向外部用户提供对Microsoft Dynamics CRM服务器上数据的访问。要启用此功能，请执行以下操作为面向Internet的部署(IFD)配置Microsoft Dynamics并配置声明设置。

NOTE

仅在将Experience Manager Forms与内部部署Microsoft Dynamics服务器集成时使用此过程。

为IFD配置Microsoft Dynamics本地实例，如为 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联合身份验证服务(AD FS)计算机上注册OAuth客户端并授予对AD FS计算机的访问权限：

NOTE

仅在将Experience Manager Forms与内部部署Microsoft Dynamics服务器集成时使用此过程。

运行以下命令：

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，并执行以下操作：

NOTE

有关配置Microsoft Dynamics 365（在线或本地）的分步指南，请参阅Microsoft Dynamics OData配置。

转到 工具>Cloud Service>数据源。选择以选择要创建云配置的文件夹。

有关为云服务配置创建和配置文件夹的信息，请参阅为云服务配置文件夹。
选择创建以打开 创建数据Source配置向导。指定配置的名称和标题，从 服务类型 下拉列表中选择 OData服务，浏览并选择配置的缩略图图像，然后选择 下一步。
在 身份验证设置 选项卡中：
1. 输入 服务根 字段的值。转到Dynamics实例并导航到 开发人员资源，以查看服务根字段的值。例如， https://<tenant-name>/api/data/v9.1/
2. 选择 OAuth 2.0 作为身份验证类型。
3. 将 客户端ID（也称为 应用程序ID）、客户端密钥、OAuth URL、刷新令牌URL、访问令牌URL 和资源字段中的默认值替换为Microsoft Dynamics服务配置中的值。必须在资源字段中指定动态实例URL，以使用表单数据模型(FDM)配置Microsoft Dynamics。使用服务根URL派生动态实例URL。例如，https://org.crm.dynamics.com。
4. 在 授权范围 字段中为Microsoft Dynamics上的授权进程指定 openid。
  
  表单数据模型(FDM)
单击 连接到OAuth。您将被重定向到Microsoft Dynamics登录页面。
使用您的Microsoft Dynamics凭据登录并接受以允许云服务配置连接到Microsoft Dynamics服务。建立表单数据模型(FDM)是云服务和服务的一次性任务。

您是云服务配置页面的表单数据模型，该页面显示一条消息，表明OData配置已成功保存。