Oktell AMI Adapter — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
Строка 4: Строка 4:
  
 
'''Oktell AMI Adapter''' - это служба для интеграции '''Asterisk''' и '''Oktell'''. Взаимодействие происходит путем обмена сообщениями по постоянному установившемуся TCP-каналу.  
 
'''Oktell AMI Adapter''' - это служба для интеграции '''Asterisk''' и '''Oktell'''. Взаимодействие происходит путем обмена сообщениями по постоянному установившемуся TCP-каналу.  
 +
 +
<span style="color:red">ВНИМАНИЕ: Для работы требуется предустановленный .NET Framework v4.5 ([[http://go.microsoft.com/fwlink/?LinkId=321331 Скачать]]).
 +
  
 
=== Подготовка Oktell===
 
=== Подготовка Oktell===
Строка 23: Строка 26:
 
===Установка Oktell AMI Adapter===  
 
===Установка Oktell AMI Adapter===  
  
−
'''Шаг 1.''' '''Регистрация службы Oktell.AMI.Adapter.''' Для этого необходимо воспользоваться программой InstallUtil по адресу C:\Windows\Microsoft.NET\Framework\v1.1.4322 (на ОС Windows 7).  
+
'''Шаг 1.''' '''Регистрация службы Oktell.AMI.Adapter.''' Для этого необходимо воспользоваться программой '''InstallUtil''' по адресу C:\Windows\Microsoft.NET\Framework\v4.0.30319 (на ОС Windows 7).  
  
 
В командной строке заходим в папку с программой и выполняем команду (в примере '''Oktell.AMI.Adapter.Svc.exe''' находится в папке '''C:\AMI_Adapter''').
 
В командной строке заходим в папку с программой и выполняем команду (в примере '''Oktell.AMI.Adapter.Svc.exe''' находится в папке '''C:\AMI_Adapter''').
Строка 35: Строка 38:
  
 
'''Шаг 2.''' '''Редактирование конфигурационного файла Oktell AMI Adapter'''. Откройте файл '''Oktell.AMI.Adapter.Svc.exe.config'''.
 
'''Шаг 2.''' '''Редактирование конфигурационного файла Oktell AMI Adapter'''. Откройте файл '''Oktell.AMI.Adapter.Svc.exe.config'''.
−
 
−
Конфигурационный файл имеет следующие параметры:
 
−
*'''OktellWebSocketUrl''' - адрес для web-socket подключения к серверу Oktell. По умолчанию, «'''ws://192.168.0.82:4067'''».
 
−
*'''OktellWebSocketUrl_2''' - адрес для web-socket подключения к другому серверу Oktell. Используется для обеспечения отказоустойчивости системы.
 
−
*'''OktellWebSocketUrl_3''' - адрес для web-socket подключения к третьему серверу Oktell. Используется для обеспечения отказоустойчивости системы.
 
−
*'''TcpListenerEndPoint''' - интерфейс и порт слушателя tcp-подключений. По умолчанию, «'''127.0.0.1:8888'''».
 
−
*'''OktellScriptName''' - название сценария обработки запросов. По умолчанию, «'''some_script'''».
 
−
*'''EnableAdapterLog''' - логирование работы адаптера. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».
 
−
*'''EnableAMIConnectionLog''' - логирование подключений. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».
 
−
*'''EnableOktellConnectionLog''' - логирование соединений с сервером Oktell. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».
 
−
*'''ConvertAmiToXml''' - преобразование AMI протокола в XML для удобства парсинга. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».
 
−
 
  
 
Для работы '''Oktell AMI Adapter''':  
 
Для работы '''Oktell AMI Adapter''':  
Строка 66: Строка 57:
  
 
=== Настройка сценария обработки запросов ===
 
=== Настройка сценария обработки запросов ===
 +
 +
Все запросы, поступающие в Oktell AMI Adapter, пересылаются в Oktell. При этом запускается сценарий (параметр конфигурационного файла '''OktellScriptName'''), на вход которого передается текст сообщения в XML-формате. Преобразование сообщение в XML-формат задается в конфигурационном файле в параметре '''ConvertAmiToXml'''.
 +
 +
Действия сценария при получении запроса:
 +
 +
1. Разбор и анализ поступившего сообщения
 +
 +
2. Выполнение действий и формирование ответа
 +
 +
3. Отправка сообщения в Oktell AMI Adapter
 +
 +
 +
Создайте сценарий с названием, которое прописано в конфигурационном файле. В примере, '''AMI_ADAPTER_Script'''.
 +
 +
 +
  
 
=== Проверка работы ===
 
=== Проверка работы ===
 +
 +
 +
 +
=== Конфигурационный файл===
 +
 +
Откройте папку с '''Oktell AMI Adapter'''. Конфигурационный файл '''Oktell.AMI.Adapter.Svc.exe.config''' находится в корне папки, открывается с помощью блокнота (рекомендуется использовать notepad++).
 +
 +
Конфигурационный файл имеет следующие параметры:
 +
*'''OktellWebSocketUrl''' - адрес для web-socket подключения к серверу Oktell. По умолчанию, «'''ws://192.168.0.82:4067'''».
 +
*'''OktellWebSocketUrl_2''' - адрес для web-socket подключения к другому серверу Oktell. Используется для обеспечения отказоустойчивости системы.
 +
*'''OktellWebSocketUrl_3''' - адрес для web-socket подключения к третьему серверу Oktell. Используется для обеспечения отказоустойчивости системы.
 +
*'''TcpListenerEndPoint''' - интерфейс и порт слушателя tcp-подключений. По умолчанию, «'''127.0.0.1:8888'''».
 +
*'''OktellScriptName''' - название сценария обработки запросов. По умолчанию, «'''some_script'''».
 +
*'''EnableAdapterLog''' - логирование работы адаптера. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».
 +
*'''EnableAMIConnectionLog''' - логирование подключений. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».
 +
*'''EnableOktellConnectionLog''' - логирование соединений с сервером Oktell. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».
 +
*'''ConvertAmiToXml''' - преобразование сообщения на языке AMI протокола в XML для удобства парсинга. «0» - не активно, «1» - активно. По умолчанию, «'''1'''».

Версия 06:48, 21 марта 2014

Наверх

Oktell AMI Adapter - это служба для интеграции Asterisk и Oktell. Взаимодействие происходит путем обмена сообщениями по постоянному установившемуся TCP-каналу.

ВНИМАНИЕ: Для работы требуется предустановленный .NET Framework v4.5 ([Скачать]).


Подготовка Oktell

Шаг 1. Настройте Web-сервер Oktell. Воспользуйтесь статьей: Настройка Web-сервера Oktell.

Шаг 2 Настройте способ соединения Oktell и AMI Adapter.

  • Перейдите в Администрирование - Общие настройки - Web-интеграция с CRM.
  • Выберите следующие настройки
  • Способ соединения с сервером CRM - CRM к Oktell (WebSocket)
  • Порт WebSocket Oktell для CRM - выберите порт для WebSocket-соединения. В примере, 4067
  • Авторизация - Без авторизации
  • Нажмите "Сохранить"


AmiAdapter-002.png


Установка Oktell AMI Adapter

Шаг 1. Регистрация службы Oktell.AMI.Adapter. Для этого необходимо воспользоваться программой InstallUtil по адресу C:\Windows\Microsoft.NET\Framework\v4.0.30319 (на ОС Windows 7).

В командной строке заходим в папку с программой и выполняем команду (в примере Oktell.AMI.Adapter.Svc.exe находится в папке C:\AMI_Adapter). 

C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe C:\AMI_Adapter\Oktell.AMI.Adapter.Svc.exe


AmiAdapter-001.png


Шаг 2. Редактирование конфигурационного файла Oktell AMI Adapter. Откройте файл Oktell.AMI.Adapter.Svc.exe.config.

Для работы Oktell AMI Adapter:

  • Введите адрес для подключения к web-серверу Oktell: 
<add key="OktellWebSocketUrl" value="ws://127.0.0.1:4067" />
  • Введите интерфейс и порт слушателя: 
<add key="TcpListenerEndPoint" value="127.0.0.1:8888" />
  • Введите название сценария обработки запросов: 
<add key="OktellScriptName" value="AMI_ADAPTER_Script" />


Шаг 3. Запуск службы Oktell.AMI.Adapter.

  • Откройте "Управление службами" (Мой компьютер "правой кнопкой" -> Управление -> Службы и приложения -> Службы).
  • Запустите службу Oktell.AMI.Adapter.


AmiAdapter-003.png


Настройка сценария обработки запросов

Все запросы, поступающие в Oktell AMI Adapter, пересылаются в Oktell. При этом запускается сценарий (параметр конфигурационного файла OktellScriptName), на вход которого передается текст сообщения в XML-формате. Преобразование сообщение в XML-формат задается в конфигурационном файле в параметре ConvertAmiToXml.

Действия сценария при получении запроса:

1. Разбор и анализ поступившего сообщения

2. Выполнение действий и формирование ответа

3. Отправка сообщения в Oktell AMI Adapter


Создайте сценарий с названием, которое прописано в конфигурационном файле. В примере, AMI_ADAPTER_Script.



Проверка работы

Конфигурационный файл

Откройте папку с Oktell AMI Adapter. Конфигурационный файл Oktell.AMI.Adapter.Svc.exe.config находится в корне папки, открывается с помощью блокнота (рекомендуется использовать notepad++).

Конфигурационный файл имеет следующие параметры:

  • OktellWebSocketUrl - адрес для web-socket подключения к серверу Oktell. По умолчанию, «ws://192.168.0.82:4067».
  • OktellWebSocketUrl_2 - адрес для web-socket подключения к другому серверу Oktell. Используется для обеспечения отказоустойчивости системы.
  • OktellWebSocketUrl_3 - адрес для web-socket подключения к третьему серверу Oktell. Используется для обеспечения отказоустойчивости системы.
  • TcpListenerEndPoint - интерфейс и порт слушателя tcp-подключений. По умолчанию, «127.0.0.1:8888».
  • OktellScriptName - название сценария обработки запросов. По умолчанию, «some_script».
  • EnableAdapterLog - логирование работы адаптера. «0» - не активно, «1» - активно. По умолчанию, «1».
  • EnableAMIConnectionLog - логирование подключений. «0» - не активно, «1» - активно. По умолчанию, «1».
  • EnableOktellConnectionLog - логирование соединений с сервером Oktell. «0» - не активно, «1» - активно. По умолчанию, «1».
  • ConvertAmiToXml - преобразование сообщения на языке AMI протокола в XML для удобства парсинга. «0» - не активно, «1» - активно. По умолчанию, «1».
Источник — «https://wiki.oktell.ru/index.php?title=Oktell_AMI_Adapter&oldid=7917»