Пошаговое руководство. Использование адаптера универсального прослушивателя для маршрутизации событий CTI

В этом пошаговом руководстве показано, как можно использовать диспетчер рабочего стола CTI и универсальный прослушиватель в Unified Service Desk для представления событий CTI в виде всплывающих окон Unified Service Desk. В этом пошаговом руководстве мы используем пример приложения CTI Simulator, которое отправляет запросы CTI на Unified Service Desk.

В этом пошаговом руководстве:

• Искать запись контакта в образце данных Microsoft Dynamics CRM по адресу электронной почты, заданному в примере приложения CTI Call Tester.

• Создавать правила навигации по окнам для отображения совпадающих записей в сеансе в Unified Service Desk.

Содержание

Необходимые условия

Шаг 1. Настройте размещенный элемент управления диспетчера рабочего стола CTI в Unified Service Desk

Шаг 2. Проверьте, что события CTI вызываются в Unified Service Desk

Шаг 3. Укажите правило навигации по окнам для маршрутизации запроса CtiLookUpRequest

Тестирование адаптера CTI

Необходимые условия

• Microsoft .NET Framework 4.5.2

• Клиентское приложение Unified Service Desk; обязательно для тестирования размещенного элемента управления.

• Microsoft Visual Studio 2012 или Visual Studio 2013

• Загрузите проект Visual Studio с примером приложения CTI Simulator на свой компьютер:. Собирать проект и запускать приложение (файл .exe) из папки bin\debug образца проекта приложения. Необходимо запустить приложение USD CTI Simulator на том же компьютере, где запущен клиент Unified Service Desk, чтобы протестировать приложение.

Шаг 1. Настройте размещенный элемент управления диспетчера рабочего стола CTI в Unified Service Desk

1. Выполните вход в Microsoft Dynamics CRM.

2. На панели навигации перейдите в раздел Microsoft Dynamics CRM > Параметры > Unified Service Desk.

3. На странице Unified Service Desk щелкните Размещенные элементы управления.

4. На странице Размещенные элементы управления щелкните Создать.

5. На странице Создать размещенный элемент управления укажите следующие значения.

   Поле	Значение
   Полное имя	CTITest
   Тип компонента USD	CTI Desktop Manager
   Группа отображения	HiddenPanel
   URI сборки	Microsoft.Crm.UnifiedServiceDesk.GenericListener
   Тип сборки	Microsoft.Crm.UnifiedServiceDesk.GenericListener.DesktopManager

   Примечание

   Значения, указанные в полях URI сборки и Тип сборки, являются значениями универсального прослушивателя для типа размещенного элемента управления диспетчера рабочего стола CTI.

6. Нажмите кнопку Сохранить, чтобы создать размещенный элемент управления.

Шаг 2. Проверьте, что события CTI вызываются в Unified Service Desk

1. Запустите клиент Unified Service Desk и подключитесь к вашему экземпляру CRM. После того как клиент запущен, выберите Параметры в правом верхнем углу, чтобы отобразить элемент управления «Отладчик», а затем выберите Очистить выходные данные отладки, чтобы очистить рабочий стол.

2. Запустите приложение USD CTI Simulator, напечатайте Email в столбце Ключ и укажите случайный адрес электронной почты в столбце Значение. Нажмите кнопку Отправить на USD.

3. Всплывающее окно возникает в клиентском приложении, чтобы отразить событие CTI. Запускается поисковый запрос CTILookUpRequest по значению, указанному в приложении USD CTI Simulator. Поскольку вы не задали никакого правила навигации по окнам, больше ничего не произойдет.

Шаг 3. Укажите правило навигации по окнам для маршрутизации запроса CtiLookUpRequest

Создайте правило навигации по окнам для создания сеанса в случае, если обнаружено совпадение, а затем укажите соответствующую контактную запись в сеансе в Unified Service Desk.

1. Выполните вход в Microsoft Dynamics CRM.

2. Перейдите в расширенный поиск контактов и создайте запрос для поиска активных контактов, в которых поля "Адрес электронной почты", "Адрес электронной почты 2" или "Адрес электронной почты 3" совпадают с определенным значением, например someone_c@example.com.

3. Щелкните по Загрузить Fetch XML для сохранения запроса как FetchXML.

4. На панели навигации выберите Microsoft Dynamics CRM > Параметры > Unified Service Desk > Правила навигации по окнам.

5. Нажмите Создать и в окне Новое правило навигации по окнам укажите следующие значения.

   Поле	Значение
   Полное имя	CTITestRoute
   Заказ	50
   От	CTITest Примечание Это имя размещенного элемента управления диспетчера рабочего стола CTI.
   Направление	Оба

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> Примечание Адрес someone_c@example.com был заменен на [[cti.Email]], поэтому поиск выполняется на основе значения, указанного для ключа Email в приложении Unified Service Desk CTI Simulator.

9. Сохраните правило поиска CTI и вернитесь к правилу навигации по окнам.

10. В разделе Одно совпадение в поле Решение выберите Создать сеанс, загрузить соответствие, затем выполнить действие.

11. В разделе Одно совпадение в поле Действие щелкните значок поиска, чтобы выбрать значение, а затем нажмите Создать.

12. На странице Новый вызов действия создайте вызов действия для открытия записи контакта путем указания следующих значений.

    Поле	значение
    Полное имя	CTIOpenContact
    Размещенный элемент управления	Глобальный диспетчер CRM
    Действие	Open_CRM_Page
    Данные	Id=[[$Context.Id]] LogicalName=[[$Context.LogicalName]]

13. Сохраните вызов действия и закройте страницу вызова действия для возврата на страницу определения правила навигации по окнам.

14. В разделе Результат:

    1. В поле Назначение выберите Вкладка, чтобы отобразить совпадающие записи контакта на вкладке.

    2. В поле Целевая вкладка выберите размещенный элемент управления Контакт. Размещенный элемент управления Контакт был создан при развертывании приложения-образца Unified Service Desk на сервере CRM с помощью Средство развертывания пакетов. Дополнительные сведения см. в статье TechNet: Развертывание приложений-образцов Unified Service Desk на сервере CRM с помощью Package Deployer.

    3. В поле Показать вкладку выберите размещенный элемент управления Контакт.

15. Сохранение правила навигации по окнам.

Тестирование адаптера CTI

1. Запустите клиент Unified Service Desk и подключитесь к вашему экземпляру CRM. После того как клиент запущен, выберите Параметры в правом верхнем углу, чтобы отобразить элемент управления «Отладчик», а затем выберите Очистить выходные данные отладки, чтобы очистить рабочий стол.

2. Запустите приложение USD CTI Simulator, напечатайте Email в столбце Ключ и укажите существующий идентификатор электронной почты для контакта, который требуется найти. В данном случае напечатайте someone_d@example.com в столбце Значение. Нажмите кнопку Отправить на USD.

3. Соответствующая контактная запись отображается в сеансе в Unified Service Desk.

4. Проверьте размещенный элемент управления "Отладчик" для просмотра событий, вызванных в результате поиска CTI. Также проверьте вкладку Параметры данных для просмотра контекстной информации в переменной $Context и информацию CTI в переменной CTI.

См. также

Основные понятия:

Платформа интеграции компьютерной телефонии UII (CTI)

Другие ресурсы

Интеграция с системами CTI с использованием адаптеров CTI

Unified Service Desk
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.