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

Отчеты и Аналитика · 11 мин

Как установить внешний отчет в 1С

Как установить внешний отчет в 1С: подключение через «Дополнительные отчеты и обработки», открытие ERF-файла, настройка прав и решение типичных ошибок.

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

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

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

Что такое внешний отчет и когда он нужен

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

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

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

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

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

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

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

Быстрый запуск через меню «Файл → Открыть»

Самый простой способ посмотреть, что делает отчет, — открыть его напрямую. В клиентском приложении 1С выберите «Файл → Открыть» (или нажмите Ctrl+O), укажите путь к ERF-файлу и подтвердите открытие. Платформа загрузит отчет и покажет его форму, как если бы это был встроенный отчет конфигурации.

При первом открытии файла с диска платформа может показать предупреждение системы защиты от опасных действий. Это нормальное поведение: 1С сообщает, что файл содержит исполняемый код. Если источник файла надежен, подтвердите открытие. Если предупреждение появилось для файла, который вы не ожидали запускать, — откажитесь и проверьте, что именно вы открываете.

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

Установка через «Дополнительные отчеты и обработки»

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

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

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

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

Установка в 1С:Фреш и веб-клиенте

В облачном сервисе 1С:Фреш действуют ограничения безопасности: произвольные внешние отчеты загружать нельзя. Допускаются только расширения и дополнительные отчеты, прошедшие проверку и опубликованные в сервисе 1С:Бухобслуживание или в магазине расширений. Установка выполняется через раздел «Еще → Дополнительные отчеты и обработки» с выбором из доступного каталога, а не загрузкой произвольного файла.

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

Обновление, отключение и удаление отчета

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

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

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

Типичные ошибки и их решение

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

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

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

Типичные ошибки
01
Установка одного и того же отчета несколькими карточками — в списке появляются дубли, и непонятно, какая версия актуальна
02
Отсутствие настройки размещения — отчет записан, но не виден ни в одном разделе программы
03
Использование отчета, написанного под другую конфигурацию, — ошибки при запуске или пустые данные
04
Игнорирование предупреждения защиты от опасных действий для файлов из непроверенных источников — риск выполнения вредоносного кода
Контрольные точки

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

Карточка отчета в справочнике
Норма

Элемент записан, имя и версия заполнены, размещение указано

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

Карточка не сохраняется или поля пустые

Видимость в разделе
Норма

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

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

Отчет виден только администратору или не виден никому

Запуск и формирование
Норма

Отчет открывается и строится без сообщений об ошибках

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

Ошибка компиляции, обращение к несуществующим объектам

Корректность данных
Норма

Цифры сходятся с типовыми отчетами за тот же период

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

Суммы расходятся с учетными данными без объяснимых причин

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

Можно ли установить внешний отчет без прав администратора?

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

Чем отличается файл ERF от EPF?

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

Нарушит ли внешний отчет поддержку и обновление конфигурации?

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

Почему отчет открывается через «Файл → Открыть», но не добавляется в справочник?

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

Как установить отчет сразу для всех пользователей?

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

Что делать, если после обновления конфигурации отчет перестал работать?

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

Итог

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

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