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

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

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

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

Проверьте, что механизм дополнительных отчетов включен

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

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

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

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

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

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

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

Проверьте, что отчет зарегистрирован корректно

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

Дополнительно проверьте видимость отчета под учетной записью рядового пользователя, а не только под администратором. Частая ситуация: администратор видит отчет, а менеджеры — нет, потому что быстрый доступ не настроен или у пользователей нет права на объекты, к которым обращается отчет.

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

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

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

Норма

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

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

Отчета нет в списке или при запуске ошибка «Объект не найден»

Формирование с параметрами

Норма

Данные выводятся, отборы работают

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

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

Видимость у пользователей

Норма

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

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

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

Что делать, если подсистемы дополнительных отчетов нет

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

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

Способы подключения внешнего отчета

Дополнительные отчеты и обработки (БСП)

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

Файл — Открыть

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

Встраивание в конфигурацию

Надежный вариант для конфигураций без БСП. Требует доработки конфигурации и усложняет последующие обновления.

Учитывайте безопасность и ограничения

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

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

Типичные ошибки при регистрации

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

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

Обновление и удаление зарегистрированного отчета

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

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

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

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

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

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

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

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

Исчезнет ли зарегистрированный отчет при обновлении конфигурации?

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

Можно ли настроить автоматическое формирование внешнего отчета по расписанию?

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

Почему при загрузке файла появляется предупреждение безопасности?

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