Данный документ относится только к версии Панели телефонии v.2 и предназначен для конфигураций:

• 1С:Рарус Альфа-Авто: Автосервис+Автозапчасти ред.4

Режим встраивания дает возможность использования в ресурсов панели телефонии оператора из других участков конфигурации.

1. Откройте конфигурацию в режиме «Конфигуратор»

2. Выполните настройку поддержки, как показано на рисунке ниже

3. Выполните настройку возможности изменения конфигурации

4. В окне «Настройка правил поддержки» оставьте объекты поставщика в режиме «Объект поставщика не редактируется»

5. В окне настройки, для корневого объекта, необходимо установить новое правило поддержки

6. В открывшемся окне, установите переключатель как показано на рисунке

7. Сохраните и обновите конфигурацию базы данных

1. Выполните вставку внешней обработки «Панель оператора» в качестве обработки

2. Далее, укажите путь к файлу внешней обработки. После завершения процесса копирования, Панель оператора будет добавлена в дерево конфигурации.

1. Создайте новый общий модуль в ветке «Общие модули»

2. Установите свойства общего модуля, как показано на рисунке ниже

3. Скопируйте содержимое общего модуля из файла «ОбщийМодуль.ТелефонияКлиент.txt», который входит в комплект поставки.

Необходимо добавить экспортируемую переменную «ПанельОператора»

//<simplit>
Перем ПанельТелефонииОператора Экспорт;
//</simplit>

Чтобы в случае потери соединения, Панель оператора автоматически восстанавливала связь с Asterisk, необходимо добавить процедуру «АвтоподключениеПанелиОператора». Текст процедуры входит в комплект поставки.

//<simplit>
// автоподключение при разрыве соединения
Процедура АвтоподключениеПанелиОператора() Экспорт;
	Если ПанельОператора.Телефония.Подключено=1 Тогда
		ОтключитьОбработчикОжидания("АвтоподключениеПанелиОператора");
	КонецЕсли; 
	Если ПанельОператора.ПереподключитьТелефонию() Тогда
		ОтключитьОбработчикОжидания("АвтоподключениеПанелиОператора ");
		Если ПанельОператора.ТихийРежимАвтоподключения=Ложь Тогда
			Сообщить(Формат(ТекущаяДата(),"ДЛФ ДВ")+": Соединение с сервером телефонии восстановлено");
		КонецЕсли; 
		ЗаписьЖурналаРегистрации("Соединение с сервером телефонии восстановлено",УровеньЖурналаРегистрации.Информация,,,"Обработка.ПанельОператора");
		ПанельОператора.ВыполнитьЗапросы();
	КонецЕсли; 
КонецПроцедуры
//</simplit>

В конце процедуры вставить вызов процедуры «ПриНачалеРаботыСистемы» общего модуля «ТелефонияКлиент»

//<simplit>
ТелефонияКлиент.ПриНачалеРаботыСистемы();
//</simplit>

В конец процедуры необходимо вставить вызов процедуры общего модуля «ТелефонияКлиент»:

//<simplit>
ТелефонияКлиент.ПередЗавершениемРаботыСистемы(Отказ);
//</simplit>

В конец процедуры необходимо вставить вызов процедуры общего модуля «ТелефонияКлиент»:

//<simplit>
ТелефонияКлиент.ОбработкаВнешнегоСобытия(Источник,Событие,Данные);
//</simplit>

Рассмотрим на примере формы документа «Событие» механизм добавления кнопок телефонии в командную панель

1. Чтобы при открытии формы документа в командную панель автоматически добавлялись кнопки телефонии, в конец процедуры «ПриОткрытии», необходимо вставить вызов процедуры общего модуля.

	…
	//<simplit>
	ТелефонияКлиент.ДобавитьКнопкиТелефонии(ЭлементыФормы.ДействияФормы,ЭтаФорма);
	//</simplit>
КонецПроцедуры  // ПриОткрытии()

2. Также, в модуль формы документа «Событие» необходимо добавить обработчик нажатия кнопок телефонии:

//<simplit>
Процедура ОбработкаДействийТелефонии(Кнопка)
	ТелефонияКлиент.ОбработкаДействийТелефонии(Кнопка,ЭтаФорма);
КонецПроцедуры
//</simplit>

В результате, на командную панель формы документа были добавлены кнопки для работы с телефонией: «Звонить» и «Прослушать запись разговора»

Добавление кнопок в форму элемента справочника «Контрагенты» выполняется по тому же принципу, что и в документ «Событие», который рассматривался выше. Отличие лишь в том, что в форме элемента «Контрагенты» существует 2 командные панели, в которые имеет смысл добавить кнопки телефонии: КоманднаяПанельКонтактнаяИнформация, КоманднаяПанельСобытия.

1. В конец процедуры «ПриОткрытии» необходимо вставить вызов процедуры общего модуля.

	…
	//<simplit>
	ТелефонияКлиент.ДобавитьКнопкиТелефонии(ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация,ЭтаФорма);
	ТелефонияКлиент.ДобавитьКнопкиТелефонии(ЭлементыФормы.КоманднаяПанельСобытия,ЭтаФорма);
	//</simplit>
КонецПроцедуры  // ПриОткрытии()

2. Также, в модуль формы необходимо добавить обработчик нажатия кнопок телефонии:

//<simplit>
Процедура ОбработкаДействийТелефонии(Кнопка)
	ТелефонияКлиент.ОбработкаДействийТелефонии(Кнопка,ЭтаФорма);
КонецПроцедуры
//</simplit>

В результате, на командную панель «События» были добавлены две кнопки: «Звонить» и «Прослушать запись разговора».

На командную панель «КонтактнаяИнформация» была добавлена только одна кнопка: «Звонить», т.к. для нее кнопка «Прослушать запись» не имеет смысла.

Добавление кнопок в форму элемента справочника «Контактные лица контрагентов» выполняется по тому же сценарию, что и в справочник «Контрагенты», который рассматривался выше.

1. В конец процедуры «ПриОткрытии» необходимо вставить вызов процедуры общего модуля.

	…
	//<simplit>
	ТелефонияКлиент.ДобавитьКнопкиТелефонии(ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация,ЭтаФорма);
	ТелефонияКлиент.ДобавитьКнопкиТелефонии(ЭлементыФормы.КоманднаяПанельКонтактнаяИнформацияЛичная,ЭтаФорма);
	ТелефонияКлиент.ДобавитьКнопкиТелефонии(ЭлементыФормы.КоманднаяПанельСобытия,ЭтаФорма);
	//</simplit>
КонецПроцедуры  // ПриОткрытии()

2. Также, в модуль формы необходимо добавить обработчик нажатия кнопок телефонии:

//<simplit>
Процедура ОбработкаДействийТелефонии(Кнопка)
	ТелефонияКлиент.ОбработкаДействийТелефонии(Кнопка,ЭтаФорма);
КонецПроцедуры
//</simplit>

В результате, на командную панель «События» были добавлены две кнопки: «Звонить» и «Прослушать запись разговора».

На командную панель «КонтактнаяИнформация» была добавлена только одна кнопка: «Звонить», т.к. для нее кнопка «Прослушать запись» не имеет смысла.

Изменения не являются обязательными, они предназначены для более точного учета взаимоотношений с контрагентами. Например, если за контактным лицом закреплено несколько номеров телефонов, то в документе будет сохранен номер телефона, с/на который совершался звонок.

1. Для хранения номера телефона, рекомендуется добавить реквизит «CallerID», тип «Строка», длина 13.
2. Для хранения идентификатора звонка Asterisk, рекомендуется добавить реквизит «UniqueID», тип «Строка», длина 32.

Если реквизиты существуют, то Панель оператора автоматически наполнит их данными.

Панель оператора предоставляет возможность хранить ссылки на полное имя файла записи звонка. Хранение может быть организовано 2-мя способами:

1. ссылка сохраняется в реквизит документа «Событие»
2. ссылка сохраняется средствами подсистемы СвойстваОбъектов

Способ хранения ссылки на файл записи звонка задается в форме «Настройки пользователя»

Наиболее простой способ - хранение в реквизите документа. Для этого, можно создать новый реквизит документа или же использовать существующий. На рисунке ниже, создан новый реквизит «ФайлЗаписи» (строка 255)

На рисунке ниже, в настройках пользователя указан способ хранения «Реквизит документа» и указан идентификатор реквизита «ФайлЗаписи»

Этот способ хранения не требует изменений в конфигурации. Настройка выполняется максимально просто - необходимо установить способ хранения «Свойство документа» и указать имя свойства, которое будет использовано. Если свойство отсутствует, то оно будет создано автоматически.

Получить информацию о файле записи звонка можно открытием панели свойств документа «Событие».