СКД 1С: что такое схема компоновки данных

СКД 1С — система компоновки данных, механизм платформы «1С:Предприятие 8», на котором построено большинство отчётов в типовых конфигурациях. Программист описывает в схеме, откуда брать данные и что можно посчитать. Группировки, отборы, сортировку и оформление пользователь потом меняет сам, в настройках отчёта, без правки кода. Ниже — из каких частей состоит схема компоновки данных, что происходит после нажатия «Сформировать», как увидеть реальный запрос отчёта и на чём чаще всего спотыкаются.

Где встречается система компоновки данных 1С

Чаще всего — в отчётах. Если у отчёта есть кнопка «Настройки», а в ней отборы, поля и группировки, перед вами СКД. Так устроены отчёты БП 3.0, УТ 11, ERP, КА 2 и других конфигураций на БСП, а также универсальный отчёт по любому справочнику, документу или регистру.

Второе место — динамические списки. Отбор, сортировка, условное оформление и группировка в команде «Ещё → Настроить список» — это настройки компоновки данных. Из кода список управляется теми же объектами: Список.КомпоновщикНастроек, ЭлементОтбораКомпоновкиДанных.

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

Из чего состоит схема компоновки данных

Схема — это макет с типом «Схема компоновки данных» внутри отчёта, обработки или в общих макетах. У отчёта одна схема назначается основной (свойство «Основная схема компоновки данных») — по ней платформа и формирует результат. Закладки конструктора схемы почти один в один совпадают с её частями.

Наборы данных

Набор данных отвечает на вопрос «откуда брать строки». Видов три:

• Запрос — самый частый. Текст пишут в конструкторе запроса, поля набора заполняются по тексту автоматически, если включено автозаполнение.
• Объект — строки приходят из кода: таблицу значений передают в процессор компоновки как внешний набор данных. Так в отчёт попадают данные из файла или ответ веб-сервиса.
• Объединение — склеивает несколько наборов в один, по смыслу как ОБЪЕДИНИТЬ ВСЕ. Например, план из одного регистра и факт из другого. Поля вложенных наборов сопоставляются по пути к данным.

В тексте запроса набора работает расширение языка запросов для СКД — фрагменты в фигурных скобках, например {ГДЕ Продажи.Склад.*}. Они подсказывают компоновщику, какие поля и условия можно менять из настроек; при автозаполнении большую часть этой работы СКД делает сама.

Связи наборов данных

Если наборов несколько, связи задают, как сопоставлять их строки: набор-источник, набор-приёмник и выражения с обеих сторон — обычно одно и то же поле, например Номенклатура. Связь работает как левое соединение: все строки источника остаются, данные приёмника подтягиваются там, где нашлась пара. Флажок «Обязательная связь» делает соединение внутренним. Связанные наборы выполняются отдельными запросами, соединяет их процессор компоновки. Для запроса и внешнего набора это единственный путь, а два регистра одной базы проще соединить в одном запросе.

Поля и вычисляемые поля

У каждого поля набора есть заголовок, ограничения использования (можно ли выбрать его в отборе, группировке, сортировке), роль и оформление — подробнее в статье про поля СКД. Вычисляемые поля — те, которых в наборе нет: их значение считается выражением на языке выражений СКД, например ВЫБОР КОГДА Количество = 0 ТОГДА 0 ИНАЧЕ Сумма / Количество КОНЕЦ. В выражении можно вызвать экспортную функцию общего модуля через имя модуля, но она выполнится для каждой строки результата.

Ресурсы

Ресурс — поле, по которому СКД считает итоги на каждом уровне группировок. Выражение ресурса — агрегатная функция: Сумма(Сумма), Количество(Различные Номенклатура), Максимум(Цена). Для средней цены правильный ресурс — не Среднее(Цена), а ВЫБОР КОГДА Сумма(Количество) = 0 ТОГДА 0 ИНАЧЕ Сумма(Сумма) / Сумма(Количество) КОНЕЦ: среднее арифметическое цен не учитывает объёмы. Колонка «Рассчитывать по» ограничивает группировки, в которых ресурс считается, — цену, например, есть смысл показывать только в строке номенклатуры, а не в итоге по складу.

Параметры

Параметры из текста запроса (&НачалоПериода, &КонецПериода) появляются на закладке «Параметры» сами. Туда же добавляют свои: параметр Период типа «Стандартный период», а у НачалоПериода в колонке «Выражение» пишут &Период.ДатаНачала. Пользователь выбирает один период, запрос получает две даты. Служебный параметр скрывают флажком «Ограничение доступности» и заполняют из кода. Подробнее — в статье о параметрах СКД.

Настройки и варианты

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

Макеты

Когда стандартного вывода мало — нужна шапка как в печатной форме, объединённые ячейки, особый вид строки итога, — на закладке «Макеты» задают свою область табличного документа для поля, группировки или заголовка. Подробно — в статье про макет СКД.

Как работает СКД 1С 8.3 при формировании отчёта

После нажатия «Сформировать» платформа проходит цепочку: схема и настройки → макет компоновки → процессор компоновки → табличный документ. Ту же цепочку повторяют руками, когда отчёт формируют из кода.

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

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

Когда отчёт тормозит или показывает не те цифры, первым делом смотрят итоговый текст запроса. Функция ниже проходит второй шаг цепочки и возвращает тексты запросов из макета вместе со значениями параметров. Её кладут в общий модуль с флажками «Сервер», «Внешнее соединение» и «Клиент (обычное приложение)», без «Вызов сервера». Иначе вызов из модуля объекта отчёта не скомпилируется в обычном приложении и во внешнем соединении:

// Общий модуль ОтладкаСКД.
// Свойства модуля: «Сервер», «Внешнее соединение», «Клиент (обычное приложение)» - Истина;
// «Вызов сервера» - Ложь (как у серверных модулей БСП).
// Платформа 8.3.6 и выше (СтрСоединить).

// Возвращает тексты запросов, которые СКД выполнит для переданных
// схемы и настроек, и значения параметров этих запросов.
//
// Параметры:
//  Схема     - СхемаКомпоновкиДанных
//  Настройки - НастройкиКомпоновкиДанных
//
// Возвращаемое значение:
//  Строка
//
Функция ЗапросыМакета(Схема, Настройки) Экспорт

	// Шаг 2 цепочки компоновки: схема + настройки -> макет.
	КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
	МакетКомпоновки = КомпоновщикМакета.Выполнить(Схема, Настройки);

	Строки = Новый Массив;
	ДобавитьЗапросыНаборов(МакетКомпоновки.НаборыДанных, Строки);

	Строки.Добавить("// Параметры макета:");
	Для Каждого Параметр Из МакетКомпоновки.ЗначенияПараметров Цикл
		Строки.Добавить("// &" + Параметр.Имя + " = " + Строка(Параметр.Значение));
	КонецЦикла;

	Возврат СтрСоединить(Строки, Символы.ПС);

КонецФункции

Процедура ДобавитьЗапросыНаборов(НаборыДанных, Строки)

	Для Каждого Набор Из НаборыДанных Цикл

		Если ТипЗнч(Набор) = Тип("НаборДанныхЗапросМакетаКомпоновкиДанных") Тогда
			Строки.Добавить("// Набор данных: " + Набор.Имя);
			Строки.Добавить(Набор.Запрос);
			Строки.Добавить("");

		ИначеЕсли ТипЗнч(Набор) = Тип("НаборДанныхОбъединениеМакетаКомпоновкиДанных") Тогда
			// У объединения запросы лежат во вложенных наборах.
			ДобавитьЗапросыНаборов(Набор.Элементы, Строки);

		Иначе
			// Набор-объект: строки приходят из кода, запроса нет.
			Строки.Добавить("// Набор данных " + Набор.Имя + ": внешний, без запроса");
			Строки.Добавить("");
		КонецЕсли;

	КонецЦикла;

КонецПроцедуры

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

// Модуль объекта отчёта. Временная вставка на время отладки.
// Если ПриКомпоновкеРезультата в модуле уже есть (в типовых отчётах часто есть),
// новую процедуру не создавайте: добавьте блок Попытка в начало существующей.
#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда

Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)

	Попытка
		Схема = ПолучитьМакет(Метаданные().ОсновнаяСхемаКомпоновкиДанных.Имя);
		ТекстЗапросов = ОтладкаСКД.ЗапросыМакета(Схема, КомпоновщикНастроек.ПолучитьНастройки());
		ЗаписьЖурналаРегистрации("ОтладкаСКД", УровеньЖурналаРегистрации.Информация, , ,
			ТекстЗапросов);
	Исключение
		// Отладка не должна ломать формирование отчёта.
		ЗаписьЖурналаРегистрации("ОтладкаСКД", УровеньЖурналаРегистрации.Ошибка, , ,
			ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));
	КонецПопытки;

	// СтандартнаяОбработка не трогаем: отчёт сформируется как обычно.

КонецПроцедуры

#КонецЕсли

Если в существующем обработчике своя компоновка (СтандартнаяОбработка = Ложь), передавайте в ОтладкаСКД.ЗапросыМакета те же схему и настройки, с которыми он работает.

Разбор ключевых строк

• КомпоновщикМакета.Выполнить(Схема, Настройки) — второй шаг цепочки. Результат — МакетКомпоновкиДанных: заготовок в нём уже нет, только то, что пойдёт в работу.
• МакетКомпоновки.НаборыДанных — наборы макета, а не схемы. Свойство Запрос набора-запроса содержит итоговый текст: без лишних полей, с условиями из отбора пользователя.
• Рекурсия в ДобавитьЗапросыНаборов нужна для объединений: их запросы лежат уровнем ниже. У набора-объекта запроса нет, выводится только имя.
• МакетКомпоновки.ЗначенияПараметров — значения параметров, включая созданные компоновщиком для условий отбора. Без них текст запроса в консоли не выполнить.
• Метаданные().ОсновнаяСхемаКомпоновкиДанных.Имя — имя основной схемы без строковой константы, а настройки — из КомпоновщикНастроек того же отчёта, с ними платформа и формирует результат.
• Попытка … Исключение — если основной схемы нет или её подменяют программно, в журнал уйдёт ошибка, а формирование отчёта продолжится.

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

Типичные ошибки

• Числовое поле не добавлено в ресурсы. В строках детальных записей цифры есть, в группировках и общем итоге — пусто. Обратная сторона: поле-ресурс нельзя выбрать как поле группировки.
• Пустой отчёт после создания схемы. В настройках нет ни одной группировки, и выводить нечего. На закладке «Настройки» конструктора добавьте хотя бы «Детальные записи» и выберите поля.
• Не заполнен обязательный параметр. Отчёт падает с сообщением вида «Не установлено значение параметра "НачалоПериода"». Параметр выключен в настройках или у него нет значения по умолчанию.
• Итоги больше, чем должны быть. В запросе набора левое соединение размножает строки — например, к продажам присоединили все цены номенклатуры. Ресурс Сумма(Сумма) честно складывает дубли.
• Общий модуль не виден из модуля отчёта. Проверка модулей пишет «Переменная не определена (ОтладкаСКД)»: у общего модуля не отмечен один из контекстов, перечисленных в #Если.
• Дубль обработчика. Вторая процедура ПриКомпоновкеРезультата в модуле отчёта даёт ошибку «Процедура или функция с указанным именем уже определена». В типовых отчётах ERP, УТ 11, КА 2 обработчик часто уже есть — отладочный код добавляют в него.
• Тяжёлое вычисляемое поле. Функция общего модуля с запросом внутри вызывается на каждой строке, и отчёт на тысячах строк работает минутами. Такие вещи считают в самом запросе набора.

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

Чем СКД отличается от запроса с выводом в макет?

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

Работает ли СКД в обычных формах?

Да. Схема компоновки данных устроена одинаково в обычном и управляемом приложении, механизм появился ещё в платформе 8.1. Отличаются форма отчёта и работа с настройками на клиенте.

Можно ли сделать отчёт на СКД без изменения конфигурации?

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

Как получить результат СКД в таблицу значений?

При компоновке макета передайте тип генератора ГенераторМакетаКомпоновкиДанныхДляКоллекцииЗначений, а для вывода используйте ПроцессорВыводаРезультатаКомпоновкиДанныхВКоллекциюЗначений с методом УстановитьОбъект. Для нескольких уровней группировок удобнее дерево значений.

Когда проще заказать

Если отчёт собирает данные из нескольких регистров или считает то, чего нет в типовых отчётах, быстрее отдать схему программисту. На 1c-only.ru задачу по разработке отчётов на СКД и обработок оценивают бесплатно, ответ приходит в течение рабочего дня: опишите колонки, группировки и отборы и разместите задачу. Если тормозит уже существующий отчёт, посмотрите услугу «1С тормозит».

По теме

• Как сделать отчёт в 1С: способы без программиста и с ним