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