Как добавить отчет в дополнительные отчеты в 1С

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

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

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

Что нужно проверить перед подключением отчета

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

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

Третье — права. Загружать дополнительные отчеты может пользователь с ролью «Добавление и изменение дополнительных отчетов и обработок» (обычно это администратор или специалист по внедрению). Обычные пользователи могут только запускать уже подключенные отчеты.

Как включить механизм дополнительных отчетов

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

В клиент-серверном режиме дополнительно проверьте, что на сервере не запрещено открытие внешних файлов. В некоторых организациях политика безопасности блокирует запуск внешних обработок — тогда загрузка пройдет, но отчет не откроется у пользователей. Этот вопрос согласуется с администратором сервера 1С или службой ИБ.

Как загрузить файл отчета в справочник

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

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

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

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

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

Если в отчете предусмотрены команды (например, открытие формы с вариантами настроек), они отображаются на вкладке «Команды». Для каждой команды можно настроить быстрый доступ: указать, каким пользователям или группам она будет видна сразу, а кому — только через кнопку «Еще».

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

Требования к коду внешнего отчета

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

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

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

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

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

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

Риски безопасности и когда нужен специалист

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

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

Как проверить, что отчет работает правильно

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

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

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

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

Отчет в списке раздела

Норма

Виден в подменю «Дополнительные отчеты»

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

Отсутствует — проверить размещение и роли

Формирование отчета

Норма

Строится без ошибок за тестовый период

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

Ошибка обращения к реквизитам — нужна адаптация

Сверка данных

Норма

Суммы совпадают с типовым отчетом

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

Расхождения — проверить отборы и запрос

Запуск под пользователем

Норма

Открывается и формируется

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

Нет прав или отчет не виден

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

Можно ли подключить отчет, если в конфигурации нет БСП?

Через справочник дополнительных отчетов — нет, потому что этот справочник входит в библиотеку стандартных подсистем. Альтернативы: открывать файл вручную через «Файл» → «Открыть» (работает в любой конфигурации) или попросить разработчика встроить отчет в состав конфигурации через конфигуратор.

Чем отличается файл .erf от .epf?

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

Почему при загрузке появляется ошибка «объект не является дополнительным отчетом»?

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

Обновится ли отчет автоматически при выходе новой версии файла?

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

Опасно ли отключать безопасный режим для отчета?

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

Можно ли ограничить доступ к отчету для отдельных сотрудников?

Да. Доступ регулируется ролями и профилями групп доступа: пользователь без роли на использование дополнительных отчетов не увидит объект. Дополнительно на вкладке «Команды» можно настроить быстрый доступ к конкретным командам отчета для отдельных пользователей или групп.