~~NOTOC~~
====== Встраивание подсистемы телефонии ======
Данное руководство поможет Вам самостоятельно встроить подсистему телефонии в вашу конфигурацию 1С. Следуйте инструкциям шаг-за-шагом в том порядке, в котором они представлены.
Руководство подходит для «1С:Управление торговлей, ред.11», «1С:Управление нашей фирмой», «1С:CRM, ред.2» и других современных конфигураций построенных на библиотеке стандартных подсистем.
Данное руководство предполагает наличие у читателя навыков работы с конфигуратором 1С.
===== Задачи =====
* [[nightbird:integration-1c-managed#shag_1_vkljuchite_vozmozhnost_izmenenija_konfiguracii|Шаг 1. Включите возможность изменения конфигурации]]
* [[nightbird:integration-1c-managed#shag_2_vstrojte_podsistemu_telefonii|Шаг 2. Встройте подсистему телефонии]]
* [[nightbird:integration-1c-managed#shag_3_dopolnite_kod_programmnyx_modulej|Шаг 3. Дополните код программных модулей]]
* [[nightbird:integration-1c-managed#shag_4_nastrojte_knopku_pozvonit|Шаг 4. Настройте кнопку "Позвонить"]]
===== Шаг 1. Включите возможность изменения конфигурации =====
Встраивание подсистемы требует разблокировки головного объекта. Не забудьте сделать резервную копию информационной базы перед началом работы.
=== Для разблокировки головного объект: ===
- Откройте конфигуратор вашей информационной базы.
- Откройте окно настройки поддержки, //Конфигурация -> Поддержка -> Настройка поддержки//.
- **Включите возможность изменения** конфигурации. На предупреждение программы ответьте утвердительно.
- В появившемся окне укажите, что объекты поставщика не редактируются. {{ :nightbird:01-08-2018_8-52-41.png?nolink |}}
- Для головного объекта конфигурации установите правило поддержки на "Объект поставщика редактируется с сохранением поддержки".
===== Шаг 2. Встройте подсистему телефонии =====
Теперь конфигурация готова для внесения изменений. Будьте особенно внимательны на данном шаге, чтобы не повредить объекты Вашей конфигурации.
=== Для встраивания подсистемы: ===
- Чтобы получить файл конфигурации подсистемы телефонии:\\ а. Откройте личный кабинет МИКО https://telefon.miko.ru/personal/update-files/.\\ б. Скачайте дистрибутив подсистемы телефонии.\\ в. Распакуйте архив.\\
- Откройте окно сравнения и объединения конфигураций:\\ а. Выполните команду //Конфигурация -> Сравнить, объединить с конфигурацией из файла//.\\ б. Выберите файл подсистемы телефонии.
- Снимите флажок с головного объекта. {{ :nightbird:01-08-2018_10-57-50.png?nolink |}}
- Отметьте объекты встраиваемой подсистемы :\\ а. Откройте окно отбора по подсистемам, //Действия -> Отметить по подсистемам файла//. {{ :nightbird:01-08-2018_11-00-45.png?nolink |}}\\ б. Снимите флажок с элемента "ПодсистемаТелефонии".\\ в. Установите флажок на элементе "микоТелефония".\\ г. Снимите флажок "Включать объекты подчиненных подсистем". {{ :nightbird:01-08-2018_11-08-55.png?nolink |}}\\ д. Нажмите **Установить**.
- Снимите флажок с подсистемы "ИнтеграцияCRM". {{ :nightbird:01-08-2018_11-22-36.png?nolink |}}
- Нажмите **Выполнить**.
- В окне неразрешимых ссылок нажмите **Продолжить**. {{ :nightbird:01-08-2018_11-27-48.png?nolink |}}
- Сохраните изменения, //Конфигурация -> Сохранить конфигурацию//.
Вы можете пропустить настройку карточки клиента, если планируете использовать другую форму обработки звонка.
=== Для настройки карточки клиента: ===
- Откройте основную форму обработки **микоКарточкаКлиента**.
- **В списке реквизитов** формы выберите основной реквизит **Объект**.
- Установит **тип** реквизита в значение, которое будет соответствовать **объекту справочника клиентов** Вашей конфигурации. В типовых конфигурациях этот справочник может называться Клиенты, Партнеры или Контрагенты. {{ :nightbird:06-08-2018_15-16-50.png?nolink |}}
===== Шаг 3. Дополните код программных модулей =====
Чтобы подсистема телефонии могла запускаться и полноценно функционировать нужно внести изменения в программные модули Вашей конфигурации. На этом шаге будут внесены изменения в модули приложений, подсистему отчетов и некоторые другие.
=== Для настройки запуска подсистемы: ===
- Откройте **модуль управляемого приложения**.
- Перейдите к разделу объявления переменных и добавьте код:
// PT1C / Панель телефонии / Начало
Перем микоКоннекторAPI Экспорт;
Перем микоПерсональныеНастройки Экспорт;
// PT1C / Панель телефонии / Конец
- Перейдите к процедуре **ОбработкаВнешнегоСобытия** и добавьте **в конец** тела процедуры код:
Процедура ОбработкаВнешнегоСобытия(Источник, Событие, Данные)
// ...
// PT1C / Панель телефонии / Начало
микоТелефонияСлужебный.ОбработатьВнешнееСобытие(Источник, Событие, Данные);
// PT1C / Панель телефонии / Конец
КонецПроцедуры
- Перейдите к процедуре **ПриЗавершенииРаботыСистемы** и добавьте **в конец** тела процедуры код:
Процедура ПриЗавершенииРаботыСистемы()
// ...
// PT1C / Панель телефонии / Начало
микоКоннекторAPI = Неопределено;
микоПерсональныеНастройки = Неопределено;
// PT1C / Панель телефонии / Конец
КонецПроцедуры
- Откройте модуль **ОбщегоНазначенияКлиентПереопределяемый**.
- Перейдите к процедуре **ПередНачаломРаботыСистемы** и добавьте **в конец** тела процедуры код:
Процедура ПередНачаломРаботыСистемы(Параметры) Экспорт
// ...
// PT1C / Панель телефонии / Начало
Если микоТелефонияКлиент.ЗапускВозможен() Тогда
Оповещение = Новый ОписаниеОповещения("ПослеИнициализацииКомпонента", микоТелефонияСлужебный);
микоТелефонияКлиент.ИнициализироватьКомпонент(Оповещение);
КонецЕсли;
// PT1C / Панель телефонии / Конец
КонецПроцедуры
Вы можете пропустить настройку панели отчетов, если не планируете использовать [[https://telefon.miko.ru/products/journal-zvonkov/|журнал звонков]].
=== Для настройки панели отчетов: ===
- Откройте общий модуль **ВариантыОтчетовПереопределяемый**.
- Перейдите к процедуре **ОпределитьРазделыСВариантамиОтчетов** и добавьте **в конец** тела процедуры код:
Процедура ОпределитьРазделыСВариантамиОтчетов(Разделы) Экспорт
// ...
// PT1C / Панель телефонии / Начало
микоТелефония.ОпределитьРазделыСВариантамиОтчетов(Разделы);
// PT1C / Панель телефонии / Конец
КонецПроцедуры
Сохраните изменения, //Конфигурация -> Сохранить конфигурацию//.
===== Шаг 4. Настройте кнопку "Позвонить" =====
Подсистема телефонии позволяет звонить по нажатию кнопки в 1С. Некоторые конфигурации 1С уже содержат такие кнопки, нужно только перехватить их обработчик. Для других подойдет универсальная команда **Позвонить**, которую можно встроить в справочники и документы.
==== Универсальная команда "Позвонить" ====
Команда **Позвонить** отображается в командной панели формы и позволяет совершать исходящие вызовы из справочников и документов. Команда может быть встроена только в справочники, которые содержат табличную часть "Контактная информация". А также в документы, у которых среди реквизитов есть ссылки на подобные справочники.
{{ :nightbird:07-08-2018_13-44-24.png?nolink |}}
=== Для настройки универсальной команды "Позвонить": ===
- Откройте свойства общей команды **микоПозвонить**.
- В свойстве **Тип параметра команды** укажите те справочники и документы, в которых нужна кнопка "Позвонить". {{ :nightbird:07-08-2018_13-32-23.png?nolink |}}
==== Настройка команды "Позвонить" в "1С:Управление торговлей" ====
В конфигурации "1С:Управление торговлей, ред.11" в справочниках партнеров и контактных лиц уже присутствует кнопка для совершения исходящего звонка. Это кнопка может быть использована для звонков с помощью панели телефонии.
{{ :nightbird:07-08-2018_13-58-00.png?nolink |}}
=== Для настройки кнопки "Позвонить" ===
- Откройте общий модуль **УправлениеКонтактнойИнформациейКлиент**.
- Перейдите к процедуре **ПозвонитьПоТелефону** и добавьте **в начало** тела процедуры код:
Процедура ПозвонитьПоТелефону(НомерТелефона)
// PT1C / Панель телефонии / Начало
Если Не микоПерсональныеНастройки = Неопределено Тогда
микоТелефонияКлиент.Позвонить(НомерТелефона, микоПерсональныеНастройки.ВнутреннийНомер);
Возврат;
КонецЕсли;
// PT1C / Панель телефонии / Конец
// ...
КонецПроцедуры
=== Завершите встраивание подсистемы применив изменения: ===
- Сохраните изменения, //Конфигурация -> Сохранить конфигурацию//.
- Обновите конфигурацию базы данных, //Конфигурация -> Обновить конфигурацию базы данных//.
== Полезные ссылки: ==
* [[nightbird:prepare-1c|Настройка подсистемы телефонии для работы в 1С]]
* [[nightbird:integration-1c-crm3|Встраивание подсистемы телефонии в 1С:CRM 3.0]]