Как делать внешние отчёты в 1С: практическое руководство

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

Создать внешний отчёт можно двумя путями: через конфигуратор с использованием системы компоновки данных (СКД) или программно, с ручным формированием табличного документа. Первый вариант подходит в большинстве случаев — СКД берёт на себя построение запроса, группировки, отборы и оформление, а пользователь получает гибкие настройки без доработки кода.

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

Когда внешний отчёт предпочтительнее доработки конфигурации

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

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

Создание файла внешнего отчёта в конфигураторе

Откройте конфигуратор нужной базы (достаточно тестовой копии — отчёт не меняет метаданные, но запрос удобнее отлаживать на реальной структуре данных). В меню выберите Файл → Новый → Внешний отчёт, задайте имя латиницей без пробелов — оно станет именем объекта и синонимом по умолчанию.

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

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

Настройка схемы компоновки данных

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

На закладке «Настройки» включите режим конструктора настроек и задайте структуру: например, группировка «Номенклатура» с детальными полями. Отборы, которые пользователь должен менять сам, вынесите в «Быстрые настройки» — тогда они появятся на панели отчёта в режиме предприятия.

Параметры запроса (период, организация) определите на закладке «Параметры». Для параметра «Период» удобно использовать стандартный период — СКД сама подставит начало и конец в условие запроса через конструкцию МЕЖДУ &НачалоПериода И &КонецПериода.

ВЫБРАТЬ
	ПродажиОбороты.Номенклатура КАК Номенклатура,
	СУММА(ПродажиОбороты.СуммаОборот) КАК Сумма
ИЗ
	РегистрНакопления.Продажи.Обороты(&НачалоПериода, &КонецПериода, , ) КАК ПродажиОбороты
СГРУППИРОВАТЬ ПО
	ПродажиОбороты.Номенклатура

Подключение отчёта в режиме предприятия

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

В типовых конфигурациях на базе БСП (УТ, ERP, БП, ЗУП) есть подсистема «Дополнительные отчёты и обработки». Включите её в настройках (Администрирование → Печатные формы, отчёты и обработки), затем в разделе «Дополнительные отчёты» добавьте файл. Система попросит указать размещение — разделы командного интерфейса, где отчёт будет виден пользователям.

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

Безопасный режим и права доступа

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

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

Проверка корректности результата

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

Проверьте отчёт на граничных условиях: пустой период, период без данных, пользователь с ограниченными правами. В последнем случае запрос должен корректно отработать с RLS — если пользователь видит «лишние» строки, значит, запрос обращается к таблицам в обход ограничений, что бывает при использовании конструкции РАЗРЕШЕННЫЕ не по назначению.

Типичные ошибки при разработке внешних отчётов

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

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

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