Microsoft Dynamics OData配置

数据集成

Microsoft Dynamics 是一款客户关系管理(CRM)和企业资源规划(ERP)软件,为创建和管理客户帐户、联系人、潜在客户、商机和案例提供企业解决方案。Experience Manager Forms 数据 集成提供了OData云服务配置,以将Forms与在线和本地服务器 Microsoft Dynamics 集成。它允许您根据Microsoft Dynamics服务中定义的实体、属性和服务创建表单数据模型。 表单数据模型可用于创建与Microsoft Dynamics服务器交互的自适应Forms,以启用业务工作流。 例如:

  • 查询Microsoft Dynamics服务器以获取数据并预填充Adaptive Forms
  • 在自适应表单提交时,将数据写入Microsoft Dynamics
  • 通过表单数据模型中定义的自定义实体在Microsoft Dynamics中写入数据,反之亦然

MS Dynamics OData Cloud Service (OData Service) is available with all run modes. For more information on configuring run modes for an Experience Manager instance, see Run Modes.

前提条件

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

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

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

注意

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

  1. 转到Microsoft Azure Active Directory帐户,并在注册应用程序的​Reply URLs​设置中添加以下云服务配置URL:

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

    Azure目录

  2. 保存配置。

为IFD配置Microsoft Dynamics

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

注意

仅在将Experience Manager 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
    

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

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

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

注意

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

  1. 运行以下命令:

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

    其中:

    • Client-ID 是可以使用任何GUID生成器生成的客户端ID。

    • redirect-uri 是上OData云服 Microsoft Dynamics 务的URL Experience Manager Forms。随Experience Manager 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端点,请在运行Experience Manager Forms的计算机上使用keytool命令将Microsoft Dynamics站点证书安装到Java证书存储区。

为Microsoft Dynamics服务配置云服务

OData服务由其服务根URL标识。 要将Experience Manager中的OData服务配置为Cloud Service,请确保您具有该服务的服务根URL,并执行以下操作:

注意

有关配置Microsoft Dynamics 365(联机或本地)的分步指南,请参阅Microsoft Dynamics OData配置

  1. 转到 Tools > Cloud Services > Data Sources. 点按以选择要在其中创建云配置的文件夹。

    请参阅为云服务配置配置文件夹 ,以了解有关为云服务配置创建和配置文件夹的信息。

  2. 点按​Create​以打开​Create Data Source Configuration wizard。 指定配置的名称和标题(可选),从​Service Type​下拉列表中选择​OData Service,(可选)浏览并选择配置的缩略图,然后点按​Next
    在​Authentication Settings​选项卡中:

    1. 输入​Service Root​字段的值。 转到Dynamics实例,然后导航到​Developer Resources ,以查看“服务根”字段的值。 例如, https://<tenant-name>/api/data/v9.1/

    2. 选择​OAuth 2.0​作为身份验证类型。

    3. 将​Client Id(也称为​应用程序ID)、Client SecretOAuth URLRefresh Token URLAccess Token URL​和​Resource​字段中的默认值替换为Microsoft Dynamics服务配置中的值。 必须在​Resource​字段中指定dynamics实例URL,才能使用表单数据模型配置Microsoft Dynamics。 使用服务根URL派生dynamics实例URL。 例如, https://org.crm.dynamics.com

    4. 在​Authorization Scope​字段中指定​openid ,以在Microsoft Dynamics上进行授权过程。

      身份验
      证设置表单数据模型

  3. 单击 Connect to OAuth. 系统会将您重定向到Microsoft Dynamics登录页面。

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

    您是云服务配置页面的表单数据模型,该页面会显示一条消息,指示OData配置已成功保存。

MS Dynamics ODataCloud Service(OData服务)云服务已配置并与您的Dynamics服务连接。 表单数据模型表单数据模型

创建表单数据模型

配置MS Dynamics OData Cloud用户表单数据模型(ce)云服务后,您可以在创建表单数据模型时使用该服务。 有关更多信息,请参阅创建表单数据模型

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

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

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

在此页面上