Web-интеграция с CRM — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
Строка 8: Строка 8:
  
 
Позволяет выбрать направление подключения. Если Oktell подсоединяется к CRM, то веб-сервер CRM должен ожидать подключения и websock-рукопожатия согласно протоколу, если наоборот, то Oktell ждет подключения на указанном порте, ожидает инициации рукопожатия от CRM. Ожидается, что в случае потери связи между серверами восстановлением канала занимается именно инициатор.
 
Позволяет выбрать направление подключения. Если Oktell подсоединяется к CRM, то веб-сервер CRM должен ожидать подключения и websock-рукопожатия согласно протоколу, если наоборот, то Oktell ждет подключения на указанном порте, ожидает инициации рукопожатия от CRM. Ожидается, что в случае потери связи между серверами восстановлением канала занимается именно инициатор.
При организации подключения из Oktell позволяет выбрать один из протоколов WebSocket, включая определенную RFC6455 версию 13.
+
 
Также здесь возможно активировать режим клиентских подключений к серверу Oktell по протоколу web-socket. В этом случае сервер позволяет одновременно существовать нескольким подключениям, причем каждое из них представляет отдельного пользователя и несколько разных подключений могут представлять одного и того же пользователя (разные вкладки браузера).
+
При организации подключения из Oktell позволяет выбрать один из протоколов WebSocket, включая определенную RFC6455 версию 13. При необходимости Oktell осуществляет Basic или Digest HTTP-авторизацию.
 +
 
 +
При подключении CRM к Oktell возможен выбор способа HTTP авторизации.
 +
 
 +
Также здесь возможно активировать режим клиентских подключений к серверу Oktell по протоколу web-socket (Браузеры к Oktell). В этом случае сервер позволяет одновременно существовать нескольким подключениям, причем каждое из них представляет отдельного пользователя и несколько разных подключений могут представлять одного и того же пользователя (разные вкладки браузера).
 +
 
 +
 
 +
'''Логин для серверной авторизации'''
 +
 
 +
'''Пароль для серверной авторизации'''
 +
 
 +
В режимах Oktell к CRM и CRM к Oktell применяются для прохождения/проведения авторизации.
 +
 
 +
 
 +
'''Метод отправки больших сообщений'''
 +
 
 +
При необходимости можно установить разбивку больших сообщений на фреймы. При этом предельным размером одного фрейма считается объем в 64 КБ. Большие разбиваются на фреймы по 32 КБ.
  
  
 
'''Адрес web-socket сервера'''
 
'''Адрес web-socket сервера'''
 +
 
'''Порт web-socket сервера'''
 
'''Порт web-socket сервера'''
  
Строка 29: Строка 46:
  
 
'''Название протокола'''
 
'''Название протокола'''
Для предварительной фильтрации и некой строгости возможно указание (или строгое ожидание) в websock-рукопожатии четкого названия протокола. К названию протокола также добавляется формат (json/xml) и версия протокола.
+
Для предварительной фильтрации и некой строгости возможно указание (или строгое ожидание) в websock-рукопожатии четкого названия протокола. К названию протокола также добавляется формат («json» или «xml») и версия протокола (1.0).
  
  
 
'''Формат обмена данными'''
 
'''Формат обмена данными'''
 
JSON/XML. Способ упаковки пересылаемых данных в текстовый вид.
 
JSON/XML. Способ упаковки пересылаемых данных в текстовый вид.

Версия 13:25, 13 сентября 2012

Подробно c механизмом интеграции по web-socket протоколу с web-системами и интерфейсами протокола можно ознакомиться в статье «Интеграции. Web-Socket». Поддерживается работа только с одной web-crm системой одновременно в соответствии с настройками, описанными в текущем разделе.


Способ соединения с Web-Socket CRM.

Позволяет выбрать направление подключения. Если Oktell подсоединяется к CRM, то веб-сервер CRM должен ожидать подключения и websock-рукопожатия согласно протоколу, если наоборот, то Oktell ждет подключения на указанном порте, ожидает инициации рукопожатия от CRM. Ожидается, что в случае потери связи между серверами восстановлением канала занимается именно инициатор.

При организации подключения из Oktell позволяет выбрать один из протоколов WebSocket, включая определенную RFC6455 версию 13. При необходимости Oktell осуществляет Basic или Digest HTTP-авторизацию.

При подключении CRM к Oktell возможен выбор способа HTTP авторизации.

Также здесь возможно активировать режим клиентских подключений к серверу Oktell по протоколу web-socket (Браузеры к Oktell). В этом случае сервер позволяет одновременно существовать нескольким подключениям, причем каждое из них представляет отдельного пользователя и несколько разных подключений могут представлять одного и того же пользователя (разные вкладки браузера).


Логин для серверной авторизации

Пароль для серверной авторизации

В режимах Oktell к CRM и CRM к Oktell применяются для прохождения/проведения авторизации.


Метод отправки больших сообщений

При необходимости можно установить разбивку больших сообщений на фреймы. При этом предельным размером одного фрейма считается объем в 64 КБ. Большие разбиваются на фреймы по 32 КБ.


Адрес web-socket сервера

Порт web-socket сервера

В случае, если Oktell является инициатором подключения, задают адрес и порт слушателя web-socket подключений со стороны CRM. Если настройка меняется в ходе работы, производится разрыв текущего соединения и организация нового. При наладке глобальных серверов CRM, способных обслуживать несколько различных серверов Oktell, следует иметь в виду, что каждому серверу Oktell нужен независимый web-socket-сервер на стороне CRM, чтобы не пересекались потоки данных. Для этого следует настраивать разные серверы или разные экземпляры служб, слушающих разные порты. Различий на этапе самого подключения между разными октеллами нет, хотя после стандартного websock-рукопожатия серверы обмениваются данными друг о друге.


URL web-сервера

Устанавливает адрес веб-сервера CRM, способного заниматься обработкой части запросов. В рамках интерфейса взаимодействия с WebCRM между системами происходит обмен данными о поддерживаемых динамических методах (подробно в «Интеграции. Web-Socket»). В рамках описания динамического метода CRM-система может декларировать вызов не по web-socket каналу, а отдельным подключением и http-запросом. Как правило это делается для методов, возвращающих большой объем данных и вызываемых не слишком часто. Вызов таких методов настраивается в сценариях с помощью компонента «Действие/карточка в Plugin или WebCRM»%%% и производится на указанный здесь URL.


Порт слушателя подключений Для случая, когда CRM является инициатором web-socket подключения, она должна производить подключение к серверу Oktell на указанный здесь порт.


Название протокола Для предварительной фильтрации и некой строгости возможно указание (или строгое ожидание) в websock-рукопожатии четкого названия протокола. К названию протокола также добавляется формат («json» или «xml») и версия протокола (1.0).


Формат обмена данными JSON/XML. Способ упаковки пересылаемых данных в текстовый вид.