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

← На главную

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

Основные причины отсутствия данных в отчете

Проанализируем типичные ошибки, с которыми столкнулся автор темы, чтобы вы могли их избежать в своей практике:

Неверная последовательность действий: Вывод области в документ происходит до того, как в параметры переданы реальные значения.
Вынос заполнения за пределы цикла: Метод Заполнить() или присвоение значений параметрам вызываются вне цикла Пока Выборка.Следующий() Цикл, из-за чего в документе либо пусто, либо выводится только последняя запись.
Отсутствие параметров в тексте запроса: Установка параметров УстановитьПараметр() не даст результата, если в самом тексте запроса нет соответствующих именованных параметров (обозначаются символом &).
Несоответствие имен: Имена параметров в макете 1С должны строго совпадать с именами полей (или псевдонимами) в результирующей выборке запроса.

Разбор правильного алгоритма формирования отчета

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

Представим, что мы формируем отчет по наработке оборудования. Сначала определим макет и области, а затем организуем цикл:


// Получаем макет и области
Макет = ПолучитьМакет("Макет");
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");

// Выводим шапку
ОбластьШапка.Параметры.БригадаНаим = ЭтотОбъект.Бригада;
ТабДокумент.Вывести(ОбластьШапка);

// Выполняем запрос
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Дата, Бригада, ТалевойКанат КАК Канат ИЗ Документ.НаработкаТалевогоКаната";
Выборка = Запрос.Выполнить().Выбрать();

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

Почему метод Заполнить() критически важен

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

Важно: Убедитесь, что в макете в нужных ячейках прописаны имена параметров, точно соответствующие именам колонок вашей выборки (например, если в запросе поле названо ТалевойКанат, то и в параметрах макета должно быть имя ТалевойКанат).

Советы по отладке

Если данные все равно не отображаются, воспользуйтесь следующими рекомендациями:

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

Помните, что порядок операций «Заполнение -> Вывод» — это фундамент работы с ТабличныйДокумент в 1С. Понимание этого простого правила избавит вас от множества проблем при написании отчетов любой сложности.