Как правильно выводить итоги запроса в табличный документ 1С?

← На главную

Часто при разработке отчетов в 1С начинающие разработчики сталкиваются с трудностями при выводе итоговых данных. Основная проблема заключается в непонимании того, как работают ИТОГИ в запросах и как правильно взаимодействовать с объектом ТабличныйДокумент. Давайте разберем эту задачу по шагам.

Почему возникают проблемы с итогами в запросе?

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

Рассмотрим пример. Допустим, нам нужно вывести Оклад сотрудника в строке итога. Если мы просто напишем Оклад в списке итогов, 1С выдаст ошибку, так как система не знает, какое значение взять, если у сотрудника вдруг окажется несколько записей в рамках выборки. Для решения необходимо использовать агрегатные функции, такие как СУММА(), МАКСИМУМ() или МИНИМУМ().


// Пример правильного оформления итогов в тексте запроса
ВЫБРАТЬ
    Работник,
    Оклад
ИЗ
    ...
ИТОГИ 
    МАКСИМУМ(Оклад) КАК Оклад
ПО 
    Работник

Использование МАКСИМУМ(Оклад) позволяет системе выбрать значение, даже если оно одно, и при этом формально удовлетворить требования синтаксиса языка запросов 1С.

Правильный порядок вывода макета в ТабличныйДокумент

Еще один важный момент — это взаимодействие с макетом. Многие совершают ошибку, пытаясь заполнить параметры после того, как область уже была выведена в ТабличныйДокумент. Важно помнить: область макета — это шаблон.

Сначала мы получаем область из макета: Область = Макет.ПолучитьОбласть("ИмяОбласти");.
Затем мы заполняем параметры этой области данными из выборки: Область.Параметры.ИмяПараметра = Выборка.Значение;.
И только после этого выводим область в документ: ТабДок.Вывести(Область);.

Если вы попробуете заполнить параметры после вызова метода Вывести(), изменения не отобразятся в табличном документе, так как после вывода параметры превращаются в «голые» значения (текст или числа) и связь с объектом Параметры теряется.

Разбор иерархического обхода

Многие путают обычный обход иерархии с рекурсией. Для вывода данных по группировкам используйте метод Выбрать() с параметром ОбходРезультатаЗапроса.ПоГруппировкам. Это позволяет последовательно обходить уровни иерархии, заданные в запросе.


ВыборкаРаботник = Запрос.Выполнить().Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам, "Работник");

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

Что делать, если задача усложняется?

Если вам требуется сложная структура отчета с множеством вложенных итогов, группировок и специфическим оформлением, не стремитесь писать сложный программный код. В таких случаях лучше использовать Систему Компоновки Данных (СКД). СКД позволяет настраивать группировки, вычисляемые поля и итоговые показатели через визуальный конструктор, что значительно упрощает поддержку кода в будущем.

Если же вы вынуждены работать с ТабличныйДокумент вручную, помните: прямое управление ячейками через ТабДок.Область() — это крайняя мера, которую стоит применять только в исключительных случаях, когда стандартные возможности макетов не позволяют добиться нужного результата (например, при сложной динамической раскраске ячеек).

Работая вместе над такими задачами, мы учимся правильно структурировать запросы и грамотно использовать возможности платформы, что делает код надежным и легко читаемым.