演练：为 CTI 事件路由使用通用侦听器适配器

 

发布日期： 2016年11月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016

本演练演示如何使用 Unified Service Desk 中的 CTI Desktop Manager 和常规侦听器，在 Unified Service Desk 中作为屏幕弹出消息显示 CTI 事件。 对于本演练，我们将使用示例 CTI Simulator 应用程序发送 CTI 请求到 Unified Service Desk。

在本演练中，您将:

• 根据在示例 CTI Call Tester 应用程序中指定的电子邮件地址在示例 Microsoft Dynamics 365 数据中搜索联系人记录。

• 创建一个窗口导航规则以在 Unified Service Desk 会话中显示匹配的记录。

本主题内容

必备条件

步骤 1：在统一服务台中配置 CTI Desktop Manager 托管控件

步骤 2：如果 CTI 事件在统一服务台引发，则进行测试

步骤 3：定义窗口导航规则以传送 CtiLookUpRequest

测试您的 CTI 适配器

必备条件

• Microsoft .NET Framework 4.5.2 项

• Unified Service Desk 客户端应用程序；是测试托管控件所需的应用程序。

• Microsoft Visual Studio 2012 或 Visual Studio 2013

• 下载示例 CTI Simulator Application Visual Studio 项目到您的计算机。 构建项目，然后从示例应用程序项目的 bin\debug 文件夹运行应用程序（.exe 文件）。 必须在运行 Unified Service Desk 客户端测试应用程序的同一计算机上运行 USD CTI Simulator 应用程序。

步骤 1：在统一服务台中配置 CTI Desktop Manager 托管控件

1. 登录到 Microsoft Dynamics 365。

2. 在导航栏上，选择”Microsoft Dynamics 365“ > “设置” > “统一服务台”。

3. 在“Unified Service Desk”页面上，选择“托管控件”。

4. 在“托管控件”页面上，选择“新建”。

5. 在“新托管控件”页面中，指定下列值。

   字段	值
   客户	CTITest
   USD 组件类型	CTI Desktop Manager
   显示组	HiddenPanel
   程序集 URI	Microsoft.Crm.UnifiedServiceDesk.GenericListener
   程序集类型	Microsoft.Crm.UnifiedServiceDesk.GenericListener.DesktopManager

   备注

   在“程序集 URI”和“程序集类型”字段中指定的值是 CTI Desktop Manager 托管控件类型的常规侦听器值。

   

6. 单击“保存”创建托管控件。

步骤 2：如果 CTI 事件在统一服务台引发，则进行测试

1. 启动 Unified Service Desk 客户端，然后连接到您的 Dynamics 365 实例。 在客户端启动后，选择右上角的设置 以显示调试程序控件，然后选择清除调试输出 以清除桌面。

   

2. 启动 USD CTI Simulator 应用程序，在“关键值”列键入“电子邮件”，在“值”列指定随机值。 单击“发送到 USD”。

   

3. 在客户端应用程序出现屏幕弹出消息以显示 CTI 事件。 在这种情况下，CTILookUpRequest 使用在 USD CTI Simulator 应用程序中指定的值启动。 由于您尚未将其与窗口导航规则关联，因此不再有任何反应。

   

步骤 3：定义窗口导航规则以传送 CtiLookUpRequest

如果找到匹配，则创建窗口导航规则以创建会话，然后在 Unified Service Desk 会话中显示匹配联系人记录

1. 登录到 Microsoft Dynamics 365。

2. 导航到联系人的高级查找，并创建一个查询，在该查询中您可以搜索电子邮件、电子邮件地址 2 或电子邮件地址 3 字段等于某个值，例如 someone_c@example.com 的活动联系人。

   

3. 单击 下载 ​​Fetch XML 以将该查询另存为 FetchXML。

4. 在导航栏上，选择Microsoft Dynamics 365 > “设置”> “统一服务台”>“窗口导航规则”。

5. 单击“新建”在“新建窗口导航规则”窗口上，指定下列值。

   字段	值
   客户	CTITestRoute
   订单	50
   发件人	CTITest 备注 这是您的 CTI Desktop Manager 托管控件的名称。
   方向	两者

   

6. 保存此规则。 它可启用页面上的其他控件。

7. 现在，添加先前为此规则保存的 FetchXML 查询。 在“CTI 搜索”区域下，选择“添加”。

8. 在“新建 CTI 搜索”窗口，指定以下值。

   字段	值
   客户	CTIContactSearch
   订单	1
   FetchXML	<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"> <entity name="contact"> <attribute name="fullname" /> <attribute name="parentcustomerid" /> <attribute name="telephone1" /> <attribute name="emailaddress1" /> <attribute name="contactid" /> <order attribute="fullname" descending="false" /> <filter type="and"> <condition attribute="statecode" operator="eq" value="0" /> <filter type="or"> <condition attribute="emailaddress1" operator="eq" value="[[cti.Email]]" /> <condition attribute="emailaddress2" operator="eq" value="[[cti.Email]]" /> <condition attribute="emailaddress3" operator="eq" value="[[cti.Email]]" /> </filter> </filter> </entity> </fetch> 备注 Unified Service Desk CTI Simulator 应用程序中的地址 someone_c@example.com 已替换为 [[cti.Email]]，以便基于为“电子邮件”关键值指定的值运行搜索。

   

9. 保存搜索 CTI 规则，然后返回到窗口导航规则。

10. 在“单一匹配”下的“决策”字段中，选择“创建会话，加载匹配项，然后执行操作”。

11. 在“单一匹配”下的“操作”字段中，单击搜索图标来选择一个值，然后单击“新建”。

12. 在“新操作调用”页面上，创建操作调用，通过指定以下值打开联系人记录。

    字段	值
    名称	CTIOpenContact
    托管控件	Dynamics 365 全局管理器
    目的	Open_CRM_Page
    数据	Id=[[$Context.Id]]LogicalName=[[$Context.LogicalName]]

    

13. 保存操作调用，然后关闭操作调用页面，返回到窗口导航规则定义页。

14. 在“结果”区域下：

    1. 在“目标”字段，选择​“选项卡”以在选项卡上显示匹配联系人记录。

    2. 在“目标选项卡”字段中，选择“联系人”托管控件。 当使用 包部署程序工具 在 Dynamics 365 服务器上部署示例 Unified Service Desk 应用程序时，会创建“联系人”托管控件。 有关详细信息，请参阅 TechNet：使用 Package Deployer 将示例 Unified Service Desk 应用程序部署到 CRM 服务器。

    3. 在“显示选项卡”字段中，选择“联系人”托管控件。

    

15. 保存窗口导航规则。

测试您的 CTI 适配器

1. 启动 Unified Service Desk 客户端，然后连接到您的 Dynamics 365 实例。 在客户端启动后，选择右上角的设置 以显示调试程序控件，然后选择清除调试输出 以清除桌面。

   

2. 启动 USD CTI Simulator 应用程序，在“关键值”列键入“电子邮件”并为您要搜索的联系人指定有效的电子邮件 ID。 在此示例中，在“值”列键入 someone_d@example.com。 单击“发送到 USD”。

   

3. 匹配联系人记录在 Unified Service Desk会话中显示。

   

4. 检查调试程序托管控件以查看 CTI 搜索引发的事件。 另请检查“数据参数”选项卡，以查看 CTI 变量下的 $Context 变量和 CTI 信息的上下文信息。

另请参阅

使用 CTI 适配器与 CTI 系统集成
UII 计算机电话服务集成 (CTI) 框架

Unified Service Desk 2.0

© 2017 Microsoft。 保留所有权利。 版权