集成Microsoft Dynamics CRM

与Microsoft Dynamics CRM集成，在不需要额外登录的情况下监控和管理潜在客户、机会和案例。使用以下过程启用Microsoft Dynamics CRM集成。检查先决条件，注册新应用程序，获取键值，并委派权限。

请注意

我们提供了两个Microsoft Dynamics集成模板供您使用。对于大多数用例，我们建议使用较新的HTTP集成，因为它提供了更强大的功能来配置缓存的数据结构。的微软动态模板是Microsoft Dynamics HTTP集成的基础。有关每个集成中可用的微应用程序的详细信息，请参见使用microdynamics微应用程序．

有关开箱即用的Microsoft Dynamics CRM微应用程序的全面列表，请参见使用microdynamics CRM微应用．

检查先决条件

创建专用的Office 365帐户来配置集成。完成此过程后，现有的审计日志级别将持续存在，包括使用Citrix Microapps执行的任何操作。

在MS Dynamics CRM中设置此集成后，您将需要以下工件在Citrix Workspace Microapps中添加集成:

• 授权登录网址
• 应用程序(客户端)ID
• 密钥值
• 有效的Microsoft Dynamics CRM帐户详细信息

您需要满足以下前提条件:

• 如果您的内部服务器托管工作区位于防火墙之后，允许使用端口443访问主机名www.dynamics.com，这样工作区就可以连接到MS Dynamics CRM云。

• 授权登录URL (Citrix提供)。将Citrix Gateway配置为支持MS Dynamics的单点登录，这样一旦用户登录，他们就会自动再次登录，而无需再次输入凭证。有关配置SSO的详细信息，请参见Citrix网关服务．

• 用于配置MS Dynamics CRM集成的专用Office 365帐户。此专用帐户必须在MS Dynamics CRM(系统管理员)中具有完全的数据访问权限。有关更多信息，请参见在Dynamics 365中为客户参与应用程序创建用户，并分配安全角色．

注册您的应用程序和回调url

注册您的新应用程序、添加回调url并收集应用程序ID。

1. 登录到https://portal.azure.com．
2. 选择Azure Active Directory > App注册> +新注册．
3. 进入的名字您想要用于应用程序的支持的账户类型根据您的组织需要。选择帮我选择……参阅此选项的指导。

4. 向实例配置添加一个自定义URL，以授予对私有数据的访问权，并启用OAuth身份验证的用户操作。下重定向的URI(可选)中,选择网络并为您的MS Dynamics实例输入以下两个回调URL和基URL。这是您在设置集成时必须在Microapps UI中输入的相同URL。列出的第一个回调不会改变。第二个回调依赖于目标应用程序，可以在创建集成时在URL地址栏中找到。section {yourmicroappserverurl}由租户部分、区域部分和环境部分组成:https:// {tenantID}。{地区(美国/欧盟/ ap-s)} .iws.cloud.com：

   • https:// {yourmicroappserverurl} / admin / api / gwsc /认证/ serverContext
   • https:// {yourmicroappserverurl} / app / api /认证/ serviceAction /回调
   • 您的基础URL，您用于集成的网站地址的一致部分。例如:https://app。{yoursaasapp}。com
5. 复制应用程序(客户端)ID当您将集成添加到Citrix Workspace Microapps时使用。复制应用程序ID URI也要储存起来，以便以后需要时使用。

使委托权限

有了委托权限，应用程序就可以在调用目标资源时作为已登录用户。

1. 从注册的应用程序视图中选择API的权限和+添加一个权限．
2. 选择Dynamics CRM瓷砖,在您的应用程序需要什么类型的权限?,选择委托权限瓷砖。
3. 选择要添加的权限的复选框，然后选择添加权限在底部。

生成一个密钥值

生成一个秘密字符串，应用程序在请求令牌时使用该字符串来证明其身份。

1. 选择证书和秘密．选择+新客户端秘密．
2. 输入一个描述为客户保密。
3. 下到期中,选择从来没有．选择添加．
4. 复制并保存客户端的秘密价值创建。在您离开本页后，它是不可见的。

过滤查询

大多数Microsoft Dynamics CRM实体支持过滤。的美元的过滤器参数可以添加到任何端点。欲了解更多信息，请查阅参考Microsoft Dynamics CRM查询Web API．

例子:

$filter(statecode eq 0 or statecode eq 3) Only incidents from last 1 month: //api/data/v9.0/incidents$filter Microsoft.Dynamics.CRM.LastXMonths(PropertyName='modifiedon'，PropertyValue=1) //api/data/v9.0/ events

将Microsoft Dynamics集成到Citrix Workspace Microapps中

将Microsoft Dynamics HTTP集成添加到Citrix Workspace Microapps以连接到您的应用程序。这提供了具有预先配置的通知和动作的开箱即用的微应用程序，可以在您的工作区中使用。

按照以下步骤设置Microsoft Dynamics HTTP集成。已预先选择身份验证选项。确保在完成流程时选择了这些选项。对于大多数用例，我们建议使用这个更新的HTTP集成。HTTP集成提供了更强大的功能来配置缓存的数据结构。

遵循以下步骤:

1. 从Microapp集成页面,选择添加新的集成,从citrix提供的模板添加新的集成．
2. 选择微软动态瓷砖。
3. 输入一个集成的名字的集成。
4. 输入连接器参数．
   • 输入实例基URL．这是您的MS Dynamics环境的域，也是您用于此集成的web地址的一致部分。
   • 选择一个图标，或将此作为默认的MS Dynamics图标。
   • 启用本地实例如果正在创建本地连接，则切换。有关更多信息，请参见本地实例．

5. 下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证细节。已预先选择身份验证选项。确保在完成流程时选择了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议您始终使用OAuth 2.0作为可用的服务身份验证方法，并使用Grant Type授权代码。OAuth 2.0确保您的集成符合配置microapp的最大安全遵从性。

   1. 选择授权代码从格兰特类型菜单。这授予客户端用来交换访问令牌的临时代码。代码是从授权服务器获得的，您可以在授权服务器中看到客户机正在请求的信息。只有此授权类型才能启用安全用户模拟。这显示了回调URL，在注册应用程序时使用。
   2. 选择请求体从令牌授权菜单。
   3. 的授权URL肾上腺素。输入您的授权URL或简单地保留一般可用的提供的URL。
   4. 的标记的URL肾上腺素。输入您的令牌URL或简单地保持一般可用的提供的URL。
   5. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。当您配置OAuth服务器时，您将收集这些信息和秘密信息。你需要添加回调URL您可以在集成配置页面上看到。
   6. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
   7. (可选)输入标题前缀如果您的承载前缀与默认头不相同。

6. 当使用OAuth 2.0时，选择添加参数包括访问令牌参数．输入资源为的名字和{yourmsdynamicscrmurl}为价值．目标应用授权服务器需要配置此参数。

7. 下服务操作验证,使在操作中使用单独的用户身份验证切换。服务操作身份验证在服务操作级别进行身份验证。已预先选择身份验证选项。确保在完成流程时选择了这些选项。

   1. 选择OAuth 2.0从身份验证方法菜单并完成身份验证细节。
   2. 选择授权代码从格兰特类型菜单。这授予客户端用来交换访问令牌的临时代码。代码是从授权服务器获得的，您可以在授权服务器中看到客户机正在请求的信息。只有此授权类型才能启用安全用户模拟。这将显示回调URL，在注册应用程序时使用。
   3. 选择请求体从令牌授权菜单。
   4. 的授权URL肾上腺素。
   5. 的标记的URL肾上腺素。
   6. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。当您配置OAuth服务器时，您将收集这些信息和秘密信息。你需要添加回调URL您可以在集成配置页面上看到。
   7. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
   8. (可选)输入标题前缀如果您的承载前缀与默认头不相同。

8. 再次,选择添加参数包括访问令牌参数．输入资源为的名字和{yourmsdynamicscrmurl}为价值．目标应用授权服务器需要配置此参数。

9. (可选)如果您想激活此集成的速率限制，请启用请求速率限制切换并设置的请求数量每时间间隔．
10. 离开请求超时为默认值。

11. (可选)使日志记录为了支持目的，切换到保持24小时的日志记录。

12. 选择保存继续。
13. 下OAuth授权中,选择授权以您的服务帐户登录。弹出一个工作日登录屏幕。
    1. 输入您的服务帐户用户名和密码并选择登录．
    2. 选择接受．

的Microapp集成页面打开您添加的集成和它的微应用程序。现在可以设置和运行第一次数据同步了。由于大量数据可以从集成的应用程序中提取到Microapps平台，我们建议您使用表格页来为您的第一次数据同步过滤实体，以加快同步。有关更多信息，请参见验证所需的实体．有关同步规则、不满足其调度和否决规则的同步的完整信息，请参见同步数据．

有关API端点和表实体的更多细节，请参见MS Dynamics连接器规格．

使用MS Dynamics CRM微应用程序

现有的应用集成与开箱即用的微应用一起出现。从这些微应用开始，并根据您的需要定制它们。

我们的Microsoft Dynamics CRM集成带有以下预配置的开箱即用的微应用程序:

账户:搜索、查看和编辑帐户。

任命:搜索、查看和编辑约会。

例:搜索、查看和编辑用例。

联系人:搜索、查看和编辑联系人。

创建帐户:创建一个帐户。

创建预约:创建一个约会。

创建用例:创建一个案例。

创建联系人:创建一个联系人。

创建领导:创建一个领导。

创造机会:创造一个机会。

创建电话:创建一个电话。

创建任务:创建一个任务。

领导:搜索、查看和编辑线索。

机会:搜索、查看和编辑机会。

电话:搜索、查看和编辑电话。

任务:搜索、查看和编辑任务。

添加遗留集成

按照以下说明设置遗留集成。

将遗留集成添加到Citrix Workspace Microapps中

将Microsoft Dynamics CRM集成到Citrix Workspace Microapps中，以连接到您的应用程序。这提供了具有预先配置的通知和动作的开箱即用的微应用程序，可以在您的工作区中使用。

遵循以下步骤:

1. 从概述页面中选择开始．

   将打开“管理集成”页面。

2. 选择添加新的集成,从citrix提供的模板添加新的集成．
3. 选择要添加的Microsoft Dynamics CRM瓦片。

4. 输入集成的名称。

5. 进入连接器参数你在前面的过程中收集到的。
   • 输入您的URL．
   • 输入您的应用程序ID和关键．
   • 切换在Actions中使用User OAuth授权如果你在微应用的动作中需要OAuth。
   • 选择使用您的MS Dynamics CRM帐户登录启用OAuth授权。在新标签页中打开一个登录页面。系统提示您输入帐户名、确认访问权限和输入密码。
6. 选择添加．

的Microapp集成页面打开您添加的集成和它的微应用程序。从这里，您可以添加另一个集成，继续设置您的开箱即用微应用程序，或为该集成创建一个新的微应用程序。

现在可以设置和运行第一次数据同步了。由于大量数据可以从集成的应用程序中提取到Microapps平台，我们建议您使用表格页来为您的第一次数据同步过滤实体，以加快同步。有关更多信息，请参见验证所需的实体．有关同步规则、不满足其调度和否决规则的同步的完整信息，请参见同步数据．

有关API端点和表实体的更多细节，请参见Microsoft Dynamics连接器规范．

使用Microsoft Dynamics CRM遗留微应用

现有的应用集成与开箱即用的微应用一起出现。从这些微应用开始，并根据您的需要定制它们。

我们的MS Dynamics CRM集成带有以下预先配置的开箱即用的微应用程序:

账户:搜索、查看和编辑帐户。

任命:搜索、查看和编辑约会。

例:搜索、查看和编辑用例。

联系人:搜索、查看和编辑联系人。

创建帐户:创建一个帐户。

创建预约:创建一个约会。

创建用例:创建一个案例。

创建联系人:创建一个联系人。

创建领导:创建一个领导。

创造机会:创造一个机会。

创建电话:创建一个电话。

创建任务:创建一个任务。

领导:搜索、查看和编辑线索。

机会:搜索、查看和编辑机会。

电话:搜索、查看和编辑电话。

任务:搜索、查看和编辑任务。