Встраивание панели телефонии оператора v.2

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

  • 1С:Управление торговым предприятием для Украины 1.2
  • 1С:Управление производственным предприятием для Украины 1.3

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

Включение возможности изменения конфигурации

Перед изменением конфигурации сделайте полную резервную копию

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

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

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

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

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

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

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

Добавление Панели телефонии оператора в конфигурацию

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

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

Добавление общих модулей

Общие модули для интеграции предоставляются бесплатно после покупки Панели телефонии.
Для демо-версии режим встраивания не поддерживается

Модули «ТелефонияКлиент» и «ТелефонияСервер» имеют лишь чисто логическое разделение на серверную и клиентскую часть.

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

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

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

Повторите тоже самое для модуля «ТелефонияКлиент»

Изменение модуля обычного приложения

Раздел переменных

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

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

ПриНачалеРаботыСистемы

В конец процедуры вставить код из файла «МодульОбычногоПриложения.txt»

//<simplit>
Попытка
	Если ПанельТелефонииОператора=Неопределено Тогда
		Если ТелефонияКлиент.УстановитьФормуПанелиТелефонии() Тогда
			ПанельТелефонииОператора.Открыть();
		КонецЕсли; 
	КонецЕсли;
Исключение
	Сообщить("Ошибка подключения панели телефонии Simplit: " + ОписаниеОшибки());
КонецПопытки;
//</simplit>

ОбработкаВнешнегоСобытия

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

//<simplit> вставка в начало процедуры
Если Источник="ROM-Asterisk-Native" Тогда
	Возврат;
КонецЕсли; 
//</simplit>

Единый механизм добавления кнопок телефонии в формы

Общие модули поддерживают единый механизм подключения кнопок Телефонии к любой форме.

Для этого, необходимо выполнить следующие действия:

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

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

2. В конец модуля формы добавить процедуру:

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

Результат встраивания v2.Панель телефонии в конфигурацию УТП 1.2

Интеграция кнопок Телефонии с отчетами

Интеграция с отчетами выполняется через стандартный механизм конфигурации «Расшифровка»

Для этого, необходимо внести изменение только в один отчет «УниверсальныйОтчет.ФормаВыбораПоля»

Процедура ПриОткрытии()
 
	//<simplit> - вставка в начало процедуры
	ТелефонияКлиент.ДобавитьРасшифровкуКонтакты(ТабличноеПолеДоступныеПоля,Расшифровка);
	//</simplit>
 
	// остальные строки процедуры
	// ...
 
КонецПроцедуры
Процедура ТабличноеПолеДоступныеПоляВыбор(Элемент, ВыбраннаяСтрока, Колонка, СтандартнаяОбработка)
 
	//<simplit> - вставка в начало процедуры
	Если ТелефонияКлиент.ЭтоДействиеТелефонии(ЭлементыФормы.ТабличноеПолеДоступныеПоля.ВыделенныеСтроки) Тогда
		Закрыть();
		Возврат;
	КонецЕсли; 
	//</simplit>
 
	// остальные строки процедуры
	// ...
 
КонецПроцедуры
Процедура КнопкаОК(Кнопка)
 
	//<simplit> - вставка в начало процедуры
	Если ТелефонияКлиент.ЭтоДействиеТелефонии(ЭлементыФормы.ТабличноеПолеДоступныеПоля.ВыделенныеСтроки) Тогда
		Закрыть();
		Возврат;
	КонецЕсли; 
	//</simplit>
 
	// остальные строки процедуры
	// ...
 
КонецПроцедуры

Минимальный уровень интеграции

Ниже минимальный набор объектов, для которых мы рекомендуем выполнить интеграцию

  • Справочник.Контрагенты.Форма.ФормаЭлемента
  • Справочник.КонтактныеЛицаКонтрагентов.Форма.ФормаЭлемента
  • Справочник.КонтактныеЛица.Форма.ФормаЭлемента
  • Справочник.ЛичныеКонтакты.Форма.ФормаЭлемента
  • Справочник.Пользователи.Форма.ФормаЭлемента
  • Справочник.ФизическиеЛица.Форма.ФормаЭлемента
  • Документ.Событие.Форма.ФормаДокумента
  • Документ.Событие.Форма.ФормаСписка

Результат встраивания v2.Панель телефонии в конфигурацию УТП 1.2

Максимальный уровень интеграция

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

Например, это могут быть объекты:

Подсистема «Продажи»

  • Документ.ЗаказПокупателя.Форма.ФормаДокумента
  • Документ.ЗаказПокупателя.Форма.ФормаСписка
  • Документ.СчетНаОплатуПокупателю.Форма.ФормаДокумента
  • Документ.СчетНаОплатуПокупателю.Форма.ФормаСписка
  • Документ.РеализицияТоваровУслуг.Форма.ФормаДокумента
  • Документ.РеализицияТоваровУслуг.Форма.ФормаСписка

Подсистема «Закупки»

  • Документ.ЗаказПоставщику.Форма.ФормаДокумента
  • Документ.ЗаказПоставщику.Форма.ФормаСписка
  • Документ.СчетНаОплатуПоставщика.Форма.ФормаДокумента
  • Документ.СчетНаОплатуПоставщика.Форма.ФормаСписка
  • Документ.ПоступлениеТоваровУслуг.Форма.ФормаДокумента
  • Документ.ПоступлениеТоваровУслуг.Форма.ФормаСписка

Подсистема «Банк»

  • Документ.ПлатежноеПоручениеВходящее.Форма.ФормаДокумента
  • Документ.ПлатежноеПоручениеВходящее.Форма.ФормаСписка
  • Документ.ПлатежноеПоручениеИсходящее.Форма.ФормаДокумента
  • Документ.ПлатежноеПоручениеИсходящее.Форма.ФормаСписка

Журналы документов

  • ЖурналДокументов.ДокументыКонтрагентов.Форма.ФормаСписка
  • ЖурналДокументов.ЗаказыПокупателей.Форма.ФормаСписка
  • ЖурналДокументов.ЗаказыПоставщикам.Форма.ФормаСписка
  • ЖурналДокументов.КассовыеДокументы.Форма.ФормаСписка
  • ЖурналДокументов.РасчетныеДокументыБанк.Форма.ФормаСписка
  • ЖурналДокументов.СкладскиеДокументы.Форма.ФормаСписка

Результат встраивания v2.Панель телефонии в конфигурацию УТП 1.2