~~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]]