Различия

Здесь показаны различия между двумя версиями данной страницы.

--- doc:1cajam:listening [2012/01/30 10:59]
nb
+++ doc:1cajam:listening [2014/11/14 22:32] (текущий)
@@ Строка 1: / Строка 1: @@
-====== Прослушивание событий передаваемых сервером Asterisk из 1С ======
+====== Прослушивание событий, передаваемых сервером Asterisk из 1С ======
-После инициализации и авторизации компонента на сервере Asterisk, между компонентом и сервером устанавливается HTTP соединение, по которому сервер телефонии передает информацию о текущем состоянии каналов, вызовов, а так же результат выполнения различных команд. Полученный ответы разбираются компонентом при помощи встроенного XML парсера и вызывают в сеансе 1С предприятия встроенную функцию *ВнешнееСобытие*.
+После инициализации и авторизации компонента на сервере Asterisk между компонентом и сервером устанавливается HTTP соединение, по которому сервер телефонии передает информацию о текущем состоянии каналов, вызовов, а так же результат выполнения различных команд. Полученные ответы разбираются компонентом при помощи встроенного XML парсера и вызывают в сеансе 1С:Предприятия встроенную функцию *ВнешнееСобытие*.
 <note tip>Вызов функции возникает при посылке внешним приложением сообщения, сформированного в специальном формате. Внешнее событие сначала обрабатывается всеми открытыми формами, имеющими обработчик этого события, а затем может быть обработано в процедуре модуля обычного приложения с именем ОбработкаВнешнегоСобытия.
 </note>
-Таким образом все события компоненты можно обработать в любой открытой форме или в модуле обычного приложения. В качестве переменных используются 3 строковых параметра:
+Таким образом, все события компонента можно обработать в любой открытой форме или в модуле обычного приложения. В качестве переменных используются 3 строковых параметра:
   * Источник - Источник внешнего события.
   * Событие - Наименование события.
@@ Строка 12: / Строка 12: @@
 В параметр *Источник* всегда передается строка //MikoAjamEvent// которая позволяет однозначно идентифицировать события отправленные компонентой.
-В параметр *Событие* передается наименование [[kb:asterisk:events|события Asterisk]] или строки //Error//, //Exeption// свидетельствующие о возникновении нештатной ситуации, например разрыв связи с Asterisk.
+В параметр *Событие* передается наименование [[kb:asterisk:events|события Asterisk]] или строки //Error//, //Exeption//, свидетельствующие о возникновении нештатной ситуации, например разрыв связи с Asterisk.
-В параметр *Данные* передается XML строка содержащая весь пакет данных полученных от сервера Acterisk без каких либо модификаций или техническую информацию о ошибке в работе компонента.
+В параметр *Данные* передается XML строка, содержащая весь пакет данных, полученных от сервера Acterisk без каких либо модификаций или техническую информацию о ошибке в работе компонента.
 Стандартный вид обработки внешнего события компоненты выглядит так:
@@ Строка 44: / Строка 44: @@
 				///>
-			ИначеЕсли Событие="Bridge" Тогда //2 абонента соеденились и разговаривают
+			ИначеЕсли Событие="Bridge" Тогда //2 абонента соединились и разговаривают
 				//ПРИМЕР ОТВЕТА В ПЕРЕМЕННОЙ "ДАННЫЕ" исходящий звонок с 263 на 04
 				//<generic
@@ Строка 388: / Строка 388: @@
 КонецПроцедуры
 </code>
+В приведенном выше коде мы проиллюстрировали возможный вариант обработки внешних событий компонента. Данные, переданные в параметр *Данные*, представляют из себя XML структуру, которую можно разобрать, используя функцию ЧтениеXML языка 1С:Предприятие 8.
+Пример разбора ответа используя объект ЧтениеXML:
+<code 1c>
+        ЧтениеXML = Новый ЧтениеXML;
+	ЧтениеXML.УстановитьСтроку(Данные);
+        CallerID1	=    ЧтениеXML.ЗначениеАтрибута("Callerid1");
+	CallerID2	=    ЧтениеXML.ЗначениеАтрибута("Callerid2");
+	Channel1	=    ЧтениеXML.ЗначениеАтрибута("Channel1");
+	Channel2	=    ЧтениеXML.ЗначениеАтрибута("Channel2");
+	UniqueID1	=    ЧтениеXML.ЗначениеАтрибута("Uniqueid1");
+	UniqueID2	=    ЧтениеXML.ЗначениеАтрибута("Uniqueid2");
+</code>
+<note important>Объект ЧтениеXML не доступен в режиме веб клиента, потому при использовании такого режима нужно обходиться другими способами разбора строк.</note>
+Например, при использовании WEB клиента Mozilla Firefox мы реализовали разбор ответа следующим образом:
+<code 1c>
+&НаКлиенте
+Процедура ВнешнееСобытие(Источник, Событие, Данные)
+	Если Источник="MikoAjamEvent" Тогда  // проверим ответ от нашей ли компоненты?
+		СтруктураПолей=РазобратьОтветАстериска(Данные);
+		CallerID1	=   СтруктураПолей.Получить("callerid1");
+		CallerID2	=   СтруктураПолей.Получить("callerid2");
+		channel1	=   СтруктураПолей.Получить("channel1");
+        КонецЕсли;
+Конецпроцедуры;
+&НаКлиенте
+// разбирает строку XML в соответсвие ключ - значение
+Функция РазобратьОтветАстериска(Данные)
+	СимволДвоеточиеПробел="=";
+	МассивПодстрок=РазложитьСтрокуВМассивПодстрок(Данные," ");
+	ПараметрыОтвета=Новый Соответствие;
+	Для к=0 по МассивПодстрок.Количество()-1 Цикл
+		СтрокаДляРазбора	= СокрЛП(МассивПодстрок[к]);
+		ПозицияРазделителя	= Найти(СтрокаДляРазбора,СимволДвоеточиеПробел);
+		ДлинаСтроки			= СтрДлина(СтрокаДляРазбора);
+		Если ПозицияРазделителя<>0 Тогда
+			Параметр=Лев(СтрокаДляРазбора,ПозицияРазделителя-1);
+			Значение=Прав(СтрокаДляРазбора,ДлинаСтроки-ПозицияРазделителя-1);
+			Значение=Лев(Значение,СтрДлина(Значение)-1);
+			ПараметрыОтвета.Вставить(Параметр,Значение);
+		КонецЕсли;
+	КонецЦикла;
+	Возврат ПараметрыОтвета;
+КонецФункции //РазобратьОтветАстериска
+&НаКлиенте
+//Переданную строку, разбивает в массив
+Функция РазложитьСтрокуВМассивПодстрок(Знач Стр, Разделитель = ",") Экспорт
+	МассивСтрок = Новый Массив();
+	Если Разделитель = " " Тогда
+		Стр = СокрЛП(Стр);
+		Пока Истина Цикл
+			Поз = Найти(Стр,Разделитель);
+			Если Поз=0 Тогда
+				МассивСтрок.Добавить(Стр);
+				Возврат МассивСтрок;
+			КонецЕсли;
+			МассивСтрок.Добавить(Лев(Стр,Поз-1));
+			Стр = СокрЛ(Сред(Стр,Поз));
+		КонецЦикла;
+	Иначе
+		ДлинаРазделителя = СтрДлина(Разделитель);
+		Пока Истина Цикл
+			Поз = Найти(Стр,Разделитель);
+			Если Поз=0 Тогда
+				МассивСтрок.Добавить(Стр);
+				Возврат МассивСтрок;
+			КонецЕсли;
+			МассивСтрок.Добавить(Лев(Стр,Поз-1));
+			Стр = Сред(Стр,Поз+ДлинаРазделителя);
+		КонецЦикла;
+	КонецЕсли;
+КонецФункции // РазложитьСтрокуВМассивПодстрок
+</code>
+===== Полезные ссылки =====
+  * [[doc:1cajam|SDK: Компонента связи 1C и Asterisk]]
+  * [[doc:1cajam:api|Описание функций реализованных в SDK: Компонента связи 1С и Asterisk]]
+  * [[kb:asterisk:events|Asterisk Manager: Events]]
+===== Комментарии =====
+~~DISQUS~~

Внимание!
Эта wiki об устаревших версиях
Документация к актуальной версии интеграции 1С и телефонии доступна по ссылке

Wiki документация

Различия

Внимание! Эта wiki об устаревших версиях Документация к актуальной версии интеграции 1С и телефонии доступна по ссылке

Wiki документация

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы

Внимание!
Эта wiki об устаревших версиях
Документация к актуальной версии интеграции 1С и телефонии доступна по ссылке