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

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

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

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

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

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

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

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

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

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

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

Проверка файла перед подключением

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

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

Разовый запуск через меню «Файл → Открыть»

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

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

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

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

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

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

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

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

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

Настройка прав доступа и быстрый доступ

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

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

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

Как выбрать способ подключения

Отчет нужен один раз или идет проверка файла от разработчикаОткройте через «Файл → Открыть» без регистрации в базе
Отчетом регулярно пользуются несколько сотрудниковЗарегистрируйте в «Дополнительных отчетах и обработках» и настройте разделы и доступ
Отчет должен формироваться автоматически по расписаниюЗарегистрируйте в базе и настройте расписание в карточке отчета (при поддержке конфигурацией)
Отчет должен быть частью конфигурации с обновлением через релизыПередайте разработчику задачу на встраивание отчета в конфигурацию

Обновление версии, расписание и типичные ошибки

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

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

Частые ошибки при подключении: попытка загрузить файл .epf (обработку) вместо .erf; отчет зарегистрирован, но не опубликован, поэтому пользователи его не видят; отчет написан под другую конфигурацию и падает с ошибкой обращения к несуществующим объектам; у пользователя нет прав на данные, и отчет формируется пустым. Каждая из этих ситуаций диагностируется по тексту ошибки или по отсутствию отчета в интерфейсе.

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

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

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

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

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

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

Видимость отчета в интерфейсе
Норма

Отчет отображается в назначенном разделе под обычным пользователем

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

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

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

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

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

Ошибка обращения к объектам метаданных или пустой результат

Достоверность данных
Норма

Итоги совпадают со стандартными отчетами за тот же период

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

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

Итог

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

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

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

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

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

Почему пользователь не видит зарегистрированный отчет?

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

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

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

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

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

Как обновить внешний отчет до новой версии без потери настроек?

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

Отчет открывается, но выдает ошибку при формировании. Что проверить?

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