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

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

Как загрузить внешнюю форму отчета в 1С

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

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

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

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

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

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

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

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

Какие права и настройки нужны перед загрузкой

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

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

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

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

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

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

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

Способ 2. Регистрация в справочнике дополнительных отчетов

Постоянное подключение делается через раздел «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». Нажмите «Создать» или «Добавить из файла», выберите .erf-файл. Если файл корректный, конфигурация прочитает из него сведения о регистрации: наименование, версию, вид объекта, безопасный режим, команды.

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

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

Сравнение вариантов подключения

Разовое открытие (Ctrl+O)

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

Регистрация в справочнике

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

Расширение конфигурации

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

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

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

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

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

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

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

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

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

Отчета нет в разделе — проверьте настройку «Размещение» и права

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

Отчет формируется без ошибок за тестовый период

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

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

Доступ пользователей
Норма

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

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

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

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

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

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

Типичные ошибки
01
Загрузка файла .epf вместо .erf — внешняя обработка не откроется как отчет; проверьте расширение и назначение файла
02
Регистрация без настройки размещения — отчет есть в справочнике, но пользователи его не видят в разделах
03
Загрузка отчета, написанного под другую конфигурацию — ошибки при формировании из-за отсутствующих объектов метаданных
04
Работа с внешним отчетом только через Ctrl+O при регулярной потребности — трата времени и риск открыть устаревшую копию файла

Ограничения и безопасная практика

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

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

Итог

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

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

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

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

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

Почему справочник «Дополнительные отчеты и обработки» не открывается?

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

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

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

Отчет зарегистрирован, но пользователи его не видят. Что делать?

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

Безопасно ли открывать внешний отчет, присланный по почте?

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

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

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