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

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

Внешний отчёт в 1С: что это и как с ним работать

Что такое внешний отчёт в 1С, чем он отличается от встроенного, как подключить файл .erf в конфигурацию, типичные ошибки и проверка результата.

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

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

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

Что такое внешний отчёт и как он устроен

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

Чаще всего внешний отчёт строится на системе компоновки данных: разработчик описывает запрос к данным, наборы полей, ресурсы и настройки группировок, а пользователь уже в режиме предприятия меняет отборы, период и варианты отчёта без программирования. Это делает внешние отчёты удобным инструментом аналитики «под заказ».

Рядом с внешними отчётами существуют внешние обработки — файлы .epf. Разница в назначении: отчёт предназначен для вывода информации, а обработка — для выполнения действий над данными (загрузка, изменение, перенос). Формат хранения и способы подключения у них одинаковые, поэтому в интерфейсе они часто упоминаются вместе.

Чем внешний отчёт отличается от встроенного

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

Внешний и встроенный отчёт

Встроенный отчёт

Хранится в конфигурации, обновляется с релизом, требует доработки для изменения. Подходит для постоянной типовой аналитики.

Внешний отчёт

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

Дополнительный отчёт через БСП

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

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

Когда стоит использовать внешний отчёт

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

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

Маршрут решения

Как выбрать формат отчёта

Отчёт нужен один-два раза или на время проектаИспользуйте внешний файл .erf без подключения в справочник
Отчёт нужен постоянно нескольким пользователямПодключите его через «Дополнительные отчеты и обработки» с настройкой прав
Отчёт станет частью типовой логики и будет дорабатыватьсяПеренесите его в конфигурацию как встроенный объект
Конфигурация на полной поддержке и снимать её нельзяТолько внешний отчёт — встроенный потребует снятия с поддержки

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

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

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

Для постоянной работы в конфигурациях на базе Библиотеки стандартных подсистем (УТ, КА, ERP, Бухгалтерия, ЗУП и другие) используется механизм дополнительных отчётов и обработок. Он регистрирует файл в специальном справочнике, после чего отчёт появляется в разделе «Дополнительные отчеты» и работает как штатный — с настройкой прав доступа, размещением в разделах и даже расписанием выполнения.

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

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

Безопасность: что проверить перед запуском чужого файла

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

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

Дополнительный уровень защиты — профили безопасности в кластере серверов 1С и запрет на использование внешних отчётов для отдельных ролей. В крупных внедрениях право подключения внешних файлов выдают только администраторам и доверенным разработчикам.

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

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

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

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

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

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

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

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

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

Виден пользователям с нужными правами, запускается из интерфейса

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

Виден только администратору или отсутствует в списке

Контрольные итоги
Норма

Суммы совпадают с типовым отчётом за тот же период (например, с оборотно-сальдовой ведомостью)

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

Расхождения без объяснимой причины в настройках отборов

Время формирования
Норма

Отчёт формируется за приемлемое время без ошибок СУБД

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

Формирование зависает, в журнале регистрации ошибки превышения времени ожидания

Права доступа
Норма

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

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

В отчёте отображаются данные, закрытые для пользователя в типовых отчётах

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

Часто задаваемые вопросы

Можно ли открыть внешний отчёт без конфигуратора?

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

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

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

Почему внешний отчёт не открывается с ошибкой формата?

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

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

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

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

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

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

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

Итог

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

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