Как подключить внешний отчет в 1С 8.3

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Быстрое открытие файла без регистрации

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

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

Настройка размещения, прав и вариантов отчета

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

• Размещение — разделы командного интерфейса (Продажи, Закупки, Склад и т.д.), где появится команда запуска;
• Быстрый доступ — список пользователей или групп, которым отчет виден в разделах; остальные его не увидят;
• Команды — варианты запуска: открытие формы, вызов из формы списка или документа (для контекстных отчетов).

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

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

Варианты отчета (преднастроенные комбинации отборов и группировок) сохраняются штатно в хранилище вариантов, если отчет зарегистрирован через справочник. Пользователи могут создавать свои варианты через «Ещё → Сохранить вариант отчета» и делиться ими.

Ошибки при подключении и их устранение

Наиболее частая проблема — сообщение о невозможности подключения из-за безопасного режима. Оно возникает, если в настройках базы или кластера запрещено выполнение внешнего кода. Решение — снять флаг «Безопасный режим» в карточке отчета (если источник файла проверен) или согласовать профиль безопасности с администратором сервера.

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

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

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

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

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

Команда в интерфейсе

Норма

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

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

Команда есть только у администратора — не заполнен быстрый доступ

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

Норма

Отчет строится без ошибок за разные периоды

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

Ошибка СКД или пустой результат при наличии данных

Итоги

Норма

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

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

Расхождения — проблема в запросе, вернуть разработчику

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

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

Чем внешний отчет отличается от расширения конфигурации?

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

Можно ли подключить внешний отчет в 1С:Фреш (облако)?

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

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

Чаще всего дело в правах на данные: запрос отчета обращается к регистрам или справочникам, на чтение которых у роли пользователя нет прав. Администратор видит все, поэтому ошибка не проявляется. Решение — выдать пользователю недостающие права или попросить разработчика перестроить запрос только по доступным объектам.

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

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

Можно ли подключить внешний отчет в обычном приложении (толстый клиент)?

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

Сохранятся ли настройки отчета при обновлении конфигурации?

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