Отчеты и Аналитика · 11 мин
Как добавить внешний отчет в интерфейс 1С
Как добавить внешний отчет в интерфейс 1С: подключение через дополнительные отчеты и обработки, настройка размещения в разделах, права доступа и типичные ошибки.
Внешний отчет в 1С — это файл с расширением .erf, который формирует печатные формы, аналитические выборки или сводки, не входящие в типовую конфигурацию. Чтобы пользователи могли запускать такой отчет как обычный — из раздела программы, а не через «Файл → Открыть», его нужно зарегистрировать в подсистеме «Дополнительные отчеты и обработки» и разместить в нужных разделах интерфейса.
Механизм доступен в конфигурациях на Библиотеке стандартных подсистем: «Управление торговлей 11», «ERP», «Бухгалтерия предприятия 3.0», «Зарплата и управление персоналом 3.1» и других. Логика везде одинаковая: файл загружается в справочник дополнительных отчетов, после чего ему назначаются разделы командного интерфейса, права и, при необходимости, расписание. Отличия между конфигурациями — только в расположении пункта меню.
Ниже разобран полный цикл: от проверки готовности базы до проверки, что отчет виден пользователю в нужном разделе, а также типичные ошибки, из-за которых отчет «пропадает» из интерфейса или не запускается.
Проверка предварительных условий перед подключением
Прежде чем загружать файл, убедитесь, что в базе включен сам механизм дополнительных отчетов и обработок. Откройте «Администрирование → Печатные формы, отчеты и обработки» и проверьте флажок «Дополнительные отчеты и обработки». Если флажок снят, пункт «Дополнительные отчеты» в разделах просто не появится, и загрузка будет бессмысленной.
Второе условие — права. Подключать внешние отчеты может пользователь с ролью администратора или с правом «Добавление и изменение дополнительных отчетов и обработок». Обычный пользователь без этих прав увидит пункт меню, но кнопка «Добавить из файла» будет недоступна.
Третий момент — безопасность. В файловых базах и при работе через тонкий клиент программа может запросить подтверждение открытия файла, поскольку внешний отчет содержит исполняемый код. В некоторых базах включен «безопасный режим» или профиль безопасности, ограничивающий выполнение внешних компонентов. Если отчет получен из недоверенного источника, его код стоит предварительно просмотреть в конфигураторе.
Загрузка файла отчета в базу
Перейдите в раздел, где размещен список дополнительных отчетов: обычно это «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». В ряде конфигураций список также доступен из разделов «Отчеты» или «НСИ и администрирование». Откроется справочник подключенных отчетов и обработок.
Нажмите «Добавить из файла» (в некоторых версиях — «Создать → Загрузить из файла») и укажите файл с расширением .erf. Программа считает из модуля отчета сведения о регистрации: наименование, версию, вид («Дополнительный отчет»), безопасный режим. Если разработчик заполнил функцию СведенияОВнешнейОбработке корректно, карточка заполнится автоматически.
Если сведения в модуле не заполнены, программа предложит заполнить карточку вручную. Укажите понятное наименование — именно оно будет отображаться в интерфейсе пользователя. Вид объекта выберите «Дополнительный отчет», иначе команда запуска может попасть не в тот список команд раздела.
- 1Откройте «Администрирование → Печатные формы, отчеты и обработки» и включите флажок «Дополнительные отчеты и обработки».
- 2Перейдите по ссылке «Дополнительные отчеты и обработки» в список подключенных объектов.
- 3Нажмите «Добавить из файла» и выберите файл .erf.
- 4Проверьте автоматически заполненные сведения: наименование, вид, версия.
- 5Запишите карточку и настройте размещение в разделах.
Размещение отчета в разделах интерфейса
Именно размещение отвечает на вопрос «как вывести отчет в интерфейс». В карточке дополнительного отчета откройте команду «Размещение» (или закладку «Размещение»). Появится список разделов командного интерфейса: «Продажи», «Закупки», «Склад», «Финансы» и другие — состав зависит от конфигурации.
Отметьте разделы, в которых пользователи должны видеть отчет. Логично выбирать тематически близкие разделы: отчет по продажам — в «Продажи» и, возможно, в «Отчеты», кадровую аналитику — в «Кадры» или «Зарплата». Размещение во всех разделах подряд засоряет интерфейс и затрудняет поиск.
После сохранения команда появится в выбранных разделах в подменю «Дополнительные отчеты» (в некоторых конфигурациях — «Отчеты → Дополнительные»). Если раздела в списке размещения нет, проверьте, не скрыт ли он настройками интерфейса конкретного пользователя.
Настройка прав доступа и быстрого доступа
Дополнительные отчеты подчиняются общей системе прав. Пользователь увидит команду отчета в разделе только если у него есть права на выполнение дополнительных отчетов и на сам раздел. В типовых конфигурациях это регулируется профилями групп доступа: проверьте, что в профиль пользователя включена роль «Выполнение дополнительных отчетов и обработок» или аналогичная.
Если отчет должен быть доступен ограниченному кругу лиц, не размещайте его в общих разделах «на всякий случай» — ограничьте доступ через профили. Дополнительно можно использовать механизм «Пользователи с правом открытия» в карточке отчета, если конфигурация его поддерживает.
Для часто используемых отчетов пользователь может сам добавить команду в избранное или на начальную страницу через стандартные настройки панелей. Это не требует административных прав и не влияет на других пользователей.
Проверка результата и типичные ошибки
После настройки проверьте результат под учетной записью обычного пользователя, а не администратора: у администратора видны все команды, и ошибка прав останется незамеченной. Откройте целевой раздел, найдите отчет в подменю дополнительных отчетов и запустите его с реальными параметрами.
Обратите внимание на корректность работы в клиент-серверном варианте: отчет, написанный только под файловый режим, может выдавать ошибки обращения к локальным путям или COM-объектам на сервере. Проверку лучше выполнять в том же режиме, в котором работают пользователи.
Если отчет запускается, но формирует пустой результат, причина обычно не в подключении, а в самом отчете: проверьте отборы, период и права на данные (RLS может скрывать часть записей от пользователя).
Как проверить результат
Отчет виден в подменю «Дополнительные отчеты» нужного раздела у обычного пользователя
Команды нет или она видна только администратору
Форма открывается, отчет формируется без ошибок прав
Ошибка «Нарушение прав доступа» или сообщение о безопасном режиме
Данные совпадают с типовым отчетом или контрольной выборкой
Пустой результат или явно неполные данные
Альтернативные способы запуска внешних отчетов
Регистрация в справочнике — не единственный вариант. Разовый отчет можно открыть через «Файл → Открыть», указав .erf: отчет запустится без добавления в интерфейс. Это удобно для проверки или разовой аналитики, но не подходит для регулярной работы пользователей.
Если отчет нужен постоянно и его логика стабильна, правильнее встроить его в расширение конфигурации: тогда он станет частью метаданных, получит полноценную команду в разделах и будет обновляться централизованно. Этот путь требует навыков разработки, но снимает ограничения безопасного режима и упрощает сопровождение.
Некоторые задачи вообще не требуют внешнего отчета: типовой механизм «Варианты отчетов» позволяет сохранить настройки типового отчета как отдельный пункт и разместить его в разделах. Прежде чем подключать внешний файл, проверьте, не решается ли задача настройкой существующего отчета.
Способы подключения отчета
Штатный способ без доработки конфигурации; подходит большинству пользователей. Ограничение — исполнение в безопасном режиме, зависимость от заполнения сведений в модуле.
Быстрый разовый запуск без регистрации. Не подходит для регулярной работы: нет команды в интерфейсе, нет контроля версий.
Полноценная команда в разделах, централизованное обновление. Требует навыков разработки и тестирования при обновлении платформы.
Не требует внешних файлов вообще. Работает, только если нужный результат достижим настройками существующего отчета.
Обновление и сопровождение подключенного отчета
Когда разработчик присылает новую версию файла, не создавайте второй элемент справочника: откройте существующую карточку и используйте «Заменить файл» (или «Загрузить из файла» в карточке). Тогда размещение, права и история сохранятся, а версия обновится.
После обновления конфигурации или платформы проверьте работоспособность внешних отчетов: изменения в структуре метаданных могут сломать запросы отчета. Полезно вести список подключенных отчетов с указанием автора и назначения — при обновлении это экономит время на проверке.
Неиспользуемые отчеты не удаляйте сразу — сначала снимите пометку публикации или уберите размещение и понаблюдайте, не обратятся ли пользователи. Удаление элемента справочника необратимо убирает команду из интерфейса.
Что важно запомнить
Внешний отчет попадает в интерфейс через три обязательных шага: включенный механизм дополнительных отчетов, загруженный файл .erf и настроенное размещение в разделах. Проверяйте результат под обычным пользователем, а новые файлы — сначала на копии базы.
Частые вопросы
Загрузил отчет, но в разделе его не видно. Что проверить в первую очередь?
Откройте карточку отчета и убедитесь, что заполнено «Размещение» — отмечен хотя бы один раздел. Затем проверьте, что флажок «Дополнительные отчеты и обработки» включен в настройках, и перезайдите в базу: интерфейс обновляется при новом входе.
Можно ли добавить внешний отчет без прав администратора?
Да, если у пользователя есть профиль с правом добавления дополнительных отчетов и обработок. В типовых конфигурациях такую роль можно включить в отдельный профиль группы доступа, не давая полных административных прав.
Чем отличается «Дополнительный отчет» от «Дополнительной обработки» при загрузке?
Вид определяет, в какое подменю попадет команда: отчеты — в «Дополнительные отчеты» раздела, обработки — в «Дополнительные обработки». Если при загрузке выбран неверный вид, команда окажется не там, где ее ищут пользователи, хотя сам объект будет работать.
Отчет работал в файловой базе, а в клиент-серверной выдает ошибку. Почему?
На сервере недоступны локальные пути, диалоги выбора файлов на клиенте без передачи данных и некоторые COM-объекты. Код отчета нужно адаптировать под клиент-серверный режим: использовать передачу файлов через временное хранилище и серверные механизмы платформы.
Как ограничить доступ к внешнему отчету для части пользователей?
Настройте профили групп доступа: уберите роль выполнения дополнительных отчетов у тех, кому отчет не нужен, либо используйте ограничение по пользователям в карточке отчета, если конфигурация это поддерживает. Простое снятие размещения в разделе не защищает данные — отчет останется доступен через общий список.
Что произойдет с отчетом при обновлении конфигурации?
Дополнительные отчеты хранятся в данных базы, а не в метаданных, поэтому при обновлении они сохраняются. Однако если в новой версии изменились имена объектов или реквизитов, запрос отчета может перестать работать — после обновления стоит запустить его и сверить результат.