К статье
Практический материал

Другое · 9 мин

Создание отчёта в 1С:Конфигураторе

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

Создание отчёта в 1С:Конфигураторе начинается с добавления конфигурационного объекта типа «Отчёт» и определения способа получения данных. В управляемых приложениях чаще всего используется схема компоновки данных, которая отделяет набор данных от оформления и позволяет настраивать группировку, отбор и параметры без программирования модуля. В обычных приложениях отчёт оформляется через модуль отчёта и макет, что требует более прямого управления выводом.

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

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

Готовый отчёт обязательно компилируется, проверяется на синтаксис и запускается из пользовательского режима. Отсутствие в меню или пустой результат чаще всего говорит о проблеме с командным интерфейсом, набором данных или правами, а не об ошибке алгоритма.

Подготовка и выбор способа создания отчёта

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

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

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

В Конфигураторе откройте дерево конфигурации, найдите раздел «Отчёты» и создайте новый объект. Укажите имя, синоним и, при необходимости, комментарий. Имя используется в программном коде, а синоним отображается пользователям. Для управляемого приложения укажите использование схемы компоновки данных, если это предполагается.

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

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

Настройка схемы компоновки данных и наборов данных

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

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

Оформление макета и параметров отчёта

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

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

Вывод отчёта в командный интерфейс и права доступа

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

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

Типичные ошибки
01
Отсутствие команды интерфейса делает отчёт невидимым для пользователя.
02
Права на команду есть, а права на данные нет — отчёт возвращает пустой результат.
03
Правка стандартной конфигурации в режиме поддержки блокирует изменения или откатывает их.

Проверка, типичные ошибки и ограничения

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

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

Контрольные точки

Как проверить результат

Отчёт появился в нужном разделе меню
Норма

Кнопка или пункт доступен под нужной ролью

Тревожный признак

Команда отсутствует или недоступна

Результат не пуст при заполненных фильтрах
Норма

Данные совпадают с исходными регистрами

Тревожный признак

Пустой отчёт или ошибка доступа

Отчёт работает после изменения параметров
Норма

Фильтры влияют на выборку

Тревожный признак

Параметры игнорируются

Когда самостоятельная правка недопустима

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

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

Итог

Что важно запомнить

Отчёт создаётся в Конфигураторе, настраивается схема или макет, добавляется команда и проверяется под правами пользователя; стандартные конфигурации править через копию или расширение.

Как сделать отчёт видимым в меню пользователя?

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

Почему отчёт открывается, но не показывает данные?

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

Можно ли редактировать стандартный отчёт конфигурации?

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

В чем разница между отчётом и обработкой?

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

Что делать, если Конфигуратор не позволяет сохранить изменения?

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