Создание внешнего отчета СКД в 1С: полная инструкция от А до Я

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

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

Особое внимание уделим практическим нюансам: например, почему отчет может "подвисать" при больших объемах данных и как это исправить с помощью настройки временных таблиц. Также рассмотрим, как интегрировать отчет в интерфейс 1С так, чтобы пользователи могли им пользоваться без доступа к конфигуратору.

Подготовка рабочей среды: что нужно для создания отчета

Прежде чем приступить к разработке, убедитесь, что у вас есть всё необходимое. Минимальные требования:

• 🖥️ 1С:Предприятие 8.3 (версия не ниже 8.3.10 — в более ранних могут отсутствовать ключевые функции СКД)
• 🔧 Конфигуратор с правами администратора (для создания внешних обработок)
• 📁 Пустая папка на диске для сохранения внешних файлов (лучше заранее исключить её из антивирусного сканирования)
• 📊 Тестовая база с актуальными данными (не работайте на боевой базе!)

Если вы планируете разрабатывать отчет для конкретной конфигурации (например, 1С:Бухгалтерия 3.0 или 1С:Управление торговлей 11), заранее изучите её структуру метаданных. Это поможет правильно сформировать запросы к базе. Например, в УТ 11 таблица документов Документ.РеализацияТоваровУслуг имеет иную структуру, чем в БП 3.0.

Также проверьте настройки безопасности: иногда политики предприятия блокируют создание внешних файлов. В этом случае потребуется согласование с администратором сети.

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

Начнём с создания пустой обработки, которая станет основой для нашего отчета. Следуйте шагам:

1. Откройте конфигуратор и выберите Файл → Новый.
2. В списке объектов выберите Внешняя обработка и нажмите OK.
3. В открывшемся окне перейдите на вкладку Основные и заполните поля:
   • Имя: ВнешнийОтчетПоПродажам (пример)
   • Синоним: Отчет по продажам (внешний)
   • Комментарий: краткое описание назначения отчета

Теперь у вас есть заготовка, но она пока не содержит логики отчета. Чтобы добавить СКД, перейдите на вкладку Формы и создайте новую форму с типом Управляемая форма. Именно здесь будет размещаться компонента системы компоновки данных.

Создана новая внешняя обработка|

Заполнены основные реквизиты (имя, синоним)|

Сохранен файл с расширением .epf|

Создана управляемая форма для СКД-->

Настройка схемы компоновки данных (СКД)

Схема компоновки данных — это "сердце" вашего отчета. Она определяет, какие данные будут выгружаться, как они будут группироваться и отображаться. Чтобы её настроить:

1. На вкладке Формы дважды кликните по созданной форме, чтобы открыть её в редактор.
2. Добавьте на форму элемент Поле компоновки данных (найдёте его в палитре элементов).
3. В свойствах поля укажите:
   • Имя: КомпоновщикДанных
   • Тип компоновщика данных: КомпоновщикНастроек

В конструкторе вам предстоит:

5. Добавить наборы данных (запросы к базе). Например, для отчета по продажам это может быть запрос к документу РеализацияТоваровУслуг с присоединением справочника Номенклатура.
6. Определить ресурсы (показатели, которые будут рассчитываться: сумма, количество, средняя цена и т.д.).
7. Настроить параметры (период, организация, ответственный и другие фильтры).
8. Задать структуру отчета: группировки, сортировки, условное оформление.

Пример простого запроса для набора данных:

ВЫБРАТЬ
РеализацияТоваровУслуг.Дата КАК Дата,
РеализацияТоваровУслуг.Номер КАК Номер,
Номенклатура.Наименование КАК Номенклатура,
РеализацияТоваровУслуг.СуммаДокумента КАК Сумма
ИЗ
Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура КАК Номенклатура
ПО РеализацияТоваровУслуг.Номенклатура = Номенклатура.Ссылка
ГДЕ
РеализацияТоваровУслуг.Проводен

ВЫБРАТЬ ...
ПОМЕСТИТЬ ВТ_Данные

Добавление параметров и пользовательских настроек

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

1. В конструкторе схемы компоновки данных перейдите на вкладку Параметры.
2. Нажмите Добавить и заполните свойства параметра:
   • Имя: ПериодНачала
   • Тип: Дата
   • Заголовок: Период с
   • Значение по умолчанию: НачалоДня(ТекущаяДата())
3. Аналогично добавьте параметр ПериодОкончания со значением по умолчанию КонецДня(ТекущаяДата()).
4. В наборе данных модифицируйте запрос, добавив условие по периоду:

   ГДЕ
   РеализацияТоваровУслуг.Дата МЕЖДУ &ПериодНачала И &ПериодОкончания

Для удобства пользователей можно сгруппировать параметры на форме. Например, разместить их в отдельной группе с заголовком "Период" или "Фильтры". Также полезно добавить кнопку "Сформировать", которая будет запускать компоновку данных:

Процедура КнопкаСформироватьНажатие(Элемент)
КомпоновщикДанных.Выполнить();
КонецПроцедуры

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

Процедура ПередВыполнениемКомпоновкиДанных(Отказ, ПараметрыКомпоновкиДанных)
Если ПараметрыКомпоновкиДанных.Параметры.ПериодНачала > ПараметрыКомпоновкиДанных.Параметры.ПериодОкончания Тогда
Сообщить("Дата начала не может быть позже даты окончания!", СтатусСообщения.Важное);
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

Как добавить выпадающий список для параметра?

Чтобы параметр отображался как выпадающий список (например, для выбора организации), в свойствах параметра укажите:

• Тип значения: СправочникСсылка.Организации
• Форма выбора: Истина
• Множественный выбор: Ложь (если нужно выбрать одну организацию)

В коде запроса используйте конструкцию В(&Параметр) для фильтрации.

Оптимизация производительности отчета

Одна из самых распространённых проблем при работе с СКД — медленная скорость формирования отчета, особенно при больших объемах данных. Вот ключевые способы оптимизации:

Проблема	Решение	Пример кода/настройки
Долгое выполнение запроса	Использовать индексируемые поля в условиях ГДЕ	ГДЕ Дата МЕЖДУ &Начало И &Конец (поле Дата должно быть индексировано)
Слишком много группировок	Ограничить количество группировок или использовать иерархию	В настройках СКД отключить ненужные группировки на вкладке Структура
Вычисление ресурсов по большим массивам	Перенести расчёты в запрос (например, через СУММА)	ВЫБРАТЬ СУММА(СуммаДокумента) КАК Итого
Медленная компоновка результата	Отключить ненужные элементы оформления (цвета, шрифты)	На вкладке Другие настройки снять галочку Использовать условное оформление

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

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

// Затем используем её в основном запросе
ВЫБРАТЬ
ВТ_Продажи.Номенклатура КАК Номенклатура,
ВТ_Продажи.Количество,
Номенклатура.Наименование
ИЗ
ВТ_Продажи КАК ВТ_Продажи
ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура КАК Номенклатура
ПО ВТ_Продажи.Номенклатура = Номенклатура.Ссылка

💡

Всегда тестируйте производительность отчета на реальных объемах данных. То, что быстро работает на тестовой базе с 100 документами, может "подвесить" систему на базе с 100 000 записей.

Тестирование и отладка отчета

Перед передачей отчета пользователям обязательно проведите тестирование. Начните с проверки:

• 📅 Корректности работы параметров (например, что отбор по периоду действительно фильтрует данные).
• 📊 Точности расчётов (сверьте суммы с другими отчётами или регистрами).
• 🖨️ Вывода на печать (проверьте, что данные не обрезаются и сохраняется форматирование).
• 🔄 Производительности на больших объёмах данных (имитируйте реальную нагрузку).

Для отладки используйте встроенные инструменты 1С:

• Отладчик (точки останова, пошаговое выполнение).
• Журнал регистрации (для анализа медленных запросов).
• Тестовый клиент (для проверки работы на сервере).

Типичные ошибки и способы их исправления:

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

Если отчет работает нестабильно, попробуйте сохранить его в разных форматах:

• .epf — стандартный формат внешней обработки.
• .erf — для отчетов (иногда лучше подходит для СКД).
• .cf — если нужно передать только схему компоновки.

Сообщить("Начало формирования отчета, параметры: " + ПараметрыКомпоновкиДанных.Параметры.ПериодНачала);

-->

Подключение внешнего отчета к базе 1С

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

1. Через меню "Файл":
   • В пользовательском режиме выберите Файл → Открыть.
   • Укажите путь к файлу .epf или .erf.
   • Отчет откроется в отдельном окне и будет доступен до закрытия сеанса.
5. Через подключаемые отчеты (для постоянного доступа):
   • В конфигураторе откройте ветку Отчеты.
   • Создайте новый отчет с типом Внешняя обработка.
   • Укажите путь к файлу и сохраните конфигурацию.

⚠️ Внимание: При обновлении конфигурации внешние отчеты могут "слететь". Рекомендуется хранить резервную копию файлов и документацию по их подключению.

ВнешнийОтчет = ВнешниеОтчеты.Создать("ПутьКФайлу.epf");
ВнешнийОтчет.КомпоновщикНастроек.Настройки.ПараметрыДанных.УстановитьПараметр("ПериодНачала", НачалоДня(ТекущаяДата()));
ВнешнийОтчет.Сформировать();

Параметры = Новый Структура();
Параметры.Вставить("ПериодНачала", НачалоДня(ТекущаяДата()));
ВнешнийОтчет.КомпоновщикНастроек.Настройки.ПараметрыДанных.Загрузить(Параметры);

Построитель = Новый ПостроительОтчета;
Построитель.Инициализировать(Результат);
Построитель.ЭкспортироватьВExcel("C:\Отчет.xlsx");