v8.2 УП: Практические нюансы подключения внешних обработок и печатных форм

В своё время задался вопросом создания внешней обработки для УНФ и проштудировал несколько статей на эту тему, среди которых встретил и данную публикацию.

Однако, в статье нет примеров для каждого случая. На практике пришлось столкнуться с нюансами, один из которых присущ конкретному релизу УНФ, а второй, подозреваю универсален для всех конфигураций на БСП.

Нюанс конфигурации "Управление небольшой фирмой, редакция 1.4 (1.4.6.19)"

Замечена эта особенность мной была и на предыдущих релизах и до которого просуществует - неизвестно. Выглядит она так...

В процессе подключения внешней обработки необходимо указать разделы командного интерфейса, в которых она будет размещаться. За это отвечает пункт "Размещение". Нажимаем гиперссылку "Не определено" и в открывшемся окне наблюдаем пустой список. Исследование показало, что в релизе 1.4.5.25 всё было хорошо. Что же случилось? Ответ кроется в общем модуле "ДополнительныеОтчетыИОбработкиПереопределяемый": процедуры "ОпределитьРазделыСДополнительнымиОбработками" и "ОпределитьРазделыСДополнительнымиОтчетами" пусты. Необходимо добавить в них нужные разделы, как это было раньше. Исходя из принципа внесения минимальных изменений в типовую конфигурацию, снимаем с поддержки только корневой элемент конфигурации для возможности создания новых объектов. Без этого никак.

Процедура ОпределитьРазделыСДополнительнымиОбработками(Разделы) Экспорт

  Разделы.Добавить(Метаданные.Подсистемы.НастройкаИАдминистрирование);

КонецПроцедуры

Процедура ОпределитьРазделыСДополнительнымиОтчетами(Разделы) Экспорт

  Разделы.Добавить(Метаданные.Подсистемы.НастройкаИАдминистрирование);

КонецПроцедуры

Если указать стандартный раздел "НастройкаИАдминистрирование", то всё заработает без дополнительных модификаций. Если же нужен иной раздел, надо проверить существование общей команды "ДополнительныеОбработки[НазваниеРаздела]". В типовой УНФ на данный момент присутствует команда "ДополнительныеОбработкиАдминистрирование" для одноимённого раздела. Допустим, нам нужно добавить обработку в свой раздел "Доработки". Копированием существующей команды "ДополнительныеОбработкиАдминистрирование" создаём свою команду "ДополнительныеОбработкиДоработки", включаем её в нужную подсистему, а в обработчике меняем только название подсистемы. Получается вроде этого:

&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)

  ДополнительныеОтчетыИОбработкиКлиент.ОткрытьФормуКомандДополнительныхОтчетовИОбработок(
  ПараметрКоманды,
  ПараметрыВыполненияКоманды,
  ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительнаяОбработка(),
  "Доработки"
  );

КонецПроцедуры

Теперь в нужной нам подсистеме появляется пункт "Дополнительные обработки" и если мы включали эту подсистему в список выбора разделов в процедуре "ОпределитьРазделыСДополнительнымиОбработками", то для обработок отныне доступно указание этой подсистемы.

Теперь добрались и до второго нюанса. Это создание и подключение внешней обработки, аналогичной внешней обработке заполнения ТЧ для конфигураций с обычным интерфейсом. Такая обработка вызывается, например, из документа и каким-либо образом обрабатывает табличную часть. В упоминавшейся ранее статье указывается лишь перечень значений для параметра "Использование". Для обычных обработок это "ОткрытиеФормы". Нам же, допустим, надо каким-нибудь образом обработать табличную часть без открытия окон. Подозрение падает на значение "ВызовСерверногоМетода". Описание гласит, что "ВызовСерверногоМетода – вызов экспортного метода из модуля обработки". Если попробовать сделать экспортную процедуру в модуле обработки, то возникнет ошибка, ссылающаяся на процедуру "ВыполнитьНазначаемуюКомандуДополнительногоОтчетаИлиОбработки" модуля "ДополнительныеОтчетыИОбработки":

Процедура ВыполнитьНазначаемуюКомандуДополнительногоОтчетаИлиОбработки(ВнешнийОбъект, Знач ИдентификаторКоманды, ПараметрыКоманды, ОбъектыНазначения, Знач СценарийВБезопасномРежиме = Ложь)

  Если СценарийВБезопасномРежиме Тогда
    ВыполнитьСценарийВБезопасномРежиме(ВнешнийОбъект, ПараметрыКоманды, ОбъектыНазначения);
  Иначе
    Если ПараметрыКоманды = Неопределено Тогда
      ВнешнийОбъект.ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения);
    Иначе
      ВнешнийОбъект.ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения, ПараметрыКоманды);
    КонецЕсли;
  КонецЕсли;

КонецПроцедуры

Допускаю, что этот механизм, ранее мог вызывать экспортную процедуру, но сейчас он работает иначе. Вызывается экспортная процедура "ВыполнитьКоманду" с двумя (или тремя) параметрами: ИдентификаторКоманды и ОбъектыНазначения. В первом указывается название команды, которой воспользовался пользователь, а во втором - массив ссылок на объекты, к которым применяется данная команда. Соответственно, в модуле обработки необходимо добавить процедуру, куда можно вставить обработчик команды:

Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения) Экспорт
  ЗаписьЖурналаРегистрации("Вызов команды " + ИдентификаторКоманды);
КонецПроцедуры