Как вывести ФИО ответственного лица из запроса в подвал макета СКД?

← На главную

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

Разберем природу этого поведения и подробно рассмотрим все способы вывода таких данных: от чисто декларативных механизмов схемы компоновки до программной обработки.

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

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

Кроме того, если в секции макета ячейке назначен параметр, но в нижней таблице «Параметры макета» для него не задано конкретное выражение СКД, компоновщик данных пытается найти этот параметр в стандартной коллекции параметров данных схемы (ПараметрыДанных), полностью игнорируя поля наборов данных.

Способ 1. Использование механизма ресурсов СКД

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

Перейдем на вкладку Ресурсы в схеме компоновки данных.
Добавим поле с ФИО ответственного (например, ФИООтветственного).
В колонке «Выражение» зададим фиктивную агрегатную функцию: Максимум(ФИООтветственного) или Минимум(ФИООтветственного).
В колонке «Рассчитывать по...» снимем все флажки и оставим только Общий итог. Это гарантирует, что поле не будет вычисляться в промежуточных группировках строк.
На вкладке Макеты создадим макет подвала (или макет группировки с именем подвала), добавим параметр ячейки и сопоставим его с полем ФИООтветственного.

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

Способ 2. Применение функции языка выражений СКД «ВычислитьВыражение»

Разберем вариант, когда объявлять поле ресурсом нежелательно. Язык выражений СКД позволяет обратиться к записям детального уровня напрямую из итоговых секций.

Откроем вкладку Макеты и выберем область подвала.
В свойствах ячейки укажем тип заполнения Параметр и введем имя, например, ОтветственныйПодвал.
В нижней таблице настройки макета для созданного параметра в колонке «Выражение» пропишем формулу: ВычислитьВыражение("ФИООтветственного", , , "Первая", "Первая")

Такой синтаксис указывает компоновщику данных явно получить значение поля ФИООтветственного из первой детальной записи текущего контекста и передать его в оформление ячейки подвала.

Способ 3. Передача значения через параметр в процедуре «ПриКомпоновкеДанных»

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

На вкладке Параметры схемы компоновки создадим новый параметр с именем ОтветственноеЛицо (тип — Строка или ссылка на справочник).
В пользовательском макете свяжем ячейку подвала с этим параметром через выражение &ОтветственноеЛицо.
В модуле отчета переопределим обработчик события ПриКомпоновкеДанных:


Процедура ПриКомпоновкеДанных(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
    
    СтандартнаяОбработка = Ложь;
    
    // Получаем текущие настройки отчета
    Настройки = КомпоновщикНастроек.ПолучитьНастройки();
    
    // Получаем срез последних или выполняем запрос к регистру
    Запрос = Новый Запрос;
    Запрос.Текст = 
        "ВЫБРАТЬ ПЕРВЫЕ 1
        |	ОтветственныеЛицаСрезПоследних.ФизическоеЛицо.Наименование КАК ФИО
        |ИЗ
        |	РегистрСведений.ОтветственныеЛица.СрезПоследних(&Период, ) КАК ОтветственныеЛицаСрезПоследних";
    Запрос.УстановитьПараметр("Период", ТекущаяДатаСеанса());
    
    Выборка = Запрос.Выполнить().Выбрать();
    ФИООтветственного = "";
    Если Выборка.Следующий() Тогда
        ФИООтветственного = Выборка.ФИО;
    КонецЕсли;
    
    // Устанавливаем значение параметра СКД
    ПараметрОтветственный = Настройки.ПараметрыДанных.Элементы.Найти("ОтветственноеЛицо");
    Если ПараметрОтветственный <> Неопределено Тогда
        ПараметрОтветственный.Значение = ФИООтветственного;
        ПараметрОтветственный.Использование = Истина;
    КонецЕсли;
    
    // Выполняем стандартную компоновку с обновленными настройками
    КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
    МакетКомпоновки = КомпоновщикМакета.Выполнить(СхемаКомпоновкиДанных, Настройки, ДанныеРасшифровки);
    
    ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
    ПроцессорКомпоновки.Инициализировать(МакетКомпоновки, , ДанныеРасшифровки, Истина);
    
    ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
    ПроцессорВывода.УстановитьДокумент(ДокументРезультат);
    ПроцессорВывода.Вывести(ПроцессорКомпоновки);
    
КонецПроцедуры

Способ 4. Вывод подвала отдельным набором данных и группировкой

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

НаборДанных1: формирует основные данные отчета.
НаборДанных2: содержит запрос к регистру сведений и возвращает исключительно подписи и ответственных лиц. Связи между наборами не настраиваются.
На вкладке Настройки в структуру отчета добавляются две независимые группировки верхнего уровня (детальные записи):
- Первая группировка выводит поля из НаборДанных1 (основная таблица отчета);
- Вторая группировка следует сразу за первой и выводит данные из НаборДанных2, используя собственный макет строки или подвала.

Такой подход позволяет полностью отказаться от написания кода на встроенном языке и сохраняет отчет на стандартных механизмах вывода СКД.

Особенности работы с макетами подвалов

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