Как создать отчет в конфигураторе 1С

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

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

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

Подготовка: что нужно проверить перед созданием отчета

Перед началом работы убедитесь, что у вас есть доступ к конфигуратору с правами на изменение конфигурации. Если база рабочая и на поддержке у поставщика, любые изменения стоит делать на копии: включение возможности изменений снимает конфигурацию с полной поддержки, что усложняет автоматическое обновление. Безопасная альтернатива — внешний отчет (файл .erf), который не трогает конфигурацию вообще.

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

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

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

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

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

Построение схемы компоновки данных и запроса

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

Простой пример запроса для отчета по продажам:

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

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

// Модуль объекта отчета: программная установка параметра, если нужно
Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
    СтандартнаяОбработка = Ложь;
    Настройки = КомпоновщикНастроек.ПолучитьНастройки();
    Параметр = Настройки.ПараметрыДанных.НайтиЗначениеПараметра(Новый ПараметрКомпоновкиДанных("НачалоПериода"));
    Если Параметр <> Неопределено Тогда
        Параметр.Значение = НачалоМесяца(ТекущаяДатаСеанса());
        Параметр.Использование = Истина;
    КонецЕсли;
    КомпоновщикНастроек.ЗагрузитьНастройки(Настройки);
КонецПроцедуры

Настройка ресурсов, группировок и отборов

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

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

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

Размещение отчета в интерфейсе и обновление конфигурации

Чтобы пользователь увидел отчет, объект нужно включить в подсистему. Откройте свойства отчета, перейдите на закладку «Подсистемы» и отметьте нужный раздел интерфейса (например, «Продажи» или «Склад»). Если подсистема настроена на вывод отчетов в панель отчетов, объект появится там автоматически.

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

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

Внешний отчет как безопасная альтернатива

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

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

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

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

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

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