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