====== Интеграция панели телефонии и журнала звонков в УНФ ред. 1.6 ======

[[astpanel:fastintegration|Обратно к перечню инструкций]]

Данная инструкция позволяет упростить и ускорить процесс внедрения панели телефонии и журнала звонков в концигурацию 1С на управляемом приложении. 

{{youtube>RUaeOJYJpEc?medium}}

<note tip>
Инструкции составлены для **конфигураций**:
  * Управление нашей фирмой, редакция **1.6** 

Рекомендуемая версия **панели телефонии**: **1.4.26.20+**\\ 
Рекомендуемая версия **журнала звонков**: **1.0.1.15+** 
</note>

===== Этап 1. Настройка правил поддержки =====

<note warning>Перед началом выполнения работ обязательно сделайте **резервное копирование** конфигурации и данных! </note>

Для начала следует разблокировать головной объект конфигурации для внесения изменений.

Порядок действий следующий:
  - Убедитесь, что пользователи завершили работу с программой.
  - Запустите программу в режиме //"Конфигуратор"//.
  - Откройте окно настройки поддержки. {{ :doc:panel1ccrm20:support.png? |}}
  - Включите возможность изменения конфигурации. На предупреждение программы ответьте утвердительно. {{ :astpanel:fastintegration:1.png |}}
  - В появившемся окне укажите, что объекты поставщика не редактируются. {{ :doc:panel1ccrm20:rules.png? |}}
  - Затем для головного объекта конфигурации (//"УправлениеНебольшойФирмой"//) установите правило поддержки на //"Объект поставщика редактируется с сохранением поддержки"//. {{ :astpanel:fastintegration:2.png |}}
  - Для общего модуля //"**ВариантыОтчетовПереопределяемый**"// также установите правило поддержки на //"Объект поставщика редактируется с сохранением поддержки"//. {{ :astpanel:fastintegration:3.png |}}
  - Закройте окно настройки поддержки

Теперь конфигурация готова к внесению изменений.

===== Этап 2. Встраивание журнала звонков =====

  - Выполните действия **"Конфигурация" - "Сравнить и объеденить с конфигурацией из файла"** {{ :astpanel:fastintegration:4.png |}}
  - Выберите файл конфигурации "**Module_Statistic_Х_Х_Х_ХХ.protect.cf**";
  - Снимите флажок со всех объектов конфигурации {{ :astpanel:fastintegration:5.png |}}
  - Меню "**Действия**" - "**Отметить по подсистемам файла**" {{ :astpanel:fastintegration:6.png |}}
  - Выберите **только** те подсистемы, которые указаны на скриншоте. Выполните действие "**Установить**" {{ :astpanel:fastintegration:7.png |}} 
  - Выполните действие "**Выполнить**" {{ :astpanel:fastintegration:8.png |}}
  - В появившемся окне нажимаем "**Продолжить**". Сохраняем отчет сравнения/объединения нашей конфигурации с файлом. {{ :astpanel:fastintegration:9.png |}}
  - Сравнение и объединение будет завершено. {{ :astpanel:fastintegration:10.png |}}

==== Изменение типовых объектов ====

Для завершения этапа встраивания журнала звонков необходимо внести изменения в **общий модуль "ВариантыОтчетовПереопределяемый"**. 

  - Открываем общий модуль "**ВариантыОтчетовПереопределяемый**" для редактирования 
  - Переходим в процедуру "**ОпределитьРазделыСВариантамиОтчетов**"
  - В конец процедуры добавляем строку кода: <code>// МИКО / PT1C / Подсистема "Расширенный журнал звонков" / Начало
	Разделы.Добавить(Метаданные.Подсистемы.МИКО_Телефония);
	// МИКО / PT1C / Подсистема "Расширенный журнал звонков" / Конец</code>

<note warning>**ВНИМАНИЕ**! Для конфигурации **Управление нашей фирмой, редакция 1.6 (1.6.14.81)+** необходимо модернизировать модуль команды **МИКО_стПанельОтчетовИсторияЗвонков**. Порядок действий описан ниже. </note>

  - Для конфигурации **Управление нашей фирмой, редакция 1.6 (1.6.14.81)+** перейдите в модуль команды **МИКО_стПанельОтчетовИсторияЗвонков** 
  - Перейдите в **процедуру** **ОбработкаКоманды**
  - Внесите соответствующие изменения: <code>&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
	
	Если ЕстьМодульБСП() Тогда
		Попытка
			ОбщийМодуль_ВариантыОтчетовКлиент = Вычислить("ВариантыОтчетовКлиент");
			Если ОбщийМодуль_ВариантыОтчетовКлиент <> Неопределено Тогда
                                // МИКО / PT1C / Оставляем два параметра процедуры
				ОбщийМодуль_ВариантыОтчетовКлиент.ПоказатьПанельОтчетов("МИКО_Телефония", ПараметрыВыполненияКоманды); 
			КонецЕсли;
		Исключение
			ЗаписатьОшибкуВЖурналРегистрации(""+ОписаниеОшибки());
		КонецПопытки; 
	Иначе	
		ОткрытьФорму("Отчет.МИКО_стПанельОтчетов.Форма.ФормаОтчета");
	КонецЕсли; 
	
КонецПроцедуры
</code>


===== Этап 3. Встраивание панели телефонии =====

==== 1. Добавление обработки в подсистему МИКО_Телефония ====

Замените обработку МИКО_ПанельТелефонииДля1С на внешнюю, которая идет в поставке, она должна называться **МИКО_ПанельТелефонииДля1С**.{{ :astpanel:fastintegration:1231.png |}}

==== 2. Правка модуля управляемого приложения ====
  - Откройте модуль управляемого приложения. {{ :astpanel:fastintegration:12.png |}}
  - Определите глобальную переменную в начале модуля до раздела процедур. <code 1c>// PT1C / Панель телефонии Asterisk / Начало
Перем сфпФормаТелефон Экспорт;
// PT1C / Панель телефонии Asterisk / Конец </code>
  - Перейдите к процедуре //"ПриНачалеРаботыСистемы"//. В конец процедуры вставьте код приведенный ниже.<code 1c>
        // PT1C / Панель телефонии Asterisk / Начало
	Попытка
		Отказ = Ложь;
		// получим форму - основной "модуль" панели телефонии
		сфпФормаТелефон = ПолучитьФорму("Обработка.МИКО_ПанельТелефонииДля1С.Форма.Форма");
	Исключение
		сфпФормаТелефон = Неопределено; //Нет прав на обработку
	КонецПопытки;
		
	Если НЕ сфпФормаТелефон = Неопределено Тогда
		сфпФормаТелефон.ИнициализироватьПанельТелефонии(Истина, Отказ);
	КонецЕсли; 
	// проверим успешность инициализации
	Если Отказ Тогда
		Сообщить("Не удалось запустить ""МИКО Панель телефонии Asterisk""");
	КонецЕсли;
        // PT1C / Панель телефонии Asterisk / Конец

</code>
  - Перейдите к процедуре //"ПриЗавершенииРаботыСистемы"// (создайте процедуру, если ее нет). В конец процедуры вставьте код приведенный ниже.<code 1c>
	// PT1C / Панель телефонии Asterisk / Начало
	Если сфпФормаТелефон <> Неопределено Тогда
		сфпФормаТелефон.ЗавершитьРаботу(Истина);
	КонецЕсли;
	// PT1C / Панель телефонии Asterisk / Конец
</code>

===== Этап 4. Завершение этапа встраивания =====

==== Сохранение изменений ====
  - Обновите конфигурацию базы данных.{{ :astpanel:fastintegration:13.png |}}
  - В отобразившемся окне нажмите **Принять** {{ :astpanel:fastintegration:14.png |}}

==== Обновление конфигурации ====
  - Запустите процесс обновления конфигурации. В конфигураторе перейдите в меню "**Сервис**" - "**Параметры**", вкладка "**Запуск 1С:Предприятие**"
  - В поле "**Параметры запуска**" укажите строку "**ЗапуститьОбновлениеИнформационнойБазы**" {{ :astpanel:statistic:startupdate.png?450 |}}
  - Запустите 1С:Предприятие из конфигуратора "**Отладка**" - "**Начать отладку**"
  - Дождитесь завершения обновления
  - Удалите из параметров запуска строку "**ЗапуститьОбновлениеИнформационнойБазы**". Перезапустите 1С. 

==== Завершение настройки ====
<note important>Операции требовательны к ресурсам ПК. Лучше их выполнить в нерабочее время.</note>

  - Запустите **1С Предприятие под полными правами** в пользовательском режиме
  - **"Все функции" - "Обработки" - "МИКО: Заполнить индекс телефонов"**
  - Выполните действие "**Заполнить коды городов**"
  - Выполните действие "**Перезаполнить индекс номеров**"

На этом встраивание панели телефонии и журнала звонков в конфигурацию завершено. Теперь можно перейти к настройке продуктов в режиме 1С:Предприятие:
  *[[astpanel:enterprise:managed#pervyj_zapusk| Настройка панели телефонии]]
  *[[astpanel:statistic:settings| Настройка журнала звонков]] 

[[astpanel:fastintegration|Обратно к перечню инструкций]]