Microsoft Dynamics OData配置

通过表单数据模型利用、集成和使用在线和本地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实例的运行模式设置为samplecontent(默认)时,您的AEM Forms实例上才提供具有预配置的Microsoft Dynamics实体和服务的ODataCloud Service和表单数据模型。 有关为AEM实例配置运行模式的更多信息,请参阅运行模式

前提条件

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

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

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

注意

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

  1. 转到Microsoft Azure Active Directory帐户,并在​回复URL​设置中为注册的应用程序添加以下云服务配置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服务器上数据的访问。 要启用此功能,请执行以下操作,为面向Internet的部署(IFD)配置Microsoft Dynamics,并配置声明设置。

注意

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

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

  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端点,请在运行AEM Forms的计算机上使用keytool命令将Microsoft Dynamics站点证书安装到Java证书存储区。

为您的Microsoft Dynamics服务配置云服务

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

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

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

    在​Authentication Settings​选项卡中:

    1. 输入​服务根​字段的值。 转到Dynamics实例,然后导航到​Developer Resources ,以查看“服务根”字段的值。 例如, https://<tenant-name>/api/data/v9.1/
    2. 将​客户端Id(也称为​应用程序ID)、客户端密钥OAuth URL刷新令牌URL访问令牌URL​和<a12/资源值中的默认值替换为您的Dynamics服务配置字段。​必须在​Resource​字段中指定dynamics实例URL,才能使用表单数据模型配置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包提供的表单数据模型副本,并配置数据模型和服务以符合您的要求。 它将确保将来对资源包的任何更新不会覆盖您的表单数据模型。

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

在此页面上