Как подключить и настроить внешние отчеты в 1С:УНФ после обновления (релиз 1.6.26 и выше)?

Часто после обновления конфигурации 1С:Управление нашей фирмой (УНФ) на релиз 1.6.26 и выше пользователи и разработчики сталкиваются с проблемой: старые внешние отчеты перестают работать и не отображаются в панелях разделов. Открыть их можно только через меню Файл - Открыть. Давайте разберем по шагам, что изменилось в механизмах Библиотеки стандартных подсистем (БСП) и как правильно адаптировать наши внешние отчеты под новые требования.

Изменения в функции регистрации отчета (БСП)

Ранее для регистрации внешнего отчета было достаточно заполнить структуру строковыми значениями. Теперь конфигурация требует строгого соответствия новым стандартам БСП и использования вызовов клиент-серверных общих модулей. Проанализируем правильный вариант написания функции СведенияОВнешнейОбработке.

В модуле объекта внешнего отчета необходимо использовать следующий код:

Функция СведенияОВнешнейОбработке() Экспорт
    ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.4.1");
    ПараметрыРегистрации.Информация = НСтр("ru = 'Описание вашего отчета'");
    
    // Используем методы общих модулей вместо строк
    ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительныйОтчет();
    ПараметрыРегистрации.Версия = "1.0";
    ПараметрыРегистрации.ОпределитьНастройкиФормы = Истина;
    
    Команда = ПараметрыРегистрации.Команды.Добавить();
    Команда.Представление = НСтр("ru = 'Сформировать отчет'");
    Команда.Идентификатор = "ВашИдентификаторОтчета";
    Команда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы();
    Команда.ПоказыватьОповещение = Ложь;
    
    Возврат ПараметрыРегистрации;
КонецФункции

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

Обязательные реквизиты и настройки в Конфигураторе

Для корректной работы отчета в УНФ одной лишь функции регистрации недостаточно. Рассмотрим дополнительные настройки, которые обязательно нужно сделать в конфигураторе:

1. Указание Хранилища вариантов: Откройте свойства внешнего отчета и найдите поле Хранилище вариантов. В нем необходимо жестко выбрать стандартное ХранилищеВариантовОтчетов. Без этого пользователи не смогут сохранять свои настройки и добавлять отчет в избранное.
2. Реквизит идентификации: Добавьте в отчет новый реквизит с именем ЭтоОтчетУНФ (тип данных — Булево). В модуле объекта, в процедуре инициализации, установите этому реквизиту значение Истина. Это помогает внутренним механизмам УНФ правильно идентифицировать ваш отчет.

Тегирование вариантов отчета

Чтобы отчет корректно распределился по разделам в интерфейсе пользователя (например, попал в раздел «Закупки» или «Производство»), необходимо прописать теги для его вариантов. Выясним, как это сделать в модуле объекта отчета.

Процедура ПриОпределенииНастроекОтчета(НастройкиОтчета, НастройкиВариантов) Экспорт
    Для Каждого НастройкиТекВарианта Из НастройкиВариантов Цикл
        // Названия тегов должны строго совпадать с наименованиями разделов интерфейса
        НастройкиТекВарианта.Значение.Теги = НСтр("ru = 'Продажи,Закупки'");
    КонецЦикла;
    
    // Для УНФ также добавляем:
    ЭтоОтчетУНФ = Истина;
КонецПроцедуры

Публикация отчета в режиме Предприятия

Когда программная часть готова, отчет необходимо правильно зарегистрировать и разместить в самой базе. Посмотрим на алгоритм действий в режиме 1С:Предприятие:

1. Убедитесь, что в базе разрешено использование дополнительных отчетов. Перейдите в раздел Главное — Больше возможностей — Администрирование — Печатные формы, отчеты и обработки и установите флаг Дополнительные отчеты и обработки.
2. Откройте справочник Дополнительные отчеты и обработки и добавьте ваш файл.
3. В карточке регистрации отчета найдите поле Размещение. Обязательно выберите разделы, в которых отчет должен быть доступен (если вы указали теги в конфигураторе, программа может подсказать нужные разделы).
4. Настройте Быстрый доступ. Добавьте пользователей или группы пользователей, у которых этот отчет будет отображаться в панели отчетов по умолчанию.

После выполнения этих шагов ваш внешний отчет снова появится в нужных подсистемах и будет корректно работать со всеми современными механизмами системы компоновки данных (СКД), включая новые интерфейсы быстрых отборов и настроек оформления, добавленные в УНФ 1.6.26.