Работа с объектом ПостроительОтчета в 1С:Предприятии 8 — это мощный инструмент для быстрого создания гибких отчетов. Однако программисты часто сталкиваются с ситуацией, когда при использовании стандартного (автогенерируемого) макета данные выводятся корректно, а при подключении собственного макета отчет отображает только заголовок или вообще остается пустым. Проанализируем, почему это происходит, и разберем по шагам, как заставить Построитель отчета дружить с вашим дизайном.
Разберем первый и самый важный нюанс. ПостроительОтчета — это автоматизированный механизм. Когда мы передаем ему макет целиком через свойство Макет, он не «угадывает», куда выводить данные. Он ищет в этом макете области со строго определенными именами. Если вы назвали область для строк «СтрокаДанных» или «Результат», построитель ее просто проигнорирует.
Рассмотрим стандартные имена областей, которые ожидает увидеть ПостроительОтчета:
Если в вашем макете отсутствуют области с такими именами, данные не будут выведены. Выясним, как это исправить программно, если вы все же хотите использовать свои имена областей. Для этого нужно явно назначить области макета соответствующим свойствам построителя:
МойМакет = ПолучитьМакет("Макет");
Построитель = Новый ПостроительОтчета;
// ... установка источника данных и выполнение запроса ...
// Явное указание областей, если их имена в макете отличаются от стандартных
Построитель.МакетЗаголовкаОтчета = "ЗаголовокОтчета";
Построитель.МакетШапкиТаблицы = "ШапкаТаблицы";
Построитель.МакетДетальныхЗаписей = "МояСтрокаСДанными";
Проанализируем вторую распространенную ошибку. Даже если области названы правильно, ячейки внутри них могут быть настроены неверно. Посмотрим на свойства ячейки в конфигураторе 1С. У каждой ячейки есть свойство Заполнение, которое может принимать значения: Текст, Параметр или Шаблон.
Для работы с ПостроительОтчета важно соблюдать следующие правила:
Детали, в которые должны попасть данные из запроса, должны иметь тип заполнения Параметр.ЗаказПокупателя.Контрагент КАК Контрагент, то и параметр в макете должен называться Контрагент.Если вы оставите тип заполнения «Текст» и напишете внутри слово «Контрагент», построитель просто выведет это слово как обычную строку текста для каждой записи, не подставляя реальные данные из базы.
Посмотрим на последовательность действий в коде. Часто ошибка кроется в методе ОформитьМакет. Этот метод предназначен для наложения стандартного оформления (цветов, рамок, шрифтов) на макет. Если вы используете полностью ручной макет со своим дизайном, использование ОформитьМакет может «затереть» ваши настройки или даже структуру областей, если она не соответствует ожиданиям алгоритма оформления.
Правильная последовательность действий при работе с собственным макетом должна выглядеть так:
Построитель = Новый ПостроительОтчета;
Построитель.Текст = "ВЫБРАТЬ Ссылка, Дата ИЗ Документ.ЗаказПокупателя";
// 1. Выполняем запрос
Построитель.Выполнить();
// 2. Назначаем свой макет
Построитель.Макет = ПолучитьМакет("МойКрасивыйМакет");
// 3. (Опционально) Оформляем макет, если нужно применить стандартные стили 1С
// Но будьте осторожны: это может изменить ваш макет!
// Построитель.ОформитьМакет();
// 4. Выводим результат в табличный документ
Построитель.Вывести(ЭлементыФормы.ПолеТабличногоДокумента1);
Обратите внимание: если вы вызываете ОформитьМакет после назначения своего макета, построитель попытается сопоставить области вашего макета со стандартными схемами оформления. Если он не найдет нужных имен областей, оформление может не примениться или примениться некорректно.
Выясним еще одну деталь: если вы используете ОписаниеИсточникаДанных (например, на основе таблицы значений), построитель может не знать, какие поля из этого источника нужно выводить. В отличие от запроса, где поля определены в секции ВЫБРАТЬ, для внешнего источника данных нужно явно инициализировать настройки.
Добавьте в ваш код следующую строку после установки источника данных:
Построитель.ИсточникДанных = Новый ОписаниеИсточникаДанных(ТЗ_Результат);
Построитель.ЗаполнитьНастройки(); // Это заполнит список выбранных полей по умолчанию
Без вызова ЗаполнитьНастройки() коллекция Построитель.ВыбранныеПоля может оказаться пустой, и построителю будет просто «нечего» выводить в макет, даже если сам запрос вернул тысячи строк.
Рассмотрим ситуацию, когда в отчете настроены группировки (поля добавлены в ИзмеренияСтроки). В этом случае построитель перестает использовать область Детали для вывода этих полей и начинает искать области с именами этих полей.
Например, если вы группируете данные по полю Контрагент, построитель будет искать область Контрагент. Если вы хотите, чтобы данные выводились просто списком, убедитесь, что коллекция измерений строк пуста, или что в вашем макете предусмотрены области для всех уровней группировок.
Если данные все равно не выводятся, применим метод «от обратного», который часто выручает опытных разработчиков:
Проанализировав эти пять основных причин, мы видим, что ПостроительОтчета требует высокой точности в именовании объектов макета и правильной последовательности инициализации настроек. Соблюдение этих правил гарантирует корректный вывод данных в любой, даже самый сложный пользовательский макет.