Microsoft Dynamics OData配置

通过表单数据模型利用、集成和使用在线和内部部署的Microsoft Dynamics服务。

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加载项包还包含参考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之前，请确保您拥有：

• 已安装AEM 6.4 Forms加载项包

• 已联机配置Microsoft Dynamics 365，或已安装下列Microsoft Dynamics版本之一的实例：

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

• 已向Microsoft Azure Active Directory注册Microsoft Dynamics在线服务的应用程序。记下注册服务的客户端ID(也称为应用程序 ID)和客户端密码的值。 这些值在配置Microsoft Dynamics服务的云服务时使用。

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

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

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并配置声明设置。

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
   

   有关详细信息，请参阅CRM本地(IFD)的应用程序注册。

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

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

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服务）​配置，然后点按​属性。 将打开云服务配置属性对话框。

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

   1. 输入​服务根​字段的值。 转到Dynamics实例，然后导航到​Developer Resources​以视图“服务根”字段的值。 例如，https://<tenant-name>/api/data/v9.1/
   2. 替换​客户端ID(也称为​应用程序 ID)、客户端机密、OAuth URL、刷新令牌URL、中的默认值访问令牌URL​和​资源​字段，其值来自您的Microsoft Dynamics服务配置。 必须在​资源​字段中指定dynamics实例URL，才能使用表单数据模型配置Microsoft Dynamics。 使用服务根URL派生Dynamics实例URL。 例如，https://org.crm.dynamics.com。
   3. 在​授权范围​字段中指定​openid，以便在Microsoft Dynamics上进行授权过程。

   

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

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

   然后，您将被重定向到云服务配置页，该页显示一条消息，显示OData配置已成功保存。

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

创建表单数据模型

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

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

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

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

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