Различия

Здесь показаны различия между двумя версиями данной страницы.

--- astpanel:designer:arbis [2018/05/10 14:56]
tpor создано
+++ astpanel:designer:arbis [2018/08/10 14:14] (текущий)
tpor
@@ Строка 1: / Строка 1: @@
-====== Интеграция  в конфигурацию "Бухгалтерия предприятия, редакция 3.0 (3.0.59.54) / 1С-АРБИС:Управление фирмой-франчайзи, редакция 4.0 (4.0.11.12)" ======
+====== Интеграция  в конфигурацию "Бухгалтерия предприятия (ред. 3.0) / 1С-АРБИС:УФФ (ред. 4.0)" ======
   * [[http://wiki.miko.ru/astpanel:designer|Обратно к инструкции...]]
-<note important>Встраивать панель телефонии стало проще! Доработка конфигурации с минимальными изменениями! Встраивание панели телефонии с помощью **механизма расширений** описано [[astpanel:designer:extension|здесь]].</note>
+<note warning>Руководство составлено для "Бухгалтерия предприятия, редакция **3.0 (3.0.59.54)** / 1С-АРБИС:Управление фирмой-франчайзи, редакция **4.0 (4.0.11.12)**" и Панели телефонии МИКО **1.4.26.25+**.\\  \\
+Обязательно перед работами создайте **РЕЗЕРВНУЮ КОПИЮ** информационной базы.</note>
-<note warning>Руководство составлено для "Управление торговлей, редакция 11.1.2.18" и панели телефонии Asterisk 1.X.20.11
-Обзательно перед работами создайте РЕЗЕРВНУЮ КОПИЮ информационной базы.</note>
 ===== Этап 1. Настройка правил поддержки =====
@@ Строка 16: / Строка 14: @@
   - Включите возможность изменения конфигурации. На предупреждение программы ответьте утвердительно.
   - В появившемся окне укажите, что объекты поставщика не редактируются. {{ :doc:panel1ccrm20:rules.png |}}
-  - Затем для корневого объекта конфигурации ("УправлениеТорговлей") установите правило поддержки на **"Объект поставщика редактируется с сохранением поддержки"**.
+  - Затем для корневого объекта конфигурации ("УправлениеФирмойФранчайзи") установите правило поддержки на **"Объект поставщика редактируется с сохранением поддержки"**.
 Теперь конфигурация готова к внесению изменений.
-{{page>astpanel:designer:unf#ehtap_2_vstraivanie_paneli_telefonii}}
+===== Этап 2. Встраивание панели телефонии =====
+<note important>Начать рекомендуем с [[astpanel:designer:optimization_managed|инструкции по оптимизации конфигурации]].</note>
-===== Этап 3. Добавление кнопки "Позвонить" =====
+Необходимо встроить внешнюю обработку (панель телефонии) в конфигурации, настроить права доступа и ее автоматический запуск в фоновом режиме.
+==== Изменение типовых объектов ====
+Для работы панели телефонии в фоне и ее автоматического запуска внесем изменения в модуль управляемого приложения.
+  - Откройте модуль управляемого приложения. {{ :doc:korenconf.png |}}
+  - Определите глобальную переменную в начале модуля до раздела процедур. <code 1c>// PT1C / Панель телефонии Asterisk / Начало
+Перем сфпФормаТелефон Экспорт;
+// PT1C / Панель телефонии Asterisk / Конец </code>
+  - Перейдите к процедуре //"ПриНачалеРаботыСистемы"//. В конец процедуры вставьте код приведенный ниже.<code 1c>
+        // PT1C / Панель телефонии Asterisk / Начало
+	Попытка
+		Отказ = Ложь;
+		// получим форму - основной "модуль" панели телефонии
+		сфпФормаТелефон = ПолучитьФорму("Обработка.МИКО_ПанельТелефонииДля1С.Форма.Форма");
+	Исключение
+		сфпФормаТелефон = Неопределено; //Нет прав на обработку
+	КонецПопытки;
+	Если НЕ сфпФормаТелефон = Неопределено Тогда
+		сфпФормаТелефон.ИнициализироватьПанельТелефонии(Истина, Отказ);
+	КонецЕсли;
+	// проверим успешность инициализации
+	Если Отказ Тогда
+		Сообщить("Не удалось запустить ""МИКО Панель телефонии Asterisk""");
+	КонецЕсли;
+        // PT1C / Панель телефонии Asterisk / Конец
+</code>
+  - Перейдите к процедуре //"ПередЗавершениемРаботыСистемы"// (создайте процедуру, если ее нет). В конец процедуры вставьте код приведенный ниже. <code 1c>
+	// PT1C / Панель телефонии Asterisk / Начало
+	Если Отказ = Ложь И сфпФормаТелефон <> Неопределено Тогда
+		сфпФормаТелефон.ЗавершитьРаботу();
+	КонецЕсли;
+	// PT1C / Панель телефонии Asterisk / Конец
+</code>
+==== Добавление обработки и подсистемы в конфигурацию ====
+  * Вставьте внешнюю обработку, которая идет в поставке, в конфигурацию, она должна называться **МИКО_ПанельТелефонииДля1С**.
+  * Добавьте в обработку **МИКО_ПанельТелефонииДля1С** команду "**ОткрытьПанельТелефонии**"
+  * Установите для созданной команды свойство "**Группа**" в значение "**Панель навигации.Важное**".{{ :doc:panel1cunf:commandopen_new.png |}}
+  * Далее требуется описать обработчик команды "**ОткрытьПанельТелефонии**".
+<code 1c>&НаКлиенте
+Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
+	Попытка
+		ФормаПанелиТелефонии = Вычислить("сфпФормаТелефон");
+	Исключение
+	КонецПопытки;
+	Если ФормаПанелиТелефонии <> Неопределено Тогда
+		Если ФормаПанелиТелефонии.Открыта() Тогда
+			ФормаПанелиТелефонии.Активизировать();
+		Иначе
+			ФормаПанелиТелефонии.Открыть();
+		КонецЕсли;
+		Возврат;
+	КонецЕсли;
+	Попытка
+		МодульСфпСофтФонПроКлиент = Вычислить("сфпСофтФонПроКлиент");
+	Исключение
+		МодульСфпСофтФонПроКлиент = Неопределено;
+	КонецПопытки;
+	Если МодульСфпСофтФонПроКлиент <> Неопределено Тогда
+		МодульСфпСофтФонПроКлиент.сфпПодключитьСофтФон();
+	КонецЕсли;
+КонецПроцедуры
+</code>
+  * Создайте новую подсистему "**МИКО_ПанельТелефонии**" и включите в ее состав обработку **МИКО_ПанельТелефонииДля1С**.
+  * В командном интерфейсе выполнить настройку - **отключить стандартную команду запуска обрабокти**
+{{ :astpanel:designer:command_interface.png?nolink |}}
+==== Настройка ролей ====
+  - Добавьте в конфигурацию новую роль **МИКО_Софтфон**.
+  - Снимите все отметки о правах выставляемые по умолчанию.
+  - Для обработки **МИКО_ПанельТелефонииДля1С** а также для команды //"ОткрытьПанельТелефонии"// отметьте все доступные права. {{ :doc:panel1ccrm20:role.png? | Права на обработку.}} {{ :astpanel:designer:permit_command_open_new.png?nolink&450 |Права на команду "ОткрытьПанельТелефонии"}}
+  - Для подсистемы **МИКО_ПанельТелефонии** отметьте все доступные права. {{ :astpanel:designer:permit_csubsystem.png?nolink&450 |}}
+  - Добавьте роль в состав подсистемы **МИКО_ПанельТелефонии**.
+  - Обновите конфигурацию базы данных. {{ :doc:panel1ccrm20:confupd.png? |}}
+<note tip>Далее можно переходить к [[astpanel:enterprise:managed |настройке в режиме 1С:Предприятие 8]], шаги описанные ниже являются опциональными.</note>
+===== Этап 3. Доработка справочника "Контрагенты" =====
+  - Добавьте в справочник реквизит **PT1C_ОсновнойМенеджер** (//синоним Основной менеджер//). Тип **СправочникСсылка.Пользователи**.
+  - В **форму элемента** справочника в **конец** процедуры **ПриСозданииНаСервере** добавьте фрагмент кода: <code>
+	// PT1C / Начало
+	pt1c_Элемент = Элементы.Вставить("PT1C_ОсновнойМенеджер", Тип("ПолеФормы"),,);
+	pt1c_Элемент.ПутьКДанным = "Объект.PT1C_ОсновнойМенеджер";
+	pt1c_Элемент.Вид = ВидПоляФормы.ПолеВвода;
+	pt1c_Элемент.Заголовок   = "Ответственный менеджер";
+	// PT1C / Конец
+</code>
+===== Этап 4. Добавление кнопки "Прослушать запись" в документ "АРБИС_Событие" =====
+Порядок действий:
+  - Добавьте в документ "**АРБИС_Событие**" реквизит **PT1C_ID_Звонок** (//синоним id звонок//). Тип **Строка**, длина 32.
+  - Добавьте в обработку **МИКО_ПанельТелефонииДля1С** команду "**ПрослушатьЗапись**" и поместите в модуль команды <code 1c>
+&НаКлиенте
+Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
+	ПанельАктивна = Ложь;
+	Попытка
+		ФормаПанелиТелефонии = Вычислить("сфпФормаТелефон");
+		ПанельАктивна = ФормаПанелиТелефонии <> Неопределено;
+	Исключение
+	КонецПопытки;
+	Если ФормаПанелиТелефонии = Неопределено Тогда
+		Попытка
+			ФормаПанелиТелефонии = Вычислить("сфпФормаТелефонВнешняяПанель");
+			ПанельАктивна = ФормаПанелиТелефонии <> Неопределено;
+		Исключение
+		КонецПопытки;
+	КонецЕсли;
+	Если ФормаПанелиТелефонии = Неопределено Тогда
+		Попытка
+			ФормаПанелиТелефонии = Вычислить("сфпПанельУправления");
+			ПанельАктивна = ФормаПанелиТелефонии <> Неопределено;
+		Исключение
+		КонецПопытки;
+	КонецЕсли;
+	Если ПанельАктивна Тогда
+		ДокументСобытиеНазвание = ФормаПанелиТелефонии.ИмяДокументСобытие();
+		ID_Звонок = ПолучитьИдентификаторЗвонка(ПараметрКоманды, ДокументСобытиеНазвание);
+		Если ID_Звонок <> Неопределено Тогда
+			ФормаПанелиТелефонии.ПрослушатьЗвонокПоИдентификатору(ID_Звонок);
+		КонецЕсли;
+	КонецЕсли;
+КонецПроцедуры
+Функция ПолучитьИдентификаторЗвонка(Ссылка, ДокументСобытиеНазвание)
+ 	Возврат Ссылка.PT1C_ID_Звонок;
+КонецФункции // ПолучитьИдентификаторЗвонка()
+</code>
+  - "**Группа**" в значение "**Командная панель формы.Важное**".
+  - "**Тип параметра команды**" должно иметь тип данных: **ДокументСсылка.АРБИС_Событие**.
+  - "**Отображение**" в значение "**Картинка и текст**", "**Картинка**" в значение "**МИКО_ЗаписьРазговора**".
+  - Раскройте дерево конфигурации на группе "**Общие картинки**" и добавьте в нее новый элемент "**МИКО_ЗаписьРазговора**".
+  - Загрузите в созданный объект изображение для кнопки "**Прослушать запись**" ({{:doc:cassetetape16.png|}}).
+  - Задайте картинку для команды
+Данная команда будет доступна только для пользователей с полными правами.
+Обновите конфигурацию базы данных и запустите программу в режиме "**Предприятие**".
+===== Этап 5. Добавление кнопки "Позвонить" =====
 Для автоматизации набора номера телефона добавим кнопку **"Позвонить"** в область команд форм некоторых справочников и документов.
@@ Строка 31: / Строка 187: @@
 &НаКлиенте
 Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
-	Если сфпФормаТелефон <> Неопределено Тогда
+	ПанельАктивна = Ложь;
+	Попытка
+		ФормаПанелиТелефонии = Вычислить("сфпФормаТелефон");
+		ПанельАктивна = ФормаПанелиТелефонии <> Неопределено;
+	Исключение
+	КонецПопытки;
+	Если ФормаПанелиТелефонии = Неопределено Тогда
+		Попытка
+			ФормаПанелиТелефонии = Вычислить("сфпФормаТелефонВнешняяПанель");
+			ПанельАктивна = ФормаПанелиТелефонии <> Неопределено;
+		Исключение
+		КонецПопытки;
+	КонецЕсли;
+	Если ФормаПанелиТелефонии = Неопределено Тогда
+		Попытка
+			ФормаПанелиТелефонии = Вычислить("сфпПанельУправления");
+			ПанельАктивна = ФормаПанелиТелефонии <> Неопределено;
+		Исключение
+		КонецПопытки;
+	КонецЕсли;
+	Если ПанельАктивна Тогда
 		СписокУчастников = ПолучитьСсылкуНаУчастникаИзДокумента(ПараметрКоманды);
 		Если СписокУчастников <> Неопределено Тогда
-			сфпФормаТелефон.ПозвонитьВыбравТелефон(СписокУчастников);
+			ФормаПанелиТелефонии.ПозвонитьВыбравТелефон(СписокУчастников);
 		КонецЕсли;
 	КонецЕсли;
 КонецПроцедуры
@@ Строка 52: / Строка 230: @@
 		МассивОбъектов = Новый Массив(1);
 		МассивОбъектов[0] = Ссылка;
 		Возврат МассивОбъектов;
 	ИначеЕсли Документы.ТипВсеСсылки().СодержитТип(ТипЗнч(Ссылка)) Тогда
 		МассивОбъектов = Новый Массив;
 		ДобавитьЗначениеРеквизитаВМассив(Ссылка, МассивОбъектов, "Контрагент");
-		ДобавитьЗначениеРеквизитаВМассив(Ссылка, МассивОбъектов, "Партнер");
 		ДобавитьЗначениеРеквизитаВМассив(Ссылка, МассивОбъектов, "КонтактноеЛицо");
-		ДобавитьЗначениеРеквизитаВМассив(Ссылка, МассивОбъектов, "АбонентКонтакт");
+		ДобавитьЗначениеРеквизитаВМассив(Ссылка, МассивОбъектов, "Организация");
+		ДобавитьЗначениеРеквизитаВМассив(Ссылка, МассивОбъектов, "Сотрудник");
 		Возврат МассивОбъектов;
 	КонецЕсли;
 КонецФункции // ПолучитьСсылкуНаУчастникаИзДокумента()
@@ Строка 79: / Строка 258: @@
   - Установите свойство **"Группа"** в значение **"Командная панель формы.Важное"**. {{:astpanel:designer:sostav_dial.png?500|}}
   - Свойство **"Тип параметра команды"** должно иметь составной тип данных:
-    * **СправочникСсылка.Партнеры**;
-    * **СправочникСсылка.Контрагенты**;
+    * **СправочникСсылка.КонтактныеЛица**;
-    * **СправочникСсылка.КонтактныеЛицаПартнеров**;
+    * **ДокументСсылка.АРБИС_ПутевойЛист**;
-    * **ДокументСсылка.ТелефонныйЗвонок**;
+    * **СправочникСсылка.Контрагенты**;
-    * **ДокументСсылка.ЗаказКлиента**;
+    * **ДокументСсылка.АРБИС_Сделка**;
+    * **СправочникСсылка.Пользователи**;
+    * **СправочникСсылка.Организации**;
+    * **ДокументСсылка.АРБИС_Событие**.
 Для ранее созданной роли "**МИКО_Софтфон**" добавьте права на доступ к команде "**Позвонить**".
 {{ :astpanel:designer:permit_command_dial.png?nolink&450 |}}
@@ Строка 96: / Строка 278: @@
 Обновите конфигурацию базы данных и запустите программу в режиме **"Предприятие"**. Результат работы показан на рисунке ниже.
-===== Этап 4. Добавление кнопки "Позвонить" на закладку контактной информации справочников =====
-При использовании конфигурации **11.2.3.95** необходимо доработать общий модуль "**УправлениеКонтактнойИнформациейКлиент**", процедуру "**ПозвонитьПоТелефону**", пример:
-<code 1c>Процедура ПозвонитьПоТелефону(НомерТелефона)
-	НомерТелефона = СтроковыеФункцииКлиентСервер.ЗаменитьОдниСимволыДругими("()_- ", НомерТелефона, "");
-	// PT1C / Панель телефонии Asterisk / Начало
-	Если сфпФормаТелефон <> Неопределено Тогда
-		сфпФормаТелефон.СделатьЗвонок(НомерТелефона);
-		Возврат;
-	КонецЕсли;
-	// PT1C / Панель телефонии Asterisk / Конец
-	// по умолчанию используем "tel"
-	ИмяПротокола = "tel";
-	// *** *** ***
-	// ВНИМАНИЕ ПРОПУЩЕНА ЧАСТЬ ИСХОДНОГО КОДА
-	// *** *** ***
-КонецПроцедуры
-</code>
-<note important>Для конфигурации "Управление торговлей, **редакция 11.1**" выполните инструкции по [[astpanel:designer:ut11:callcommand_ut11_1|ссылке]].</note>
-<note important>Для конфигурации "Управление торговлей, **редакция 11.2**" (выпущенных ранее **11.2.3**) выполните инструкции по [[astpanel:designer:ut11:callcommand_ut11_2|ссылке]].</note>
-Обновите конфигурацию базы данных и запустите программу в режиме //"Предприятие"//. Результат работы показан на рисунке ниже.
-{{ :doc:panel1cunf:showbuttoncall.png |}}
-===== Этап 5. Добавление кнопки "Прослушать запись" в документ "Телефонный звонок" =====
-По завершению работы помощника первоначальной настройки для документа будет создано свойство "**ID_Звонок**", назначение которого - хранить ссылку на запись.
-Порядок действий:
-  - Добавьте в обработку **МИКО_ПанельТелефонииДля1С** команду "**ПрослушатьЗапись**" и поместите в модуль команды <code 1c>&НаКлиенте
-Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
-	Если сфпФормаТелефон <> Неопределено Тогда
-		ID_Звонок = ПолучитьИдентификаторЗвонка(ПараметрКоманды);
-		Если ID_Звонок <> Неопределено Тогда
-			сфпФормаТелефон.ПрослушатьЗвонокПоИдентификатору(ID_Звонок);
-		КонецЕсли;
-	КонецЕсли;
-КонецПроцедуры
-Функция ПолучитьИдентификаторЗвонка(Ссылка)
-	Запрос = Новый Запрос;
-	Запрос.Текст =
-		"ВЫБРАТЬ
-		|	СобытиеДополнительныеРеквизиты.Значение,
-		|	СобытиеДополнительныеРеквизиты.ТекстоваяСтрока
-		|ИЗ
-		|	Документ.ТелефонныйЗвонок.ДополнительныеРеквизиты КАК СобытиеДополнительныеРеквизиты
-		|ГДЕ
-		|	СобытиеДополнительныеРеквизиты.Ссылка = &ДокументСсылка
-		|	И СобытиеДополнительныеРеквизиты.Свойство В
-		|			(ВЫБРАТЬ
-		|				ДополнительныеРеквизитыИСведения.Ссылка
-		|			ИЗ
-		|				ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения КАК ДополнительныеРеквизитыИСведения
-		|			ГДЕ
-		|				ДополнительныеРеквизитыИСведения.Наименование = &НаименованиеДопСвойства)";
-	Запрос.УстановитьПараметр("НаименованиеДопСвойства", "ID_Звонок");
-	Запрос.УстановитьПараметр("ДокументСсылка", Ссылка);
-	РезультатЗапроса = Запрос.Выполнить();
-	Если Не РезультатЗапроса.Пустой() Тогда
-		Выборка = РезультатЗапроса.Выбрать();
-		Выборка.Следующий();
-		Возврат Выборка.Значение;
-	КонецЕсли;
-КонецФункции // ПолучитьИдентификаторЗвонка()</code>
-  - "**Группа**" в значение "**Командная панель формы.Важное**".
-  - "**Тип параметра команды**" должно иметь тип данных: **ДокументСсылка.Телефонный звонок**.
-  - "**Отображение**" в значение "**Картинка и текст**", "**Картинка**" в значение "**МИКО_ЗаписьРазговора**".
-  - Раскройте дерево конфигурации на группе "**Общие картинки**" и добавьте в нее новый элемент "**МИКО_ЗаписьРазговора**".
-  - Загрузите в созданный объект изображение для кнопки "**Прослушать запись**" ({{:doc:cassetetape16.png|}}).
-  - Задайте картинку для команды
-Данная команда будет доступна только для пользователей с полными правами.
-Обновите конфигурацию базы данных и запустите программу в режиме "**Предприятие**". Результат работы показан на рисунке ниже.
-{{ :astpanel:designer:telefon_ring.png?nolink&700 | }}

Внимание!
Эта wiki об устаревших версиях
Документация к актуальной версии интеграции 1С и телефонии доступна по ссылке

Wiki документация

Различия

Внимание! Эта wiki об устаревших версиях Документация к актуальной версии интеграции 1С и телефонии доступна по ссылке

Wiki документация

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы

Внимание!
Эта wiki об устаревших версиях
Документация к актуальной версии интеграции 1С и телефонии доступна по ссылке