Как сделать отчет с макетом в 1С

Отчет с макетом в 1С — это объект конфигурации, который получает данные из информационной базы и выводит их в строго заданном формате: с заголовками, группировками, итогами и оформлением. Макет определяет, как будет выглядеть результат, а запрос или произвольный код — откуда берутся данные. Такой подход используют для печатных форм, аналитических выборок и регламентированных отчетов, где внешний вид фиксирован.

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

Ниже разобран полный цикл работы: от создания объекта «Отчет» в конфигураторе до проверки результата в режиме предприятия. Примеры приведены для типовой разработки на управляемых формах, но общая логика одинакова для большинства конфигураций на платформе 8.3.

Выбор типа макета: СКД или табличный документ

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

Табличный документ как макет выбирают, когда структура результата жестко зафиксирована: счет, акт, ТОРГ-12, внутренняя ведомость с точным расположением колонок. Здесь каждая ячейка описана в макете, а разработчик в коде последовательно выводит области — шапку, строки, подвал.

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

Создание объекта «Отчет» в конфигураторе

Откройте конфигуратор, найдите в дереве конфигурации ветку «Отчеты» и добавьте новый объект. Задайте имя без пробелов, например «ПродажиПоМенеджерам», и синоним, который увидит пользователь. На закладке «Основные» сразу можно указать основную схему компоновки данных — платформа создаст её автоматически.

Если отчет должен быть доступен пользователям, проверьте подсистемы: отметьте те разделы интерфейса, где отчет появится в панели отчетов. Также настройте права: роли, которым разрешено использование отчета. Пропуск этого шага — частая причина жалоб «отчет не виден», хотя объект создан корректно.

Для отчета на СКД дополнительный модуль обычно не нужен — платформа сама выполняет схему и выводит результат. Для отчета с ручным выводом потребуется форма отчета с реквизитом «Результат» типа «ТабличныйДокумент» и команда «Сформировать».

1. 1
   Добавьте объект «Отчет» в конфигураторе и задайте имя и синоним
2. 2
   Отметьте подсистемы, где отчет будет виден пользователям
3. 3
   Добавьте макет: основную СКД или табличный документ
4. 4
   Сформируйте запрос через конструктор и настройте ресурсы и группировки
5. 5
   Настройте области макета либо напишите код вывода в модуле
6. 6
   Назначьте права ролям и обновите конфигурацию базы данных
7. 7
   Проверьте формирование отчета в режиме предприятия под реальным пользователем

Формирование запроса к данным

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

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

Типичная ошибка — выбирать физическую таблицу регистра вместо виртуальной. Запрос выполнится, но вернет движения по документам, а не агрегированные итоги, и отчет будет содержать лишние строки и неверные суммы. Проверяйте результат запроса кнопкой с выполнением прямо в конструкторе на тестовой базе.

Настройка макета СКД

После заполнения набора данных перейдите на закладки «Ресурсы» и «Настройки». В ресурсах укажите поля, которые нужно суммировать, — например, «СуммаОборот» с выражением «Сумма(СуммаОборот)». Без ресурсов группировки не покажут итогов, и отчет превратится в плоский список.

На закладке «Настройки» конструктор предложит типовую структуру: группировку по измерениям (контрагент, менеджер, номенклатура) и выбранные поля. Добавьте отборы, которые пользователь сможет менять, и вынесите их в быстрый доступ, чтобы они появились прямо на форме отчета.

Если нужен собственный внешний вид — заголовки с объединенными ячейками, цветовое оформление, фиксированная шапка — создайте макет оформления компоновки данных через кнопку «Макеты» в схеме. В нем определяют области заголовка, группировки и подвала, а СКД подставит данные в указанные параметры.

Программный вывод в табличный документ

Для отчета с макетом типа «Табличный документ» логика другая. В макете создайте именованные области: «Шапка», «Строка», «Подвал». В ячейках строки разместите параметры — текст в квадратных скобках, например [Номенклатура] и [Сумма], или задайте заполнение «Параметр» в свойствах ячейки.

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

Макет = ПолучитьМакет("МакетОтчета");
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
Результат.Вывести(ОбластьШапка);
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
    ОбластьСтрока.Параметры.Заполнить(Выборка);
    Результат.Вывести(ОбластьСтрока);
КонецЦикла;

Для группировок используйте обход выборки по группировкам и методы НачатьГруппуСтрок/ЗакончитьГруппуСтрок — тогда пользователь сможет сворачивать уровни в готовом документе. Итоги по группе берите из выборки верхнего уровня, а не суммируйте вручную, чтобы избежать расхождений при отборах в запросе.

Проверка результата и типичные проблемы

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

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

Когда задачу лучше поручить специалисту

Самостоятельная разработка оправдана для внутренних аналитических отчетов на копии базы. Но есть ситуации, где ошибка дороже времени специалиста: отчеты для регламентированной отчетности, доработки типовой конфигурации на поддержке, сложные запросы с соединением нескольких регистров и расчетом себестоимости.

Особая зона риска — изменение типовых объектов. Любая правка типового отчета усложняет обновление конфигурации. Безопасная альтернатива — внешний отчет, который подключается через механизм дополнительных отчетов и обработок и не трогает основную конфигурацию.

Частые вопросы