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