Это старая версия документа!
Панель телефонии может работать в безинтеграцонном режиме. В этом разделе будут описаны достоинства и недостатки данного режима работы. Кроме того, будет описан способ интеграции панели на примере конфигурации УТ 10.3, что позволит использовать функционал панели в полной мере.
Далее будет описан пример интеграции панели, в котором будет предложен вариант преодоления ограничений.
Задача: Необходимо открывать форму панели телефонии автоматически при старте 1С.
Решение:
Имя «МИКО_ИспользованиеСофтфона». Синоним «Использование панели телефонии Asterisk (МИКО)«. Установить права на чтение и использование обработки «МИКО_ПанельТелефонииAsterisk».
Раздел определения переменных:
Перем глОбщиеЗначения Экспорт; // {{{ Панель телефонии Asterisk, МИКО }}} НАЧАЛО Перем Miko_Ajam Экспорт;// МИКО обработка управления звонками // {{{ Панель телефонии Asterisk, МИКО }}} КОНЕЦ Перем глЗапрашиватьПодтверждениеПриЗакрытии Экспорт;
Процедуры - обработчики событий:
Процедура ПриНачалеРаботыСистемы() // ... ... ... Внимание!!! Пропущена часть кода!!! ... ... ... // Открытие формы помощника обновления конфигурации Если РольДоступна(Метаданные.Роли.ПолныеПрава) Тогда ОбработкаОбновлениеКонфигурации = Обработки.ОбновлениеКонфигурации.Создать(); ОбработкаОбновлениеКонфигурации.ПроверитьНаличиеОбновлений(); КонецЕсли; // {{{ Панель телефонии Asterisk, МИКО }}} НАЧАЛО // установка глобадьных переменных Если РольДоступна("ПолныеПрава") ИЛИ РольДоступна("МИКО_ИспользованиеСофтфона") Тогда Попытка Miko_Ajam = Обработки.МИКО_ПанельТелефонииAsterisk.Создать(); Miko_Ajam.ПодключитьСофтФон(); Исключение Сообщить("Ошибка подключения СофтФона (МИКО):", СтатусСообщения.ОченьВажное); Сообщить(ОписаниеОшибки()); КонецПопытки; КонецЕсли; // {{{ Панель телефонии Asterisk, МИКО }}} КОНЕЦ КонецПроцедуры // ПриНачалеРаботыСистемы()
Процедура ОбработкаВнешнегоСобытия(Источник, Событие, Данные) Если мКлиентOnline <> Неопределено Тогда мКлиентOnline.ВнешнееСобытие(Источник, Событие, Данные); КонецЕсли; ПолучитьСерверТО().ЗавершитьОбработкуВнешнегоСобытия(Источник, Событие, Данные); // {{{ Панель телефонии Asterisk, МИКО }}} НАЧАЛО Если Источник = "MikoAjamEvent" И НЕ Miko_Ajam = Неопределено Тогда Miko_Ajam.ОбработкаВнешнегоСобытияАстериск(Источник, Событие, Данные); КонецЕсли; // {{{ Панель телефонии Asterisk, МИКО }}} КОНЕЦ КонецПроцедуры // ОбработкаВнешнегоСобытия()
Процедура ПередЗавершениемРаботыСистемы(Отказ) // ... ... ... Внимание!!! Пропущена часть кода!!! ... ... ... Если НЕ Отказ Тогда // отдельно получаем настройки для которых нужно выполнить обмен при выходе из программы ПроцедурыОбменаДанными.ВыполнитьОбменПриЗавершенииРаботыПрограммы(глЗначениеПеременной("глОбработкаАвтоОбменДанными")); КонецЕсли; // {{{ МИКО }}} НАЧАЛО Панель телефонии Asterisk // Завершим работу Панель телефонии Asterisk перед выходом из предприятия Если НЕ Miko_Ajam = Неопределено Тогда Miko_Ajam.ОтключитьВК(); КонецЕсли; // {{{ МИКО }}} КОНЕЦ Панель телефонии Asterisk КонецПроцедуры
Задача: необходимо хранить связку документа события с записью в истории звонков. При открытии документа события из истории, должен открываться документ сформированный ранее по этой записи.
Решение: для документа «Событие» необходимо добавить новый реквизит:
————————————————————————————————
Задача: необходимо добавить возможность прослушать запись разговора, связанного с документом «Событие», из формы документа. Кроме того необходимо добавить возможность набрать номер контрагента, либо его контактного лица из формы документа.
Решение: необходимо модифицировать модуль формы документа:
// Обработчик события ПриОткрытии формы. // Процедура ПриОткрытии() // ... ... ... мПоследнееЗначениеЭлементаПоискаПоСтрокеКонтрагент = Контрагент; мПоследнееЗначениеЭлементаПоискаПоСтрокеКонтактноеЛицо = КонтактноеЛицо; мТекущаяДатаДокумента = Дата; // {{{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И Miko_Ajam.МИКО_ОбщийМодуль.ИспользоватьСофтФон() Тогда МИКО_ОбщийМодуль = Miko_Ajam.МИКО_ОбщийМодуль; // добавляем кнопку вызова МИКО_ОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.ДействияФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерВыбравИзСписка"); // добавляем кнопку прослушивания записи разговора МИКО_ОбщийМодуль.ДобавитьКнопкуПрослушиванияЗаписиНаПанельДействий(ЭлементыФормы.ДействияФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_ПрослушатьЗапись"); КонецЕсли; // {{{ МИКО Панель телефонии Asterisk }}} КОНЕЦ Модифицированность = Ложь; КонецПроцедуры // ПриОткрытии()
добавить в форму обработчик нажатия кнопок:
// Набор номера по заданному алгоритму // Процедура МИКО_ВыполнитьДействие(Кнопка) Действие = Кнопка.Имя; Если НЕ Miko_Ajam.глИспользоватьСофтФонMIKO_AjamТекущийПользователь Тогда Возврат; КонецЕсли; Если Действие = "кнМИКО_НабратьНомерВыбравИзСписка" Тогда // Позвонить по телефону выбранному пользователем из списка, определенных у контрагента и контактного лица СписокОбъектов = Новый Структура(); СписокОбъектов.Вставить("Контрагент", Контрагент); СписокОбъектов.Вставить("КонтактноеЛицо", КонтактноеЛицо); // Данные незарегистрированных контрагентов: СписокОбъектов.Вставить("Событие", Ссылка); Miko_Ajam.ПозвонитьВыбравТелефон(СписокОбъектов); ИначеЕсли Действие = "кнМИКО_ПрослушатьЗапись" Тогда Если НЕ ЗначениеЗаполнено(CRM_GUIDЗвонка) Тогда Сообщить("К событию не прикреплено записи разговора!"); Возврат; КонецЕсли; // Прослушать запись разговора, прикрепленного к событию Miko_Ajam.ПрослушатьЗаписьРазговора(CRM_GUIDЗвонка); КонецЕсли; КонецПроцедуры
Документ при открытии будет выглядеть следующим образом:
Задача: необходимо, для поиска номеров в базе использовать запрос не по временной таблице, а непосредственно по регистру сведений «КонтактнаяИнформация».
Решение: необходимо модифицировать регистр сведений «КонтактнаяИнформация»: Добавить ресурсы:
В модуле набора записей изменить процедуру:
Процедура ПередЗаписью(Отказ, Замещение) Если ОбменДанными.Загрузка Тогда Возврат; КонецЕсли; Для каждого Запись Из ЭтотОбъект Цикл Если НЕ ЗначениеЗаполнено(Запись.Объект) Тогда Отказ = Истина; СтрокаОтказа = "Не заполнен объект."; Продолжить; КонецЕсли; Если Запись.Объект.ЭтоГруппа Тогда Отказ = Истина; СтрокаОтказа = "Нельзя использовать в качестве объекта контактной информации - группу."; Прервать; КонецЕсли; //{{{ МИКО }}} НАЧАЛО Код встраивания "Панель телефонии Asterisk" Если НЕ Miko_Ajam = Неопределено И НЕ Miko_Ajam.МИКО_ОбщийМодуль = Неопределено И Запись.Тип = Перечисления.ТипыКонтактнойИнформации.Телефон Тогда МИКО_ПредставлениеНомера = Запись.Поле1 +Запись.Поле2 +Запись.Поле3; Если ЗначениеЗаполнено(Запись.Поле4) И НЕ ЗначениеЗаполнено(МИКО_ПредставлениеНомера) Тогда Запись.CRM_ПолеХраненияНомера = Miko_Ajam.МИКО_ОбщийМодуль.ПреобразоватьНомерДляСохранения(Запись.Поле4, Miko_Ajam.глКоличествоХранимыхЦифрТелефона); Запись.CRM_НомерТелефона = Miko_Ajam.МИКО_ОбщийМодуль.УдалитьБуквыИзНомераТелефона (Запись.Поле4); Иначе Запись.CRM_ПолеХраненияНомера = Miko_Ajam.МИКО_ОбщийМодуль.ПреобразоватьНомерДляСохранения (МИКО_ПредставлениеНомера, Miko_Ajam.глКоличествоХранимыхЦифрТелефона); Запись.CRM_НомерТелефона = Miko_Ajam.МИКО_ОбщийМодуль.УдалитьБуквыИзНомераТелефона (МИКО_ПредставлениеНомера); КонецЕсли; КонецЕсли; //{{{ МИКО }}} КОНЕЦ КонецЦикла; Если Отказ Тогда Сообщить(СтрокаОтказа); КонецЕсли; КонецПроцедуры
После этого, добавленные ранее ресурсы, будут заполняться надлежащим образом.
Задача: необходимо, добавить возможность произвести звонок из карточки контрагента.
Решение: необходимо модифицировать форму элемента справочника «Контрагенты»:
// Обработчик события ПриОткрытии формы. // Процедура ПриОткрытии() // ... ... ... Внимание!!! Отсутствует часть исходного кода!!! // Установить печатную форму по умолчанию. РаботаСДиалогами.УстановитьКнопкуПечати(ЭтотОбъект, ЭтаФорма); // {{{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И Miko_Ajam.МИКО_ОбщийМодуль.ИспользоватьСофтФон() Тогда МИКО_ОбщийМодуль = Miko_Ajam.МИКО_ОбщийМодуль; // добавляем элементы управления на форму МИКО_ОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.ДействияФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерВыбравИзСписка"); МИКО_ОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерИзКИ"); МИКО_ОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.КоманднаяПанельКонтактныеЛицаКонтрагента.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерВыбравКЛ"); // ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация.ИзменяетДанные = Ложь; КонецЕсли; // {{{ МИКО Панель телефонии Asterisk }}} КОНЕЦ КонецПроцедуры
добавить обработчик нажатия кнопок:
// Набор номера по заданному алгоритму // Процедура МИКО_ВыполнитьДействие(Кнопка) Действие = Кнопка.Имя; Если НЕ Miko_Ajam.глИспользоватьСофтФонMIKO_AjamТекущийПользователь Тогда Возврат; КонецЕсли; Если Действие = "кнМИКО_НабратьНомерИзКИ" Тогда // Позвонить по выбранному контакту ТекущаяСтрока = ЭлементыФормы.КонтактнаяИнформация.ТекущиеДанные; Если НЕ ТекущаяСтрока = Неопределено Тогда Miko_Ajam.НабратьНомерКИ(ЭлементыФормы.КонтактнаяИнформация.ТекущиеДанные); КонецЕсли; ИначеЕсли Действие = "кнМИКО_НабратьНомерВыбравИзСписка" ТОгда // Позвонить по телефону, выбранному пользователем из списка телефонов определенных у контрагента и контактного лица СписокОбъектов = Новый Структура(); СписокОбъектов.Вставить("Контрагент", Ссылка); СписокОбъектов.Вставить("КонтактноеЛицо", ОсновноеКонтактноеЛицо); Если НЕ Ссылка = ГоловнойКонтрагент Тогда СписокОбъектов.Вставить("КонтактноеЛицо", ГоловнойКонтрагент); КонецЕсли; Miko_Ajam.ПозвонитьВыбравТелефон(СписокОбъектов); ИначеЕсли Действие = "кнМИКО_НабратьНомерВыбравКЛ" Тогда // Позовонить выбранному контактному лицу ТекущиеДанные = ЭлементыФормы.КонтактныеЛицаКонтрагента.ТекущиеДанные; Если НЕ ТекущиеДанные = Неопределено Тогда СписокОбъектов = Новый Структура(); СписокОбъектов.Вставить("КонтактноеЛицо", ТекущиеДанные.Ссылка); Miko_Ajam.ПозвонитьВыбравТелефон(СписокОбъектов); КонецЕсли; ИначеЕсли Действие = "УстановитьДоступностьКнопокСофтфона" Тогда Miko_Ajam.МИКО_ОбщийМодуль.УстановитьДоступностьКнопокСофтфона(ЭлементыФормы.КонтактнаяИнформация.ТекущиеДанные, ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация.Кнопки, "кнМИКО_НабратьНомерИзКИ"); КонецЕсли; КонецПроцедуры
Кнопки должны быть доступны только для контактной информации с типом «Телефон»
// Обработчик события ПриАктивизацииСтроки элемента формы КонтактнаяИнформация. // Процедура КонтактнаяИнформацияПриАктивизацииСтроки(Элемент) УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПриАктивизацииСтрокиТаблицы(Элемент, ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация.Кнопки.УстановитьОсновным); // {{{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И Miko_Ajam.МИКО_ОбщийМодуль.ИспользоватьСофтФон() Тогда МИКО_ВыполнитьДействие(Новый Структура("Имя","УстановитьДоступностьКнопокСофтфона")); КонецЕсли; // {{{ МИКО Панель телефонии Asterisk }}} КОНЕЦ КонецПроцедуры
Задача: необходимо, добавить возможность отправки сформированной печатной формы в виде факсимильного сообщения в текущий вызов.
Решение: необходимо модифицировать общую форму «ПечатьДокументов»:
Процедура ПриОткрытии() ЭлементыФормы.ПолеТабличногоДокумента.ВставитьОбласть(ПечатныйДокумент.Область()); ЭлементыФормы.ПолеТабличногоДокумента.ОтображатьЗаголовки = Ложь; ЭлементыФормы.ПолеТабличногоДокумента.ОтображатьСетку = Ложь; ЭлементыФормы.ПолеТабличногоДокумента.Защита = Защита; ЭлементыФормы.ПолеТабличногоДокумента.ТолькоПросмотр = Истина; ЭлементыФормы.ПолеТабличногоДокумента.ИмяПараметровПечати = ПечатныйДокумент.ИмяПараметровПечати; ЭлементыФормы.ПолеТабличногоДокумента.ПовторятьПриПечатиСтроки = ПечатныйДокумент.ПовторятьПриПечатиСтроки; // {{{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И Miko_Ajam.МИКО_ОбщийМодуль.ИспользоватьСофтФон() Тогда МИКО_ОбщийМодуль = Miko_Ajam.МИКО_ОбщийМодуль; // добавляем элементы управления на форму МИКО_ОбщийМодуль.ДобавитьКнопкуОтправкиФаксаНаПанельДействий(ЭлементыФормы.КоманднаяПанельФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_ОтправитьФакс"); КонецЕсли; // {{{ МИКО Панель телефонии Asterisk }}} КОНЕЦ КонецПроцедуры
добавить обработчик нажатия кнопки:
// Набор номера по заданному алгоритму // Процедура МИКО_ВыполнитьДействие(Кнопка) Действие = Кнопка.Имя; Если Miko_Ajam.глИспользоватьСофтФонMIKO_AjamТекущийПользователь = Ложь Тогда Возврат; КонецЕсли; Если Действие = "кнМИКО_ОтправитьФакс" Тогда // Обработчик нажатия на кнопку отправки табличного документа в текущий разговор Miko_Ajam.ОтправитьФаксомТабДок(ЭлементыФормы.ПолеТабличногоДокумента); КонецЕсли; КонецПроцедуры