Как писать отчёты в 1С: от простого макета до СКД

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

Чтобы написать работающий отчёт, достаточно владеть тремя вещами: языком запросов 1С, базовыми настройками СКД и пониманием структуры данных конфигурации, с которой вы работаете. Углублённые навыки — программная доработка компоновки, собственные макеты, расшифровка — понадобятся только для нестандартных задач.

Ниже разобран полный цикл: от выбора способа создания отчёта до проверки корректности итогов. Материал ориентирован на управляемые формы и типовые конфигурации на платформе 8.3, но общие принципы применимы и к более ранним версиям.

Выбор способа: СКД, макет или программное формирование

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

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

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

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

Далее откройте «Основную схему компоновки данных» — именно здесь описывается, откуда отчёт берёт данные. Если отчёт внешний, создайте его через «Файл → Новый → Внешний отчёт»; структура у него та же, отличие только в способе хранения и подключения.

Написание запроса — основа отчёта

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

Несколько правил, которые сэкономят часы отладки. Во-первых, параметры периода для виртуальных таблиц передавайте через параметры виртуальной таблицы, а не через условие ГДЕ — так запрос работает заметно быстрее. Во-вторых, не выбирайте поля «на вырост»: каждое лишнее поле увеличивает время выполнения. В-третьих, соединения с таблицами, из которых не берутся поля, удаляйте — они раздувают результат.

ВЫБРАТЬ
	Продажи.Менеджер КАК Менеджер,
	Продажи.Номенклатура КАК Номенклатура,
	СУММА(Продажи.СуммаОборот) КАК Сумма
ИЗ
	РегистрНакопления.Продажи.Обороты(&НачалоПериода, &КонецПериода, , ) КАК Продажи
СГРУППИРОВАТЬ ПО
	Продажи.Менеджер,
	Продажи.Номенклатура

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

Настройка ресурсов, параметров и вариантов

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

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

1. 1
   Откройте вкладку «Настройки» схемы компоновки
2. 2
   Добавьте группировку строк (например, по контрагентам) и вложенную группировку или таблицу
3. 3
   Выберите поля, которые выводятся в колонки, и порядок сортировки
4. 4
   На вкладке «Отбор» добавьте пользовательские фильтры и включите их в «пользовательские настройки» для быстрого доступа
5. 5
   Сохраните настройки как вариант отчёта и проверьте формирование в режиме предприятия

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

Расшифровка, макеты и программная доработка

Расшифровка — переход от цифры в отчёте к детальным данным или документу — в СКД работает из коробки: достаточно, чтобы в наборе данных присутствовали поля для детализации. Для нестандартной расшифровки (например, открытие другого отчёта с отбором) используется обработчик ОбработкаРасшифровки в модуле формы отчёта.

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

Программное вмешательство оправдано, когда нужно: заполнить параметры по умолчанию из настроек пользователя, изменить текст запроса в зависимости от условий, добавить внешний набор данных. Точки входа — события модуля объекта отчёта ПриКомпоновкеРезультата и ПередЗагрузкойВариантаНаСервере.

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

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

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

Внешний отчёт или изменение конфигурации

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

При доработке типового отчёта не редактируйте его напрямую: скопируйте схему во внешний отчёт или переопределите поведение через расширение. Иначе при очередном обновлении изменения будут утеряны или заблокируют само обновление.

FAQ: частые вопросы о разработке отчётов в 1С