Microsoft Dynamics OData配置

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

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

​ MS Dynamics ODataCloud Service（OData服务）在所有运行模式下均可用。 有关为配置运行模式的详细信息 Experience Manager 实例，请参见 运行模式.

前提条件

在开始设置和配置之前 Microsoft Dynamics，确保您具有：

• 已配置 Microsoft Dynamics 365联机或安装了以下某个实例 Microsoft Dynamics 版本：

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

• 已注册以下项目的申请： Microsoft Dynamics 在线服务 Microsoft Azure 活动目录. 记下已注册服务的客户端ID（也称为应用程序ID）和客户端密钥的值。 这些值在使用时 为您的配置云服务 Microsoft Dynamics 服务.

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

执行以下操作可设置已注册的回复URL Microsoft Dynamics 应用程序：

1. 转到 Microsoft Azure Active Directory帐户并在中添加以下云服务配置URL 回复URL 已注册应用程序的设置：

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

   

2. 保存配置。

配置 Microsoft Dynamics 用于IFD

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

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 是的URL Microsoft Dynamics 上的OData云服务 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协议。 从调用AD FS端点 Forms 服务器，安装 Microsoft Dynamics 使用将站点证书发送到Java证书存储区 keytool 计算机上运行的命令 Experience Manager Forms.

为配置云服务 Microsoft Dynamics 服务

OData服务由其服务根URL标识。 在中配置OData服务 Experience Manager as a Cloud Service，请确保您拥有服务的服务根URL，然后执行以下操作：

1. 转到​工具 > Cloud Services > 数据源。点按以选择要创建云配置的文件夹。

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

2. 点按 创建 以打开 创建数据源配置向导. 指定配置的名称和（可选）标题，选择 OData服务 从 服务类型 下拉列表（可选）浏览并选择配置的缩略图图像，然后点按 下一个.
   在 身份验证设置 选项卡：

   1. 输入值 服务根 字段。 转到Dynamics实例并导航到 开发人员资源 查看“服务根”字段的值。 例如， https://<tenant-name>/api/data/v9.1/

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

   3. 将缺省值替换为 客户端ID (也称为 应用程序Id)， 客户端密码， OAuth URL， 刷新令牌URL， 访问令牌URL、和 资源 字段及其值 Microsoft Dynamics 服务配置。 必须在以下位置指定动态实例URL： 资源 要配置的字段 Microsoft Dynamics 使用表单数据模型。 使用服务根URL派生动态实例URL。 例如， https://org.crm.dynamics.com.

   4. 指定 openid 在 授权范围 授权流程的字段 Microsoft Dynamics.

      
      表单数据模型

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

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

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

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

创建表单数据模型

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

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

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

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