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

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

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

Что понадобится перед подключением

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

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

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

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

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

Пошаговая загрузка отчета в базу

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

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

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

Назначение отчета конкретному виду документов

Ключевой шаг — таблица «Принадлежность» (в некоторых версиях — «Назначение») в карточке дополнительного отчета. Добавьте в нее строку и выберите вид объекта, например «Документ РеализацияТоваровУслуг». Можно указать несколько видов документов и справочников, если отчет универсален.

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

Если отчет не содержит сведений о назначении

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

Проверка результата в форме документа

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

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

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

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

Команда в форме документа

Норма

Новая команда видна в меню «Печать» или «Отчеты»

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

Команды нет — проверьте таблицу назначения и вид обработки

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

Норма

Отчет строится без ошибок, данные соответствуют документу

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

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

Права пользователей

Норма

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

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

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

Настройка доступа для пользователей

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

В карточке также можно задать расписание для регламентного выполнения (если вид обработки это поддерживает) и параметры запуска. Для отчета по документу это обычно не требуется — достаточно ручного запуска из формы.

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

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

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

Альтернативные способы и их ограничения

Способы использования внешнего отчета

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

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

Открытие файла вручную (Файл → Открыть)

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

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

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

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

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

Нужно ли снимать конфигурацию с поддержки для подключения внешнего отчета?

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

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

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

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

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

Что делать, если при загрузке появляется ошибка «метод не обнаружен»?

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

Не пропадет ли отчет после обновления конфигурации?

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

Безопасно ли загружать внешние отчеты из интернета?

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