====== Интеграция в 1С:Управление торговлей ред 10.3 ====== {{youtube>II__v3blYM4?medium}} ===== Подготовка ===== Инструкция проверена с релизом "Управление торговлей 10.3.50.1" и панелью телефонии версии 1.2.24.20 Обязательно перед началом работ **выполняйте резервное копирование** информационной базы! Для начала необходимо открыть информационную базу в режиме запуска «**Конфигуратор**». Для объектов следует установить правило поддержки «**Редактируется с сохранением поддержки**». {{page>astpanel:designer:ut11:poddergka}} ===== Встраивание ===== **Задача:** Необходимо открывать форму панели телефонии автоматически при старте 1С. === Добавление обработки в конфигурацию=== Добавим в дерево объектов конфигурации внешнюю обработку **"МИКО_ПанельТелефонииДля1С"**. Она находится корневой папке скаченного комплекта. === Настройка ролей === Добавим в дерево метаданных новую роль: - Имя **"МИКО_ИспользованиеСофтфона"**. - Синоним **"Использование панели телефонии Asterisk (МИКО)"**. Для этой роли с корневого элемента дерева объектов конфигурации снимите все права. \\ {{ :astpanel:designer:podsist_telef_1.png?nolink |}} \\ Установить права на **использование** и **просмотр** обработки "МИКО_ПанельТелефонииДля1С". {{ :astpanel:designer:d.png?nolink | }} При настройке прав пользователей необходимо добавить эту роль тем, кто будет работать непосредственно с телефонией. === Изменение типовых объектов=== * Модифицировать модуль обычного приложения Определите глобальную переменную в начале модуля до раздела процедур. // {{doc:panel1cut:{ Панель телефонии Asterisk, МИКО }}} НАЧАЛО Перем Miko_Ajam Экспорт;// МИКО обработка управления звонками // {{doc:panel1cut:{ Панель телефонии Asterisk, МИКО }}} КОНЕЦ * Перейдите к процедуре «ПриНачалеРаботыСистемы». В конец процедуры вставьте код приведенный ниже. Процедура ПриНачалеРаботыСистемы() // ... ... ... Внимание!!! Пропущена часть кода!!! ... ... ... // {{doc:panel1cut:{ Панель телефонии Asterisk, МИКО }}} НАЧАЛО // установка глобадьных переменных Если РольДоступна("ПолныеПрава") ИЛИ РольДоступна("МИКО_ИспользованиеСофтфона") Тогда Попытка Miko_Ajam = Обработки.МИКО_ПанельТелефонииДля1С.Создать(); Miko_Ajam.ПодключитьСофтФон(); Исключение Сообщить("Ошибка подключения СофтФона (МИКО):", СтатусСообщения.ОченьВажное); Сообщить(ОписаниеОшибки()); КонецПопытки; КонецЕсли; // {{doc:panel1cut:{ Панель телефонии Asterisk, МИКО }}} КОНЕЦ КонецПроцедуры // ПриНачалеРаботыСистемы() * Перейдите к процедуре «ОбработкаВнешнегоСобытия». В конец процедуры вставьте код приведенный ниже. Процедура ОбработкаВнешнегоСобытия(Источник, Событие, Данные) // ... ... ... Внимание!!! Пропущена часть кода!!! ... ... ... // {{doc:panel1cut:{ Панель телефонии Asterisk, МИКО }}} НАЧАЛО Если (Источник = "MikoAjamEvent" ИЛИ Источник = "MIKO_SoftPhone" ИЛИ Источник = "hWindow") И НЕ Miko_Ajam = Неопределено Тогда Miko_Ajam.ОбработкаВнешнегоСобытияАстериск(Источник, Событие, Данные); КонецЕсли; // {{doc:panel1cut:{ Панель телефонии Asterisk, МИКО }}} КОНЕЦ КонецПроцедуры // ОбработкаВнешнегоСобытия() * Перейдите к процедуре «ПередЗавершениемРаботыСистемы». В конец процедуры вставьте код приведенный ниже. Процедура ПередЗавершениемРаботыСистемы(Отказ) // ... ... ... Внимание!!! Пропущена часть кода!!! ... ... ... // {{doc:panel1cut:{ МИКО }}} НАЧАЛО Панель телефонии Asterisk // Завершим работу Панель телефонии Asterisk перед выходом из предприятия Если НЕ Отказ И НЕ Miko_Ajam = Неопределено Тогда Miko_Ajam.ОтключитьВК(); КонецЕсли; // {{doc:panel1cut:{ МИКО }}} КОНЕЦ Панель телефонии Asterisk КонецПроцедуры * Обновите конфигурацию базы данных. {{ :doc:panel1ccrm20:confupd.png? |}} * Установите роль для пользователей Откройте меню **Администрирование - Пользователи** и укажите для пользователя роль "**Использование панели телефонии Asterisk (МИКО)**". Иначе первый запуск произвести невозможно. {{ :astpanel:designer:user_rol.png?nolink |}} На этом встраивание завершено. ==== Модернизация документа "Событие" ==== === Связь истории звонков и документа "Событие" === **Задача:** необходимо хранить связку документа события с записью в истории звонков. При открытии документа события из истории, должен открываться документ сформированный ранее по этой записи. **Решение:** для документа "Событие" необходимо добавить новый реквизит: * Имя = "**CRM_GUIDЗвонка**"; * Тип = "**Строка**", длина **38**, допустимая длина "**Переменная**"; === Прослушать запись разговора из документа "Событие" === **Задача:** необходимо добавить возможность прослушать запись разговора, связанного с документом "Событие", из формы документа. Кроме того необходимо добавить возможность набрать номер контрагента, либо его контактного лица из формы документа. **Решение:** необходимо модифицировать модуль формы документа: // Обработчик события ПриОткрытии формы. // Процедура ПриОткрытии() // ... ... ... мПоследнееЗначениеЭлементаПоискаПоСтрокеКонтрагент = Контрагент; мПоследнееЗначениеЭлементаПоискаПоСтрокеКонтактноеЛицо = КонтактноеЛицо; мТекущаяДатаДокумента = Дата; // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И НЕ Miko_Ajam.мОбщийМодуль = Неопределено Тогда мОбщийМодуль = Miko_Ajam.мОбщийМодуль; // добавляем кнопку вызова мОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.ДействияФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерВыбравИзСписка"); // добавляем кнопку прослушивания записи разговора мОбщийМодуль.ДобавитьКнопкуПрослушиванияЗаписиНаПанельДействий(ЭлементыФормы.ДействияФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_ПрослушатьЗапись"); КонецЕсли; ПодключитьОбработчикОжидания("МИКО_СформироватьСтрокуТипаВида", 1, Истина); // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} КОНЕЦ Модифицированность = Ложь; КонецПроцедуры // ПриОткрытии() добавить в форму обработчик нажатия кнопок: // МИКО // Набор номера по заданному алгоритму // Процедура МИКО_ВыполнитьДействие(Кнопка) Действие = Кнопка.Имя; Если Miko_Ajam = Неопределено Тогда Возврат; КонецЕсли; Если Действие = "кнМИКО_НабратьНомерВыбравИзСписка" Тогда // Позвонить по телефону выбранному пользователем из списка, определенных у контрагента и контактного лица СписокОбъектов = Новый Структура(); СписокОбъектов.Вставить("Контрагент", Контрагент); СписокОбъектов.Вставить("КонтактноеЛицо", КонтактноеЛицо); // Данные незарегистрированных контрагентов: СписокОбъектов.Вставить("Событие", Ссылка); Miko_Ajam.ПозвонитьВыбравТелефон(СписокОбъектов); ИначеЕсли Действие = "кнМИКО_ПрослушатьЗапись" Тогда Если НЕ ЗначениеЗаполнено(CRM_GUIDЗвонка) Тогда Сообщить("К событию не прикреплено записи разговора!"); Возврат; КонецЕсли; // Прослушать запись разговора, прикрепленного к событию Miko_Ajam.ПрослушатьЗаписьРазговора(CRM_GUIDЗвонка); КонецЕсли; КонецПроцедуры Процедура МИКО_СформироватьСтрокуТипаВида() Экспорт // актуально для УТ 10.3.34.2 СформироватьСтрокуТипаВида(); КонецПроцедуры // МИКО_СформироватьСтрокуТипаВида() Документ при открытии будет выглядеть следующим образом: {{ :doc:panel1cut:dokument_sobytie.jpg? |}} ==== Контактная информация ==== **Задача:** необходимо, для поиска номеров в базе использовать запрос не по временной таблице, а непосредственно по регистру сведений "КонтактнаяИнформация". **Решение:** необходимо модифицировать регистр сведений **"КонтактнаяИнформация"**: Добавить ресурсы: * "**CRM_ПолеХраненияНомера**" (число длина 32) * "**CRM_НомерТелефона**" (переменная строка 32) Обратите **внимание** на тип значения! \\ "**CRM_ПолеХраненияНомера**" (**число** длина 32) В модуле набора записей изменить процедуру: // Обработчик ПередЗаписью контактной информации, набора записей // Процедура ПередЗаписью(Отказ, Замещение) Если ОбменДанными.Загрузка Тогда Возврат; КонецЕсли; Для каждого Запись Из ЭтотОбъект Цикл Если НЕ ЗначениеЗаполнено(Запись.Объект) Тогда Отказ = Истина; СтрокаОтказа = "Не заполнен объект."; Продолжить; КонецЕсли; Если Запись.Объект.ЭтоГруппа Тогда Отказ = Истина; СтрокаОтказа = "Нельзя использовать в качестве объекта контактной информации - группу."; Прервать; КонецЕсли; // Панель телефонии для 1С // НАЧАЛО #Если Клиент Тогда Если НЕ Miko_Ajam = Неопределено И НЕ Miko_Ajam.мОбработкаДанных = Неопределено И Запись.Тип = Перечисления.ТипыКонтактнойИнформации.Телефон Тогда глКоличествоХранимыхЦифрТелефона = Miko_Ajam.ГлобальныеПеременные.глКоличествоХранимыхЦифрТелефона; мОбработкаДанных = Miko_Ajam.мОбработкаДанных; ПредставлениеНомера = мОбработкаДанных.УбратьИзНомераТелефонаВсеБуквы(Запись.Поле1 + Запись.Поле2 + Запись.Поле3); ПредставлениеБаза = мОбработкаДанных.УбратьИзНомераТелефонаВсеБуквы(Запись.Представление); Если ЗначениеЗаполнено(Запись.Поле4) И НЕ ЗначениеЗаполнено(ПредставлениеНомера) Тогда Запись.CRM_ПолеХраненияНомера = мОбработкаДанных.ПреобразоватьНомерДляСохранения(Запись.Поле4, глКоличествоХранимыхЦифрТелефона); Запись.CRM_НомерТелефона = мОбработкаДанных.УбратьИзНомераТелефонаВсеБуквы (Запись.Поле4); ИначеЕсли НЕ ЗначениеЗаполнено(ПредставлениеНомера + Запись.Поле4) И ЗначениеЗаполнено(ПредставлениеБаза) Тогда Запись.CRM_ПолеХраненияНомера = мОбработкаДанных.ПреобразоватьНомерДляСохранения(ПредставлениеБаза, глКоличествоХранимыхЦифрТелефона); Запись.CRM_НомерТелефона = ПредставлениеБаза; Иначе Запись.CRM_ПолеХраненияНомера = мОбработкаДанных.ПреобразоватьНомерДляСохранения(ПредставлениеНомера,глКоличествоХранимыхЦифрТелефона); Запись.CRM_НомерТелефона = ПредставлениеНомера; КонецЕсли; КонецЕсли; // Для возможности сохранения Скайп номера Если Найти(Запись.Вид,"Skype")>0 Тогда Запись.CRM_НомерТелефона = Запись.Представление; КонецЕсли; #КонецЕсли // Панель телефонии для 1С// КОНЕЦ КонецЦикла; Если Отказ Тогда Сообщить(СтрокаОтказа); КонецЕсли; КонецПроцедуры После этого, добавленные ранее ресурсы, будут заполняться надлежащим образом. ==== Данные незарегистрированных контрагентов ==== В некоторых случаях удобно не регистрировать нового клиента, а сохранить его просто в документе "Событие". \\ В этом случае данные будут сохранены в регистре сведений "**ДанныеНезарегистрированныхКонтрагентов**". В стандартном исполнении регистр не позволяет сохранить сведения по коду страны. Исправим это. - Добавим в регистр новый **ресурс**: "**МИКО_КодСтраны**" - Тип значения: "**строка**" - Полнотекстовый поиск: "**Не использовать**" - Длинна: **"10", переменная** {{ :astpanel:designer:miko_code_contry.png | Свойства ресурса регистра сведений ДанныеНезарегистрированныхКонтрагентов}} Функцию заполнения ресурса возьмет на себя панель телефонии (**поддерживается в версии 1.2.24.7+**). При регистрации неизвестного контрагента из документа Событие "пропадает" из номера телефона код страны, исправим этот момент. Откроем форму обработки "РедактированиеДанныхНезарегистрированныхКонтрагентов", в модуле формы найдем функцию "Зарегистрировать()" и дополним участок кода: // Контактная инфомация контрагента // Телефон контрагента Если ЗначениеЗаполнено(Запись.ВидТелефонаКонтрагента) И НЕ ПустаяСтрока(Запись.НомерТелефонаКонтрагента) Тогда НоваяЗапись = ФормаКонтрагента.НаборКонтактнойИнформации.Добавить(); НоваяЗапись.Вид = Запись.ВидТелефонаКонтрагента; НоваяЗапись.Тип = Перечисления.ТипыКонтактнойИнформации.Телефон; НоваяЗапись.Объект = НовыйКонтрагент.Ссылка; НоваяЗапись.Поле3 = Запись.НомерТелефонаКонтрагента; НоваяЗапись.Поле4 = Запись.ДобавочныйНомерТелефонаКонтрагента; НоваяЗапись.Поле2 = Запись.КодГородаТелефонаКонтрагента; // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} НАЧАЛО //Заполним код страны врСтруктураЗаполнения = Новый Структура("МИКО_КодСтраны", ""); ЗаполнитьЗначенияСвойств(врСтруктураЗаполнения, Запись); НоваяЗапись.Поле1 = врСтруктураЗаполнения.МИКО_КодСтраны; // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} КОНЕЦ УправлениеКонтактнойИнформацией.СформироватьПредставлениеТелефона(НоваяЗапись); КонецЕсли; ==== Модернизация справочника "Контрагенты" ==== === Звонок из карточки Контрагента === **Задача:** необходимо, добавить возможность произвести звонок из карточки контрагента. **Решение:** необходимо модифицировать форму элемента справочника "Контрагенты": // Обработчик события ПриОткрытии формы. // Процедура ПриОткрытии() // ... ... ... Внимание!!! Отсутствует часть исходного кода!!! // Установить печатную форму по умолчанию. РаботаСДиалогами.УстановитьКнопкуПечати(ЭтотОбъект, ЭтаФорма); // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И НЕ Miko_Ajam.мОбщийМодуль = Неопределено Тогда мОбщийМодуль = Miko_Ajam.мОбщийМодуль; // добавляем элементы управления на форму мОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.ДействияФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерВыбравИзСписка"); мОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерИзКИ"); мОбщийМодуль.ДобавитьКнопкуЗвонкаНаПанельДействий(ЭлементыФормы.КоманднаяПанельКонтактныеЛицаКонтрагента.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_НабратьНомерВыбравКЛ"); КонецЕсли; // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} КОНЕЦ КонецПроцедуры добавить обработчик нажатия кнопок: // МИКО // Набор номера по заданному алгоритму // Параметры // Кнопка - элемент управления формы с типом "КнопкаКоманднойПанели" Процедура МИКО_ВыполнитьДействие(Кнопка) Действие = Кнопка.Имя; Если Miko_Ajam = Неопределено Тогда Возврат; КонецЕсли; Если Действие = "кнМИКО_НабратьНомерИзКИ" Тогда // Позвонить по выбранному контакту ТекущаяСтрока = ЭлементыФормы.КонтактнаяИнформация.ТекущиеДанные; Если НЕ ТекущаяСтрока = Неопределено Тогда Miko_Ajam.НабратьНомерКИ(ЭлементыФормы.КонтактнаяИнформация.ТекущиеДанные); КонецЕсли; ИначеЕсли Действие = "кнМИКО_НабратьНомерВыбравИзСписка" ТОгда // Позвонить по телефону, выбранному пользователем из списка телефонов определенных у контрагента и контактного лица СписокОбъектов = Новый Структура(); СписокОбъектов.Вставить("Контрагент", Ссылка); СписокОбъектов.Вставить("КонтактноеЛицо", ОсновноеКонтактноеЛицо); Если НЕ Ссылка = ГоловнойКонтрагент Тогда СписокОбъектов.Вставить("КонтактноеЛицо", ГоловнойКонтрагент); КонецЕсли; Miko_Ajam.ПозвонитьВыбравТелефон(СписокОбъектов); ИначеЕсли Действие = "кнМИКО_НабратьНомерВыбравКЛ" Тогда // Позовонить выбранному контактному лицу ТекущиеДанные = ЭлементыФормы.КонтактныеЛицаКонтрагента.ТекущиеДанные; Если НЕ ТекущиеДанные = Неопределено Тогда СписокОбъектов = Новый Структура(); СписокОбъектов.Вставить("КонтактноеЛицо", ТекущиеДанные.Ссылка); Miko_Ajam.ПозвонитьВыбравТелефон(СписокОбъектов); КонецЕсли; ИначеЕсли Действие = "УстановитьДоступностьКнопокСофтфона" Тогда Miko_Ajam.мОбщийМодуль.УстановитьДоступностьКнопокСофтфона(ЭлементыФормы.КонтактнаяИнформация.ТекущиеДанные, ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация.Кнопки, "кнМИКО_НабратьНомерИзКИ"); КонецЕсли; КонецПроцедуры Кнопки должны быть доступны только для контактной информации с типом "Телефон" // Обработчик события ПриАктивизацииСтроки элемента формы КонтактнаяИнформация. // Процедура КонтактнаяИнформацияПриАктивизацииСтроки(Элемент) УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПриАктивизацииСтрокиТаблицы(Элемент, ЭлементыФормы.КоманднаяПанельКонтактнаяИнформация.Кнопки.УстановитьОсновным); // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И НЕ Miko_Ajam.мОбщийМодуль = Неопределено Тогда МИКО_ВыполнитьДействие(Новый Структура("Имя","УстановитьДоступностьКнопокСофтфона")); КонецЕсли; // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} КОНЕЦ КонецПроцедуры Форма элемента справочника примет следующий вид: {{ :doc:panel1cut:forma_kontragenta.png? |}} ==== Модернизация общей формы печати документов ==== === Отправка факсом текущего документа === **Задача:** необходимо, добавить возможность отправки сформированной печатной формы в виде факсимильного сообщения в текущий вызов. **Решение:** необходимо модифицировать общую форму "ПечатьДокументов": // Обработчик "ПриОткрытии" формы печати // Процедура ПриОткрытии() ЭлементыФормы.ПолеТабличногоДокумента.ВставитьОбласть(ПечатныйДокумент.Область()); ЭлементыФормы.ПолеТабличногоДокумента.ОтображатьЗаголовки = Ложь; ЭлементыФормы.ПолеТабличногоДокумента.ОтображатьСетку = Ложь; ЭлементыФормы.ПолеТабличногоДокумента.Защита = Защита; ЭлементыФормы.ПолеТабличногоДокумента.ТолькоПросмотр = Истина; ЭлементыФормы.ПолеТабличногоДокумента.ИмяПараметровПечати = ПечатныйДокумент.ИмяПараметровПечати; ЭлементыФормы.ПолеТабличногоДокумента.ПовторятьПриПечатиСтроки = ПечатныйДокумент.ПовторятьПриПечатиСтроки; // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} НАЧАЛО Если НЕ Miko_Ajam = Неопределено И НЕ Miko_Ajam.мОбщийМодуль = Неопределено Тогда мОбщийМодуль = Miko_Ajam.мОбщийМодуль; // добавляем элементы управления на форму мОбщийМодуль.ДобавитьКнопкуОтправкиФаксаНаПанельДействий(ЭлементыФормы.КоманднаяПанельФормы.Кнопки, "МИКО_ВыполнитьДействие", "кнМИКО_ОтправитьФакс"); КонецЕсли; // {{doc:panel1cut:{ МИКО Панель телефонии Asterisk }}} КОНЕЦ КонецПроцедуры добавить обработчик нажатия кнопки: // Набор номера по заданному алгоритму // Параметры // Кнопка - элемент управления формы с типом "КнопкаКоманднойПанели" Процедура МИКО_ВыполнитьДействие(Кнопка) Действие = Кнопка.Имя; Если Miko_Ajam = Неопределено Тогда Возврат; КонецЕсли; Если Действие = "кнМИКО_ОтправитьФакс" Тогда // Обработчик нажатия на кнопку отправки табличного документа в текущий разговор Miko_Ajam.ОтправитьФаксомТабДок(ЭлементыФормы.ПолеТабличногоДокумента); КонецЕсли; КонецПроцедуры Общая печатная форма примет вид: {{ :doc:panel1cut:obschaja_forma_pechati_dokumentov.png? |}} ===== Назначение роли "Телефония" ===== Обязательно укажите для пользователя роль "**Использование панели телефонии Asterisk (МИКО)**". Иначе первый запуск произвести невозможно. {{ :astpanel:designer:user_rol.png?nolink |}} На этом встраивание завершено.