Microsoft Dynamics OData配置 microsoft-dynamics-odata-configuration
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实体和服务的表单数据模型。
仅当将Microsoft实例的运行模式设置为samplecontent
(默认值)时,表单数据模型中预配置的AEM Dynamics实体和服务才在您的AEM Forms实例上可用。 MS Dynamics ODataCloud Service(OData服务)也可用于其他运行模式。 有关为AEM实例配置运行模式的详细信息,请参阅运行模式。
先决条件 prerequisites
在开始设置和配置Microsoft Dynamics之前,请确保您具有:
-
已在线配置Microsoft Dynamics 365,或已安装以下某个Microsoft Dynamics版本的实例:
- Microsoft Dynamics 365内部部署
- Microsoft Dynamics 2016内部部署
-
已在Microsoft Azure Active Directory中注册Microsoft Dynamics联机服务的应用程序。 记下已注册服务的客户端ID(也称为应用程序ID)和客户端密钥的值。 在为Microsoft Dynamics服务配置云服务时,将使用这些值。
为已注册的Microsoft Dynamics应用程序设置回复URL set-reply-url-for-registered-microsoft-dynamics-application
执行以下操作以设置已注册的Microsoft Dynamics应用程序的回复URL:
-
转到Microsoft Azure Active Directory帐户,并在注册应用程序的 回复URL 设置中添加以下云服务配置URL:
https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
-
保存配置。
为IFD配置Microsoft Dynamics configure-microsoft-dynamics-for-ifd
Microsoft Dynamics使用基于声明的身份验证向外部用户提供对Microsoft Dynamics CRM服务器上的数据的访问权限。 要启用此功能,请执行以下操作以配置Microsoft Dynamics的面向Internet的部署(IFD)并配置声明设置。
-
按照为Microsoft Dynamics配置IFD中的说明为Microsoft Dynamics配置IFD本地实例。
-
使用Windows PowerShell运行以下命令,以便在启用了IFD的Microsoft Dynamics上配置声明设置:
code language-shell Add-PSSnapin Microsoft.Crm.PowerShell $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings $ClaimsSettings.Enabled = $true Set-CrmSetting -Setting $ClaimsSettings
有关详细信息,请参阅CRM内部部署(IFD)的应用程序注册。
在AD FS计算机上配置OAuth客户端 configure-oauth-client-on-ad-fs-machine
执行以下操作以在Active Directory联合身份验证服务(AD FS)计算机上注册OAuth客户端并授予对AD FS计算机的访问权限:
-
运行以下命令:
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包一起安装的默认Cloud Service部署在以下URL中:https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
-
-
运行以下命令以授予AD FS计算机上的访问权限:
Grant-AdfsApplicationPermission -ClientRoleIdentifier "<Client-ID>" -ServerRoleIdentifier <resource> -ScopeNames openid
其中:
resource
是Microsoft Dynamics组织URL。
-
Microsoft Dynamics使用HTTPS协议。 要从Forms服务器调用AD FS端点,请在运行Microsoft Dynamics的计算机上使用
keytool
命令将AEM Forms站点证书安装到Java证书存储区。
为Microsoft Dynamics服务配置云服务 configure-cloud-service-for-your-microsoft-dynamics-service
MS Dynamics ODataCloud Service(OData服务) 配置附带默认的OData配置。 要将其配置为与Microsoft Dynamics服务连接,请执行以下操作。
-
导航到 工具>Cloud Service>数据源,然后选择
global
配置文件夹。 -
选择 MS Dynamics ODataCloud Service(OData服务) 配置并选择 属性。 随即会打开云服务配置属性对话框。
在 身份验证设置 选项卡中:
-
输入 服务根 字段的值。 转到Dynamics实例并导航到 开发人员资源,以查看服务根字段的值。 例如, https://<tenant-name>/api/data/v9.1/
-
将 客户端ID(也称为 应用程序ID)、客户端密钥、OAuth URL、刷新令牌URL、访问令牌URL 和 资源 字段中的默认值替换为Microsoft Dynamics服务配置中的值。 必须在 资源 字段中指定动态实例URL,才能使用表单数据模型配置Microsoft Dynamics。 使用服务根URL派生动态实例URL。 例如,https://org.crm.dynamics.com。
-
在 授权范围 字段中为Microsoft Dynamics上的授权进程指定 openid。
-
-
单击 连接到OAuth。 您将被重定向到Microsoft Dynamics登录页面。
-
使用您的Microsoft Dynamics凭据登录,并接受以允许云服务配置连接到Microsoft Dynamics服务。 在云服务和服务之间建立连接是一项一次性任务。
然后,您将被重定向到“云服务配置”页面,该页面将显示一条消息,指出已成功保存OData配置。
MS Dynamics ODataCloud Service(OData服务)云服务已配置并与您的Dynamics服务连接。
创建表单数据模型 create-form-data-model
安装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包一起提供的表单数据模型副本,并配置数据模型和服务以满足您的要求。 它将确保对包的任何未来更新都不会覆盖您的表单数据模型。
有关在业务工作流中创建和使用表单数据模型的详细信息,请参阅数据集成。