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

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

Как добавить внешний отчет в интерфейс 1С

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

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

Механизм доступен в конфигурациях на Библиотеке стандартных подсистем: «Управление торговлей 11», «ERP», «Бухгалтерия предприятия 3.0», «Зарплата и управление персоналом 3.1» и других. Логика везде одинаковая: файл загружается в справочник дополнительных отчетов, после чего ему назначаются разделы командного интерфейса, права и, при необходимости, расписание. Отличия между конфигурациями — только в расположении пункта меню.

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

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

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

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

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

Загрузка файла отчета в базу

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

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

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

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

Размещение отчета в разделах интерфейса

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

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

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

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

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

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

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

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

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

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

Типичные ошибки
01
Не включен флажок «Дополнительные отчеты и обработки» — список и команды отчетов недоступны во всей базе.
02
Не настроено «Размещение» — отчет загружен, но ни в одном разделе не появляется.
03
Неверный вид объекта в карточке — команда попадает в «Дополнительные обработки» вместо отчетов.
04
Пользователь не перезашел в базу — интерфейс не обновился, отчет «не виден».
05
Нет роли на выполнение дополнительных отчетов — команда есть, но при запуске возникает ошибка прав.
06
Отчет не заполнил СведенияОВнешнейОбработке — карточка пустая, регистрация требует ручной доработки.

Если отчет запускается, но формирует пустой результат, причина обычно не в подключении, а в самом отчете: проверьте отборы, период и права на данные (RLS может скрывать часть записей от пользователя).

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

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

Команда в разделе
Норма

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

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

Команды нет или она видна только администратору

Запуск отчета
Норма

Форма открывается, отчет формируется без ошибок прав

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

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

Корректность данных
Норма

Данные совпадают с типовым отчетом или контрольной выборкой

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

Пустой результат или явно неполные данные

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

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

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

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

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

Дополнительные отчеты и обработки

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

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

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

Расширение конфигурации

Полноценная команда в разделах, централизованное обновление. Требует навыков разработки и тестирования при обновлении платформы.

Вариант типового отчета

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

Обновление и сопровождение подключенного отчета

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

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

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

Итог

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

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

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

Загрузил отчет, но в разделе его не видно. Что проверить в первую очередь?

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

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

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

Чем отличается «Дополнительный отчет» от «Дополнительной обработки» при загрузке?

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

Отчет работал в файловой базе, а в клиент-серверной выдает ошибку. Почему?

На сервере недоступны локальные пути, диалоги выбора файлов на клиенте без передачи данных и некоторые COM-объекты. Код отчета нужно адаптировать под клиент-серверный режим: использовать передачу файлов через временное хранилище и серверные механизмы платформы.

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

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

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

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