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

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

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

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

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

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

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

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

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

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

Способ 1: разовое открытие через меню «Файл»

Самый быстрый вариант — открыть файл напрямую. В клиентском приложении выберите «Файл — Открыть» (в большинстве версий платформы работает сочетание Ctrl+O), укажите файл .erf на диске и подтвердите открытие. Платформа может показать предупреждение о безопасности: «Рекомендуется обращать внимание на источник, из которого был получен данный файл». Если источник надежный, нажмите «Да».

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

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

Способ 2: регистрация через «Дополнительные отчеты и обработки»

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

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

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

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

После загрузки отчет не всегда виден пользователям — за это отвечают две настройки в карточке элемента. Гиперссылка «Размещение» определяет, в каких разделах программы (например, «Продажи», «Закупки», «Финансы») появится команда открытия отчета. Если список разделов пуст, отчет доступен только из общего списка дополнительных отчетов, и пользователи его просто не найдут.

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

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

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

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

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

Два способа подключения

Открытие через «Файл — Открыть»

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

Регистрация в «Дополнительных отчетах и обработках»

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

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

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

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

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

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

Отчет виден в разделе «Отчеты — Дополнительные»
Норма

Команда есть в списке и открывает форму отчета

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

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

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

Отчет строится, итоги сходятся со штатными данными

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

Ошибка выполнения или пустой результат — проверьте права на данные и версию файла

Доступность для других пользователей
Норма

Пользователь из быстрого доступа видит и запускает отчет

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

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

Типичные ошибки
01
Загрузка файла .epf вместо .erf: обработка регистрируется как отчет и не работает как ожидается — проверяйте расширение и вид в карточке.
02
Не включен флажок «Дополнительные отчеты и обработки»: пункт меню отсутствует, и пользователь считает, что конфигурация не поддерживает механизм.
03
Пустое размещение: отчет зарегистрирован, но нигде не отображается — откройте «Размещение» и отметьте разделы.
04
Отключенный безопасный режим для файла из ненадежного источника: код получает полный доступ к системе — включайте безопасный режим по умолчанию.
05
Старая версия файла после обновления конфигурации: отчет перестает работать из-за переименованных объектов — запросите у разработчика обновленную версию.

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

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

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

Итог

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

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

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

Отчет загружен, но не виден ни в одном разделе. Что делать?

Откройте карточку отчета в списке «Дополнительные отчеты и обработки» и проверьте гиперссылку «Размещение»: в ней должны быть отмечены разделы программы. Затем проверьте таблицу «Быстрый доступ» — добавьте туда себя или нужную группу пользователей. После записи карточки обновите интерфейс (F5) или перезайдите в программу.

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

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

Чем внешний отчет (.erf) отличается от внешней обработки (.epf)?

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

После обновления конфигурации внешний отчет выдает ошибку. Почему?

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

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

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

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

Откройте файл на копии базы или в тестовой учебной базе через «Файл — Открыть». Сформируйте отчет за несколько периодов, сравните итоги со штатными отчетами и убедитесь, что данные в базе не изменились. Только после успешной проверки регистрируйте отчет в рабочей базе.