Почему внешний отчет не выводит данные в ЗУП 3 и как заставить его работать?

← На главную

При попытке сохранить сложный типовой отчет из конфигурации «Зарплата и управление персоналом 3» (например, ОтчетыПоСотрудникам) в виде внешнего отчета (файла с расширением .erf) разработчики часто сталкиваются с ситуацией, когда отчет успешно открывается, формируется без явных синтаксических ошибок платформы, однако результат компоновки оказывается абсолютно пустым. Разберем по шагам внутренние механизмы подсистем ЗУП 3 и Библиотеки стандартных подсистем (БСП), выясним причину такого поведения и рассмотрим рабочие способы адаптации отчета.

Архитектурные причины проблемы в ЗУП 3

Проанализируем ситуацию изнутри. В конфигурациях линейки ЗУП 3 и других типовых решениях на базе БСП архитектура отчетов существенно отличается от классической схемы компоновки данных (СКД):

Динамическая подмена текста запросов. В исходной схеме компоновки данных типового отчета часто содержится лишь шаблонная заготовка — пустой запрос вида ВЫБРАТЬ ПЕРВЫЕ 0 ... или псевдозапрос к временным таблицам. Реальный текст запроса генерируется программно в момент компоновки при обращении к процедурам общих модулей (например, ЗарплатаКадрыОбщиеНаборыДанных).
Зависимость от модуля менеджера и метаданных. Внешний отчет платформенно лишен модуля менеджера. Процедуры описания вариантов отчетов, такие как НастроитьВариантыОтчета(Настройки, НастройкиОтчета), БСП штатно ищет именно в модуле менеджера объекта конфигурации.
Проверка ссылки на отчет в подсистеме «Варианты отчетов». При открытии формы отчета подсистема БСП проверяет наличие отчета в кэше предопределенных настроек. В типовой форме проверяется условие принадлежности отчета метаданным конфигурации. Для внешнего отчета (объекта типа ВнешнийОтчет.*) эта проверка возвращает отрицательный результат, из-за чего алгоритм инициализации схемы компоновки и вызова генерации запросов прерывается.

Способ 1. Адаптация внешнего отчета с собственной формой

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

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

В модуле объекта внешнего отчета переопределяем событие компоновки:


Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
    
    СтандартнаяОбработка = Ложь;
    ЗарплатаКадрыОбщиеНаборыДанных.ЗаполнитьОбщиеИсточникиДанныхОтчета(ЭтотОбъект);
    
    // Выполняем стандартную инициализацию и вывод СКД
    КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
    МакетКомпоновки = КомпоновщикМакета.Выполнить(СхемаКомпоновкиДанных, КомпоновщикНастроек.ПолучитьНастройки(), ДанныеРасшифровки);
    
    ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
    ПроцессорКомпоновки.Инициализировать(МакетКомпоновки, , ДанныеРасшифровки, Истина);
    
    ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
    ПроцессорВывода.УстановитьДокумент(ДокументРезультат);
    ПроцессорВывода.Вывести(ПроцессорКомпоновки);

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

Способ 2. Корректное переопределение макетов печатных форм (Т-2, Т-4)

Рассмотрим еще одну распространенную проблему: разработчик изменяет макет печатной формы внутри внешнего отчета (например, макет личной карточки ПФ_MXL_Т2), но при формировании отчета в режиме «1С:Предприятие» изменения не отображаются.

Проанализируем код модуля объекта отчета. В типовом решении получение макетов часто реализовано через вызовы общей подсистемы печати по полному имени метаданных:


МакетГруппировки = УправлениеПечатью.МакетПечатнойФормы("Отчет.ОтчетыПоСотрудникам.ПФ_MXL_Т2");

В такой ситуации внешний отчет принудительно обращается к макету встроенного в конфигурацию отчета, игнорируя собственный макет. Чтобы макет считывался из самого внешнего файла, необходимо заменить обращение к УправлениеПечатью на метод текущего объекта:

МакетГруппировки = ЭтотОбъект.ПолучитьМакет("ПФ_MXL_Т2");

Важно: проверьте все вхождения имени макета в модуле объекта — как правило, процедура вывода формирует шапку и строки в разных методах, поэтому вызов ПолучитьМакет должен быть скорректирован во всех местах формирования печатной формы.

Способ 3. Создание дубля отчета в конфигурации или через расширение

Если нет жесткого требования использовать именно отдельный файл .erf, наиболее надежным решением является добавление копии отчета в основную конфигурацию или в расширение конфигурации (.cfe).

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

В модуле менеджера нового отчета сохраняем процедуру НастроитьВариантыОтчета, где описаны ключи и наименования вариантов (например, ШтатныеСотрудники, ЛичныеДанныеСотрудников, УволенныеСотрудники).
В общем модуле ЗарплатаКадрыОтчетыБазовый находим процедуру НастроитьВариантыОтчетов и добавляем вызов для нового отчета:
```
ВариантыОтчетов.НастроитьОтчетВМодулеМенеджера(Настройки, Метаданные.Отчеты.ОтчетыПоСотрудникамНовый);
```
Синхронизация справочника вариантов: В БСП доступные варианты хранятся в справочнике ВариантыОтчетов. Простого добавления кода в модуль недостаточно — платформа должна обновить метаданные в информационной базе. Для этого необходимо запустить базу в режиме «1С:Предприятие» с ключом командной строки: 1cv8.exe ENTERPRISE /F "ПутьКБазе" /C ЗапуститьОбновлениеИнформационнойБазы Либо выполнить программное обновление через внешнюю обработку или консоль кода вызовом: ВариантыОтчетов.Обновить(); После обновления предопределенные варианты появятся в пользовательском интерфейсе.

Особенности отладки формирования отчетов

Если при попытке отладить код точки останова в модуле объекта или схемы компоновки не срабатывают, убедимся в правильности настроек отладчика:

В современных конфигурациях 1С формирование всех отчетов по умолчанию выполняется в фоновом задании на сервере, даже если используется файловая база данных.
В конфигураторе открываем меню Отладка → Подключение..., нажимаем кнопку Автоматическое подключение и обязательно устанавливаем флаг напротив пункта Фоновые задания.
После включения отладки фоновых заданий точки останова в модуле объекта внешнего отчета при нажатии кнопки «Сформировать» начнут срабатывать штатно.