Show Menu
主题×

Microsoft Dynamics OData配置

Microsoft Dynamics是一款客户关系管理(CRM)和企业资源规划(ERP)软件,它为创建和管理客户帐户、联系人、潜在客户、机会和案例提供企业解决方案。 AEM Forms Data Integration提供OData云服务配置 ,以将Forms与联机和本地Microsoft Dynamics服务器集成。 它允许您基于Microsoft Dynamics服务中定义的实体、属性和服务创建表单数据模型。 表单数据模型可用于创建与Microsoft Dynamics服务器交互的自适应表单,以实现业务工作流。 例如:
  • 查询Microsoft Dynamics Server的数据和预填充自适应表单
  • 在自适应表单提交时将数据写入Microsoft Dynamics
  • 通过表单数据模型中定义的自定义实体在Microsoft Dynamics中写入数据,反之亦然
AEM Forms加载项包还包含可用于将Microsoft Dynamics与AEM Forms快速集成的参考OData配置。
安装包后,AEM Forms实例上提供以下实体和服务:
  • MS Dynamics OData云服务(OData服务)
  • 使用预配置的Microsoft Dynamics实体和服务建立数据模型。
仅当AEM实例的运行模式设置为(默认)时,具有预配置的Microsoft Dynamics实体和服务的OData Cloud服务和表单数据模型才可在AEM Forms实例 samplecontent 上使用。 有关为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
  2. 保存配置。

为IFD配置Microsoft Dynamics

Microsoft Dynamics使用基于索赔的身份验证向外部用户提供对Microsoft Dynamics CRM服务器上数据的访问。 要启用此功能,请执行以下操作,为面向Internet的部署(IFD)配置Microsoft Dynamics并配置声明设置。
仅在将AEM Forms与本地Microsoft Dynamics服务器集成时使用此过程。
  1. 按照为Microsoft Dynamics配置IFD中所述,为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
    
    

在AD FS计算机上配置OAuth客户端

执行以下操作,在Active Directory Federation Services(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:
      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端点,请在运行AEM Forms的计算机上使用命令将Microsoft Dynamics站点证书安 keytool 装到Java证书存储区。

为Microsoft Dynamics服务配置云服务

MS Dynamics OData云服务(OData服务)配置随默认的OData配置一起提供 。 要将其配置为与Microsoft Dynamics服务连接,请执行以下操作。
  1. 导航到工 具>云服务>数据源 ,然后点按配置 global 文件夹。
  2. 选择 MS Dynamics OData云服务(OData服务)配置 ,然后点按 属性 。 此时将打开云服务配置属性对话框。
    在“身份验 证设置 ”选项卡中:
    1. 输入“服务根” 字段的值 。 转到Dynamics实例,然后导航到 Developer Resources ,以视图“服务根”字段的值。 例如,https://<tenant-name>/api/data/v9.1/
    2. Id (也称为 Microsoft Secret , SecretOA UTH)、CrefreshTokenRefresh(访问令牌、应用程序 ID和RefreshTokenRefresh)客户端URL中的默认值替换为Microsoft Dynamics服务配置中的URL Rul资源的值。 必须在“资源”字段中指定动态实例URL,才能 使用表单数据模型配置Microsoft Dynamics。 使用服务根URL派生动态实例URL。 例如, https://org.crm.dynamics.com
    3. 在Microsoft Dynamics 的“授 权范围 ”字段中指定openid。
  3. 单击 “连接到OAuth” 。 您将被重定向到Microsoft Dynamics登录页面。
  4. 使用Microsoft Dynamics凭据登录,并接受允许云服务配置连接到Microsoft Dynamics服务。 它是在云服务和服务之间建立连接的一次性任务。
    然后,您会被重定向到云服务配置页面,该页面会显示一条消息,指示OData配置已成功保存。
MS Dynamics OData云服务(OData服务)云服务已配置并与您的Dynamics服务连接。

Create form data model

安装AEM Forms包时,将在AEM实例上部署表单数据模型​ Microsoft Dynamics FDM 。 默认情况下,表单数据模型使用在MS Dynamics OData Cloud Service(OData Service)中配置的Microsoft Dynamics服务作为其数据源。
首次打开表单数据模型时,它会连接到已配置的Microsoft Dynamics服务,并从Microsoft Dynamics实例中获取实体。 Microsoft Dynamics的“联系人”和“潜在客户”实体已添加到表单数据模型中。
要查看表单数据模型,请转到“表单”>“ 数据集成” 。 选择 Microsoft Dynamics FDM ,然后单击 编辑 ,以在编辑模式下打开表单数据模型。 或者,您也可以直接从以下URL打开表单数据模型:
https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm
接下来,您可以基于表单数据模型创建一个自适应表单并将其用于各种自适应表单使用案例,例如:
  • 通过从Microsoft Dynamics实体和服务查询信息预填自适应表单
  • 使用自适应表单规则调用在表单数据模型中定义的Microsoft Dynamics服务器操作
  • 将提交的表单数据写入Microsoft Dynamics实体
建议创建随AEM Forms包提供的表单数据模型副本,并配置数据模型和服务以满足您的要求。 它将确保将来对包的任何更新不会覆盖表单数据模型。
有关在业务工作流中创建和使用表单数据模型的详细信息,请参阅 数据集成