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

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

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

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

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

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

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

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

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

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

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

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

Постоянная регистрация в справочнике дополнительных отчетов

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

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

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

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

Настройка размещения и прав доступа

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

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

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

Подключение дополнительных печатных форм к документам

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

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

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

Проверка результата и типичные ошибки

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

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

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

Отчет в разделе программы

Норма

Отчет виден в пункте «Дополнительные отчеты» выбранного раздела

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

Отчета нет в списке — проверьте размещение и права

Запуск и формирование

Норма

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

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

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

Печатная форма в документе

Норма

Новая форма присутствует в меню «Печать» документа

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

Формы нет — проверьте таблицу «Принадлежность» в карточке

Обновление версии отчета и безопасность

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

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

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

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

Программа пишет, что файл не содержит сведений о внешней обработке. Что делать?

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

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

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

Можно ли подключить внешний отчет в 1С:Бухгалтерии в облаке?

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

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

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

Как удалить ранее подключенный внешний отчет?

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

Безопасно ли отключать безопасный режим у обработки?

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