Отчеты и Аналитика · 13 мин
Как вывести заголовок в отчете СКД 1С
Как вывести заголовок в отчете СКД 1С: параметр «Заголовок» в настройках, вывод через макет, программное изменение заголовка и типичные ошибки при настройке.
Заголовок отчета в системе компоновки данных (СКД) 1С — это не просто надпись на форме, а полноценный элемент вывода, который управляется параметрами вывода настроек отчета. Многие разработчики и пользователи сталкиваются с ситуацией, когда заголовок не отображается, выводится с устаревшим текстом или не соответствует выбранному варианту отчета. Причина почти всегда кроется в настройках параметра «Заголовок» или в способе формирования результата.
В СКД заголовок можно вывести тремя основными способами: через стандартный параметр вывода «Заголовок» в настройках варианта отчета, через собственный макет оформления с областью заголовка и программно — через модуль объекта отчета или форму. Выбор способа зависит от того, нужен ли статичный текст, динамический заголовок с периодом и отборами или сложное оформление с логотипом и реквизитами организации.
Ниже разобраны все три подхода с конкретными действиями в конфигураторе и в пользовательском режиме, особенности динамических заголовков, типичные ошибки и способы проверки результата. Материал применим к управляемым формам типовых и самописных конфигураций на платформе 8.3.
Где в СКД хранится и управляется заголовок отчета
В системе компоновки данных заголовок относится к параметрам вывода — это служебные параметры, которые существуют в любых настройках компоновщика, даже если вы их явно не добавляли. Ключевые из них: «Заголовок» (сам текст) и «Выводить заголовок» (признак вывода, принимающий значения «Авто», «Выводить» и «Не выводить»).
Значение «Авто» для параметра «Выводить заголовок» означает, что заголовок будет показан в режиме предприятия, если он заполнен, но может скрываться в некоторых контекстах — например, при выводе отчета внутрь другого отчета или при программной компоновке с собственными настройками. Значение «Выводить» принудительно включает отображение, «Не выводить» — полностью отключает.
Важно понимать иерархию: параметры вывода можно задавать на уровне всего отчета, на уровне группировок, таблиц, диаграмм и отдельных элементов структуры. Заголовок, заданный на верхнем уровне настроек, выводится один раз в начале результата. Заголовок, заданный у группировки, будет выводиться перед каждой группой — это удобно для подзаголовков разделов.
Как вывести заголовок через настройки варианта отчета
Самый простой способ — заполнить заголовок в пользовательском режиме без изменения конфигурации. Откройте отчет, перейдите в меню «Ещё» и выберите «Изменить вариант» (в некоторых конфигурациях — «Настройки» с последующим переходом к расширенным настройкам). В окне настроек варианта откройте вкладку или раздел «Дополнительные настройки» (в конфигураторе это окно «Дополнительные настройки» закладки «Настройки» схемы компоновки).
В списке параметров вывода найдите строку «Заголовок» и введите нужный текст, например «Продажи по менеджерам за месяц». Рядом проверьте параметр «Выводить заголовок»: если он установлен в «Не выводить», текст не появится в результате, даже если поле заполнено. Сохраните вариант и сформируйте отчет заново — заголовок появится в верхней части табличного документа.
В конфигураторе тот же путь выглядит так: открыть отчет → закладка «Основная схема компоновки данных» → закладка «Настройки» → кнопка открытия дополнительных настроек (окно с закладками «Параметры вывода», «Оформление» и др.). На закладке «Параметры вывода» найдите «Заголовок» и задайте значение. Этот заголовок станет заголовком варианта по умолчанию, который увидят все пользователи, не переопределяющие настройки.
- 1Откройте отчет и нажмите «Ещё → Изменить вариант»
- 2Перейдите к дополнительным настройкам варианта
- 3Найдите параметр вывода «Заголовок» и введите текст
- 4Установите «Выводить заголовок» в значение «Авто» или «Выводить»
- 5Нажмите «Завершить редактирование» и сформируйте отчет
- 6Проверьте, что заголовок появился в начале табличного документа
Как сделать динамический заголовок с периодом и отборами
Статичный текст неудобен, когда отчет формируют за разные периоды: пользователь выбрал квартал, а в заголовке написано «за месяц». СКД позволяет выводить параметры данных и отборы прямо в результате отчета рядом с заголовком — для этого служат параметры вывода «Выводить параметры» и «Выводить отбор». Установите их в «Выводить», и под заголовком появятся строки с фактическими значениями периода и наложенных отборов.
Если нужен именно составной заголовок вида «Продажи с 01.01 по 31.03», текст придется формировать программно. В модуле объекта отчета используется обработчик ПриКомпоновкеРезультата, где перед вызовом компоновщика можно прочитать значения параметров из настроек и подставить их в параметр вывода «Заголовок».
Примерная логика такова: получить из настроек компоновки значение параметра периода, сформировать строку представления, найти в параметрах вывода элемент «Заголовок» и присвоить ему новое значение. После этого стандартный механизм выведет заголовок уже с актуальными датами.
Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
Настройки = КомпоновщикНастроек.ПолучитьНастройки();
ПараметрПериод = Настройки.ПараметрыДанных.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("Период"));
ЗаголовокОтчета = "Продажи за период: " + Строка(ПараметрПериод.Значение);
ПараметрЗаголовок = Настройки.ПараметрыВывода.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("Заголовок"));
ПараметрЗаголовок.Значение = ЗаголовокОтчета;
ПараметрЗаголовок.Использование = Истина;
КонецПроцедурыУчтите ограничение: если отчет формируется через стандартную форму отчета БСП (библиотека стандартных подсистем), код в модуле объекта выполняется, но менять настройки нужно именно в тот экземпляр настроек, который уйдет в компоновщик. В сложных случаях проще переопределить заголовок в обработчике формы «ПриСозданииНаСервере» или через описание варианта в модуле менеджера отчета.
Вывод заголовка через макет оформления
Когда стандартного текстового заголовка недостаточно — нужен логотип, реквизиты организации, рамка или многострочная шапка — используется макет оформления компоновки данных. В схеме компоновки на закладке «Макеты» создайте макет оформления и определите в нем область типа «Заголовок». В ячейках области разместите текст, поля с параметрами и оформление.
После создания макета его нужно подключить: в параметрах вывода настроек установите параметр «Макет оформления» в имя созданного макета. Компоновщик начнет использовать вашу область заголовка вместо стандартной. Внутри макета можно ссылаться на параметры данных отчета — например, вывести период или наименование организации из параметра.
Макетный подход требует аккуратности: при изменении структуры отчета или состава параметров макет может потребовать корректировки. Кроме того, собственный макет оформления заменяет стандартное оформление целиком для соответствующих областей, поэтому стилистику остальных областей (итогов, группировок) при необходимости придется задавать отдельно.
Программная установка заголовка и работа с формой отчета
Если отчет открывается программно — из команды, обработки или другого отчета — заголовок удобно задавать в момент формирования. Для отчета, выводимого в табличный документ напрямую, можно после вывода результата вставить область заголовка в начало документа методом ВставитьОбласть, но корректнее по-прежнему использовать параметр вывода «Заголовок», чтобы текст участвовал в стандартной компоновке.
Для формы отчета на управляемых формах заголовок окна и заголовок в табличном документе — разные вещи. Заголовок окна формы меняется через свойство формы «Заголовок» или через представление варианта в настройках. Заголовок внутри результата отчета управляется только параметрами вывода СКД. Частая путаница возникает, когда пользователь видит правильное название в шапке окна, но в печатной форме его нет — значит, заполнено представление варианта, но не параметр вывода.
При переименовании варианта отчета в пользовательском режиме типовые механизмы БСП обычно синхронизируют представление варианта и заголовок вывода, но это поведение зависит от конфигурации. Если после переименования варианта заголовок в результате не изменился — откройте дополнительные настройки и проверьте параметр «Заголовок» вручную.
Способы вывода заголовка
Подходит для статичного текста и простых случаев; настраивается пользователем без изменения конфигурации. Ограничение — только текст, без сложного оформления.
Подходит для динамических заголовков с периодом и отборами. Требует доработки модуля отчета и аккуратной работы с настройками.
Подходит для шапки с логотипом, реквизитами и многострочным оформлением. Требует сопровождения макета при изменении отчета.
Типичные ошибки и их устранение
Самая распространенная проблема — заголовок заполнен, но не выводится. Проверьте параметр «Выводить заголовок»: значение «Не выводить» полностью отключает отображение. Вторая причина — заголовок задан в настройках по умолчанию схемы, а пользователь формирует сохраненный вариант, где параметр пустой или отключен. Настройки варианта имеют приоритет над настройками по умолчанию.
Еще одна ситуация: заголовок появляется в режиме предприятия, но пропадает при программном формировании из обработки. Это происходит, когда код формирует собственные настройки компоновщика с нуля, не подтягивая настройки варианта. Решение — загружать настройки из схемы или явно устанавливать параметры вывода в коде.
Также встречается обратная проблема: заголовок дублируется. Обычно это следствие того, что заголовок задан и на уровне отчета, и в макете оформления, либо текст добавлен и через параметр вывода, и вручную в табличный документ после компоновки. Уберите один из источников.
Как проверить результат
После настройки сформируйте отчет и проверьте начало табличного документа: заголовок должен располагаться в первых строках, до таблицы данных. Измените период или отбор и сформируйте повторно — для динамических заголовков текст должен обновиться, для статичных — остаться прежним.
Дополнительно проверьте вывод при печати и сохранении в файл: откройте предварительный просмотр печати табличного документа. Заголовок, выведенный через параметры СКД, попадает в печатную форму автоматически. Если заголовок виден на экране, но не попадает на печать, вероятно, он добавлен не в результат компоновки, а в элементы формы.
Как проверить результат
Заголовок выведен в первых строках результата
Таблица данных начинается сразу, заголовка нет
Динамический заголовок обновляется, статичный сохраняется
Текст устарел или исчез после смены настроек
Заголовок присутствует в печатной форме
На экране есть, на печати отсутствует
Каждый вариант выводит свой заголовок
Во всех вариантах один и тот же или пустой заголовок
Если отчет используется в рассылках и регламентных заданиях, проверьте заголовок и там: при фоновом формировании применяются сохраненные настройки варианта, поэтому заголовок должен быть заполнен именно в том варианте, который указан в настройках рассылки.
Что важно запомнить
Заголовок отчета СКД управляется параметрами вывода «Заголовок» и «Выводить заголовок» в настройках варианта. Для динамического текста используйте обработчик ПриКомпоновкеРезультата, для сложного оформления — макет оформления. Если заголовок не выводится, в первую очередь проверяйте признак «Выводить заголовок» и то, какой вариант настроек реально используется при формировании.
Частые вопросы
Почему заголовок заполнен, но не отображается в отчете?
Чаще всего параметр «Выводить заголовок» установлен в «Не выводить» — текст при этом сохраняется, но не показывается. Также проверьте, какой вариант отчета формируется: заголовок мог быть задан в настройках по умолчанию, а вы используете сохраненный вариант с пустым параметром. Откройте дополнительные настройки текущего варианта и проверьте оба параметра.
Можно ли вывести в заголовке период отчета автоматически?
Да, двумя способами. Простой — включить параметры вывода «Выводить параметры» и «Выводить отбор», тогда значения периода появятся под заголовком отдельными строками. Если нужен составной текст вида «Отчет за период с ... по ...», формируйте строку программно в обработчике ПриКомпоновкеРезультата, считывая значения параметров из настроек компоновки.
Чем отличается заголовок варианта отчета от заголовка в результате?
Заголовок (представление) варианта отображается в шапке окна формы и в списке вариантов, но в табличный документ не попадает сам по себе. Заголовок в результате — это параметр вывода СКД, который выводится в начало табличного документа и попадает в печатную форму. Для печатных документов заполнять нужно именно параметр вывода.
Как вывести разные заголовки для разных вариантов одного отчета?
Заголовок хранится в настройках каждого варианта отдельно. Откройте нужный вариант через «Ещё → Изменить вариант», задайте свой текст в параметре «Заголовок» и сохраните вариант. Повторите для остальных вариантов — при переключении между ними каждый будет выводить собственный заголовок.
Заголовок дублируется дважды в начале отчета — в чем причина?
Дублирование возникает, когда заголовок задан одновременно в параметре вывода и в макете оформления, либо когда текст дополнительно вставлен в табличный документ программно после компоновки. Определите, какой источник лишний: временно очистите параметр «Заголовок» — если одна строка осталась, она идет из макета или кода. Оставьте один способ вывода.
Можно ли оформить заголовок шрифтом и цветом без макета?
Стандартный параметр вывода «Заголовок» использует оформление текущего макета оформления (стандартного или выбранного в параметре «Макет оформления»), и отдельно настроить шрифт только заголовка через настройки нельзя. Для индивидуального оформления создайте собственный макет оформления с областью заголовка, где доступны шрифт, цвет, рамки и выравнивание ячеек.