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