Как встроить внешний отчет в 1С: пошаговая инструкция

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

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

Ниже разобраны оба сценария с точными действиями, проверками результата и типичными ошибками. Инструкции применимы к конфигурациям на платформе 1С:Предприятие 8.3 с библиотекой стандартных подсистем (БСП), где механизм дополнительных отчетов встроен изначально.

Какой способ встраивания выбрать

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

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

Сравнение вариантов

Дополнительные отчеты и обработки

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

Встраивание через конфигуратор

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

Простое открытие файла

Файл → Открыть. Годится для разового запуска и тестирования. Отчет не регистрируется, не попадает в интерфейс и не имеет настроек прав.

Подготовка: проверка файла отчета и прав доступа

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

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

Способ 1: подключение через «Дополнительные отчеты и обработки»

Это основной сценарий для типовых конфигураций: «1С:Бухгалтерия», «1С:Управление торговлей», «1С:ERP», «1С:Зарплата и управление персоналом» и других решений на БСП.

Сначала включите сам механизм. Перейдите в раздел «Администрирование → Печатные формы, отчеты и обработки» и установите флаг «Дополнительные отчеты и обработки». После этого в том же разделе появится ссылка «Дополнительные отчеты и обработки» — по ней открывается справочник подключенных объектов.

Нажмите «Добавить из файла» (или «Загрузить из файла») и выберите файл .erf. Программа прочитает сведения из модуля отчета: наименование, версию, безопасный режим, вид дополнительного отчета. Если отчет написан по стандарту БСП и содержит функцию СведенияОВнешнейОбработке(), регистрация пройдет автоматически. Если такой функции нет, часть параметров придется заполнить вручную.

1. 1
   Включите опцию «Дополнительные отчеты и обработки» в разделе «Администрирование → Печатные формы, отчеты и обработки»
2. 2
   Откройте справочник «Дополнительные отчеты и обработки» и нажмите «Добавить из файла»
3. 3
   Выберите файл .erf и проверьте автоматически заполненные сведения
4. 4
   На закладке размещения укажите разделы, где отчет будет виден пользователям
5. 5
   Запишите элемент и откройте отчет из раздела «Отчеты → Дополнительные отчеты» для проверки

Настройка размещения и быстрого доступа

После регистрации откройте карточку отчета и настройте размещение: укажите разделы командного интерфейса, в которых отчет должен отображаться. Затем перейдите в «Отчеты → Дополнительные отчеты», найдите подключенный отчет и добавьте его в «Избранное» или настройте варианты отчета для пользователей.

Безопасный режим

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

Способ 2: встраивание отчета в конфигуратор

Этот способ применяется, когда отчет должен стать постоянной частью конфигурации. Откройте конфигуратор и убедитесь, что конфигурация доступна для изменений: «Конфигурация → Поддержка → Настройка поддержки» — включите возможность изменения, если конфигурация типовая.

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

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

Связь внешнего отчета с дополнительными свойствами БСП

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

Минимальный шаблон функции выглядит так:

Функция СведенияОВнешнейОбработке() Экспорт
ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке();
ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительныйОтчет();
ПараметрыРегистрации.Версия = "1.0";
ПараметрыРегистрации.БезопасныйРежим = Истина;
Возврат ПараметрыРегистрации;
КонецФункции

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

Управление доступом пользователей к отчету

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

Для отчета, встроенного в конфигуратор, доступ регулируется стандартно — через роли. В свойствах роли найдите отчет в дереве объектов и установите права «Использование» и «Просмотр». Пользователь без этих прав просто не увидит отчет в интерфейсе.

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

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

Отчет в списке дополнительных отчетов

Норма

Элемент записан, команда открытия выполняется без ошибок

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

Ошибка при открытии или пустой список команд

Отображение в интерфейсе

Норма

Отчет виден в указанных разделах у пользователей с нужными правами

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

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

Формирование данных

Норма

Отчет строится и показывает актуальные данные базы

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

Ошибки обращения к объектам метаданных или пустой результат

Типичные ошибки при встраивании

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

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

FAQ по подключению внешних отчетов

Можно ли подключить внешний отчет, не нарушая поддержку типовой конфигурации?

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

Чем внешний отчет отличается от внешней обработки?

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

Почему подключенный отчет не виден пользователям?

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

Что делать, если отчет требует отключения безопасного режима?

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

Как обновить подключенный внешний отчет на новую версию?

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