Microsoft Dynamics OData配置

注意

AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

通过表单数据模型利用、集成和使用在线和本地Microsoft Dynamics服务。

数据集成

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实体和服务来表单数据模型。

只有将AEM实例的运行模式设置为,ODataCloud Service和表单数据模型(具有预配置的Microsoft Dynamics实体和服务)才可在您的AEM Forms实例上使用 samplecontent(默认)。 有关为AEM实例配置运行模式的更多信息,请参阅 运行模式.

前提条件

在开始设置和配置Microsoft Dynamics之前,请确保:

为注册的Microsoft Dynamics应用程序设置回复URL

请执行以下操作,为已注册的Microsoft Dynamics应用程序设置“回复URL”:

注意

仅在将AEM Forms与联机Microsoft Dynamics服务器集成时,才使用此过程。

  1. 转到Microsoft Azure Active Directory帐户,并在 回复URL 注册应用程序的设置:

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

    azure_directory

  2. 保存配置。

为IFD配置Microsoft Dynamics

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

注意

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

  1. 按照 为Microsoft Dynamics配置IFD.

  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联合身份验证服务(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:

      http://[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站点证书安装到Java证书存储区 keytool 命令。

为Microsoft Dynamics服务配置云服务

MS Dynamics ODataCloud Service(OData服务) 配置附带默认OData配置。 要将其配置为与Microsoft Dynamics服务连接,请执行以下操作。

  1. 导航到 工具>Cloud Services>数据源,然后点按 global 配置文件夹。

  2. 选择 MS Dynamics ODataCloud Service(OData服务) 配置和点按 属性. 将打开云服务配置属性对话框。

    身份验证设置 选项卡:

    1. 输入 服务根 字段。 转到Dynamics实例,然后导航到 开发人员资源 查看服务根字段的值。 例如, https://<tenant-name>/api/data/v9.1/
    2. 替换 客户端Id (也称为 应用程序ID)、 客户端密钥, OAuth URL, 刷新令牌URL, 访问令牌URL​和 资源 字段,其值来自Microsoft Dynamics服务配置。 必须在 资源 字段,用于使用表单数据模型配置Microsoft Dynamics。 使用服务根URL派生dynamics实例URL。 例如, https://org.crm.dynamics.com.
    3. 指定 openid授权范围 用于Microsoft Dynamics上的授权流程的字段。

    dynamics_authentication_settings

  3. 单击 连接到OAuth. 您将被重定向到Microsoft Dynamics登录页面。

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

    然后,系统会将您重定向到云服务配置页面,该页面会显示一条OData配置已成功保存的消息。

MS Dynamics ODataCloud Service(OData服务)云服务已配置并与您的Dynamics服务连接。

创建表单数据模型

安装AEM Forms包(表单数据模型)时,Microsoft Dynamics FDM,将部署在AEM实例上。 默认情况下,表单数据模型使用在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

default-fdm-1

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

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

建议创建随AEM Forms包提供的表单数据模型副本,并配置数据模型和服务以符合您的要求。 它将确保将来对资源包的任何更新不会覆盖您的表单数据模型。

有关在业务工作流中创建和使用表单数据模型的更多信息,请参阅 数据集成.

在此页面上