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

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

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

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

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

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

Способ 1. Открыть отчет через меню «Файл — Открыть»

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

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

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

Какие права нужны для открытия файла

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

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

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

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

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

Способ 3. Запуск из конфигуратора и отладка

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

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

Запуск внешнего отчета в файловой и клиент-серверной базе

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

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

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

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

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

Норма

Появилась форма с параметрами и кнопкой «Сформировать»

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

Сообщение «Нарушение прав доступа» или «Ошибка загрузки документа»

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

Норма

Табличный документ заполнен данными за выбранный период

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

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

Доступность для пользователей

Норма

Отчет виден в разделе «Отчеты» у сотрудников с назначенными правами

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

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

Типичные ошибки при запуске и их решение

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

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

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

Частые вопросы о запуске внешних отчетов

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

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

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

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

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

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

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

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

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

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

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

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