51黑料不打烊

文档用户指南

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

Last update: Thu Mar 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 用户
  • 开发人员
版本
文章链接
AEM as a Cloud Service
单击此处
AEM 6.5
本文

数据集成

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 OData Cloud Service （OData服务）
  • 具有预配置的Microsoft Dynamics实体和服务的表单数据模型。

仅当Microsoft Dynamics实例的运行模式设置为samplecontent（默认值）时，表单数据模型中预配置的AEM实体和服务才在您的AEM Forms实例上可用。 MS Dynamics OData Cloud Service （OData服务）也可用于其他运行模式。 有关为AEM实例配置运行模式的详细信息，请参阅运行模式。

前提条件 prerequisites

在开始设置和配置Microsoft Dynamics之前，请确保您具有：

  • 已安装AEM Forms附加组件包

  • 已在线配置Microsoft Dynamics 365，或已安装以下某个Microsoft Dynamics版本的实例：

    • Microsoft Dynamics 365内部部署
    • 内部部署Microsoft Dynamics 2016

  • 。 记下已注册服务的客户端滨顿（也称为应用程序滨顿）和客户端密钥的值。 在为您的Microsoft Dynamics服务配置云服务时使用这些值。

为注册的Microsoft Dynamics应用程序设置回复鲍搁尝 set-reply-url-for-registered-microsoft-dynamics-application

执行以下操作以设置已注册Microsoft Dynamics应用程序的回复鲍搁尝：

NOTE
请仅在将AEM Forms与在线Microsoft Dynamics服务器集成时使用此过程。

  1. 转到Microsoft Azure Active Directory帐户，并在注册应用程序的? 回复鲍搁尝 ?设置中添加以下云服务配置鲍搁尝：

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

    Azure目录

  2. 保存配置。

为IFD配置Microsoft Dynamics configure-microsoft-dynamics-for-ifd

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

NOTE
请仅在将AEM Forms与本地Microsoft Dynamics服务器集成时使用此过程。

  1. 按照中所述，为Microsoft Dynamics配置IFD本地实例。

  2. 使用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

    有关详细信息，请参阅。

在AD FS计算机上配置OAuth客户端 configure-oauth-client-on-ad-fs-machine

执行以下操作以在Active Directory联合身份验证服务(AD FS)计算机上注册OAuth客户端并授予对AD FS计算机的访问权限：

NOTE
请仅在将AEM Forms与本地Microsoft Dynamics服务器集成时使用此过程。

  1. 运行以下命令：

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

    其中：

    • Client-ID是使用任何骋鲍滨顿生成器生成的客户端滨顿。

    • redirect-uri是AEM Forms上Microsoft Dynamics OData云服务的URL。 与AEM Forms包一起安装的默认Cloud Service部署在以下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端点，请在运行Microsoft Dynamics的计算机上使用keytool命令将AEM Forms站点证书安装到Java证书存储区。

为Microsoft Dynamics服务配置云服务 configure-cloud-service-for-your-microsoft-dynamics-service

MS Dynamics OData Cloud Service （OData服务） ?配置附带默认的OData配置。 要将其配置为连接到Microsoft Dynamics服务，请执行以下操作。

  1. 导航到? 工具>云服务>数据源，然后选择global配置文件夹。

  2. 选择? MS Dynamics OData Cloud Service （OData服务） ?配置并选择? 属性。 随即会打开云服务配置属性对话框。

    在? 身份验证设置 ?选项卡中：

    1. 输入? 服务根 ?字段的值。 转到Dynamics实例并导航到? 开发人员资源，以查看服务根字段的值。 例如， https://<tenant-name>/api/data/v9.1/

    2. 将? 客户端滨顿（也称为? 应用程序滨顿）、客户端密钥、OAuth URL、刷新令牌鲍搁尝、访问令牌鲍搁尝 ?和? 资源 ?字段中的默认值替换为Microsoft Dynamics服务配置中的值。 必须在? 资源 ?字段中指定动态实例URL，以使用表单数据模型配置Microsoft Dynamics。 使用服务根URL派生动态实例URL。 例如，。

    3. 在? 授权范围 ?字段中指定? openid，以便在Microsoft Dynamics上进行授权过程。

    身份验证设置

  3. 单击? 连接到翱础耻迟丑。 您将被重定向到Microsoft Dynamics登录页面。

  4. 使用您的Microsoft Dynamics凭据登录，并接受以允许云服务配置连接到Microsoft Dynamics服务。 在云服务和服务之间建立连接是一项一次性任务。

    然后，您将被重定向到“云服务配置”页面，该页面将显示一条消息，指出已成功保存翱顿补迟补配置。

MS Dynamics OData Cloud Service （OData服务）云服务已配置并与您的Dynamics服务连接。

创建表单数据模型 create-form-data-model

安装AEM Forms包时，会在AEM实例上部署表单数据模型? Microsoft Dynamics FDM。 默认情况下，表单数据模型使用在MS Dynamics OData Cloud 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

default-fdm-1

接下来，您可以基于表单数据模型创建自适应表单，并将其用于各种自适应表单用例，例如：

  • 通过查询Microsoft Dynamics实体和服务中的信息来预填充自适应表单
  • 使用自适应表单规则调用在表单数据模型中定义的Microsoft Dynamics服务器操作
  • 将提交的表单数据写入Microsoft Dynamics实体

建议创建随AEM Forms包一起提供的表单数据模型副本，并配置数据模型和服务以满足您的要求。 它将确保对包的任何未来更新都不会覆盖您的表单数据模型。

有关在业务工作流中创建和使用表单数据模型的详细信息，请参阅数据集成。

recommendation-more-help