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

Другое · 6 мин

Добавление отчёта из расширения в 1С: порядок действий

Добавление отчёта через расширение конфигурации 1С: создание объекта отчёта, регистрация команды, проверка прав и публикация без правки базы.

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

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

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

Когда целесообразно выносить отчёт в расширение

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

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

Создание объекта отчёта в расширении

Объект отчёта и его данные

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

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

Порядок создания отчёта
  1. 1
    Создайте объект Отчёт в расширении конфигурации
  2. 2
    Определите источник данных и параметры отчёта
  3. 3
    Настройте компоновку или форму вывода результата
  4. 4
    Сохраните изменения в расширении

Форма и вывод результата

В управляемом приложении форма отчёта обычно создается на основе объекта отчёта и может использовать компоновку данных. Проверьте, что поля, которые нужно выводить, доступны в выбранном источнике.

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

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

Проверьте активность расширения и наличие команды

Команда не отображаетсяВозможно, не настроено место отображения или права

Проверьте подсистемы, роли и права доступа

Отчёт открывается, но пустИсточник данных или параметры не заданы

Проверьте набор данных и условия отбора

Регистрация команды и отображение в интерфейсе

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

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

Права доступа и публикация расширения

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

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

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

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

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

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

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

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

Отчёт открывается из меню
Норма

Форма отчёта запускается и показывает данные

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

Команда отсутствует или форма не открывается

Права доступа
Норма

Видит только круг пользователей из роли

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

Отчёт доступен всем или никому

Ограничения и альтернативы

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

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

Итог

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

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

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

Нужно ли менять базовую конфигурацию, чтобы добавить отчёт?

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

Почему отчёт не отображается после публикации расширения?

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

Может ли один отчёт работать в обычном и управляемом приложении?

Это зависит от конфигурации и способа создания формы. Иногда нужны отдельные варианты формы для разных типов клиентов, поэтому проверяйте целевое приложение заранее.

Нужно ли ограничивать доступ к отчёту?

Да, если в отчёте используются чувствительные данные. Настройте роли и права доступа, чтобы открытие отчёта было доступно только соответствующим пользователям.

Что делать, если отчёт открывается, но не показывает данные?

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