В процессе работы с Системой Компоновки Данных (СКД) в 1С мы часто сталкиваемся с необходимостью построения сложных отчетов, содержащих иерархические данные. Одной из таких задач является вывод дерева номенклатуры, выстроенного по спецификациям, где каждый материал или полуфабрикат может входить в состав различных изделий на разных уровнях вложенности. При этом возникает потребность не просто отобразить эту иерархию, но и посчитать общую сумму необходимого количества каждого конкретного материала по всему дереву производства. Стандартные механизмы СКД, такие как явные группировки и ресурсы, предназначенные для агрегации данных, оказываются неэффективными или вовсе неприменимыми в случае, когда отчет построен исключительно на "иерархии детальных записей" без возможности добавления произвольных группировок, так как это нарушит рекурсивную логику построения.
В этой статье мы подробно рассмотрим, почему традиционные подходы СКД не всегда подходят для такой специфической задачи, и предложим комплексное программное решение, которое позволит нам получить нужные итоги, сохраняя при этом гибкость и функциональность СКД.
Прежде чем углубляться в решение, давайте проанализируем, почему традиционные подходы СКД не всегда подходят для данной ситуации. Иерархия детальных записей в СКД формируется, когда у нас есть набор данных со связью "к самому себе", позволяющей рекурсивно получать вложенные записи. Типичный пример – дерево номенклатуры, где элемент может быть как готовой продукцией, так и материалом или полуфабрикатом для другого элемента. Система рекурсивно выполняет эту связь, чтобы построить всю структуру, основываясь на ссылочных полях.
Основная проблема заключается в том, что в такой структуре мы работаем с детальными записями, а не с явными группировками. Стандартные ресурсы СКД (Сумма, Количество, Среднее и т.д.) предназначены для агрегации данных именно по определенным уровням группировки. Если группировок нет, или они не настроены таким образом, чтобы агрегировать данные по всем вхождениям одного и того же материала, то стандартные ресурсы просто не дадут нужный результат. Например, они могут посчитать сумму только для видимой строки или для всего отчета в целом, но не для каждого уникального материала, встречающегося в разных ветках дерева. Автор темы четко указал, что добавление группировок в отчет невозможно, так как это нарушает механизм построения иерархии, получаемой рекурсивно через связи набора данных.
Функция ВычислитьВыражение, которая позволяет выполнять произвольные вычисления, также чаще всего используется в контексте группировок. Хотя она имеет параметр ОбластьВычисления (например, "ОбщийИтог", "Иерархия" или "Группировка"), применение параметра "Иерархия" в данном случае оказывается затруднительным. Он обычно вычисляет выражение для родительской иерархической записи, но не предоставляет удобного механизма для накопления суммы по всем вхождениям конкретного материала, который может быть разбросан по разным веткам дерева спецификаций. Наша задача состоит в том, чтобы собрать все экземпляры определенного материала со всех уровней иерархии и получить их общую сумму, что является нетривиальной задачей для чисто декларативного подхода СКД без явных группировок.
Эффективное решение данной проблемы лежит в комбинации возможностей СКД и программной обработки данных. Мы используем СКД для построения сложной иерархии, а затем "перехватываем" результат ее работы для дополнительной программной агрегации и вывода итогов. Разберем этот подход по шагам, основываясь на опыте, описанном в обсуждении.
Формирование основного отчета с иерархией детальных записей:
На первом этапе мы создаем обычную схему компоновки данных (СКД), которая формирует требуемую иерархию номенклатуры по спецификациям. Это достигается за счет использования рекурсивных связей в наборах данных. Например, в запросе можно использовать ОБЪЕДИНИТЬ ВСЕ или создать связь набора данных к самому себе. В настройках отчета указываем вывод детальных записей без дополнительных группировок, чтобы получить то самое "дерево" с вложенными элементами. Мы должны убедиться, что запрос СКД корректно возвращает все элементы иерархии, включая вложенные материалы, с их соответствующими количествами, которые потребуются для дальнейшей обработки.
Например, если у нас есть регистр сведений, хранящий состав спецификаций, мы можем построить запрос, который рекурсивно выбирает все компоненты для заданной готовой продукции. В результате выполнения такого запроса и настройки СКД мы получим набор детальных записей, который выглядит как дерево, но является плоским списком, который СКД потом рендерит с отступами.
Программное получение данных из отчета в таблицу значений:
Далее мы программно формируем отчет СКД, но не сразу выводим его в табличный документ, а получаем результат в виде таблицы значений. Это критически важный шаг, который позволяет нам "извлечь" данные из СКД для дальнейшей обработки вне ее стандартных механизмов.
Для этого нам потребуются следующие объекты СКД в коде:
КомпоновщикМакетаКомпоновкиДанных: Мы используем этот объект для создания макета компоновки данных из нашей схемы и настроек.ПроцессорКомпоновкиДанных: Он обрабатывает созданный макет и выполняет компоновку, извлекая данные из информационной базы согласно запросам схемы.ПроцессорВыводаРезультатаКомпоновкиДанныхВТаблицуЗначений: Этот специализированный процессор вывода позволяет направить результат работы СКД не в табличный документ, а непосредственно в объект ТаблицаЗначений.Вот пример того, как это может выглядеть в модуле объекта или формы отчета:
// Функция для программного формирования СКД и получения таблицы значений
Функция ПолучитьИсходныеДанныеСКДВТаблицуЗначений(СхемаКомпоновкиДанных, Настройки) Экспорт
Перем ТаблицаИсходныхДанных;
ТаблицаИсходныхДанных = Новый ТаблицаЗначений;
Попытка
// Создаем компоновщик макета
КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
// Получаем макет компоновки
МакетКомпоновки = КомпоновщикМакета.Выполнить(СхемаКомпоновкиДанных, Настройки);
// Создаем процессор компоновки данных
ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
// Инициализируем процессор. ДанныеРасшифровки можно передать, если они нужны.
ПроцессорКомпоновки.Инициализировать(МакетКомпоновки, , Новый ДанныеРасшифровкиКомпоновкиДанных);
// Создаем процессор вывода в таблицу значений
ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТаблицуЗначений;
ПроцессорВывода.УстановитьОбъект(ТаблицаИсходныхДанных);
// Выводим результат в таблицу значений. Параметр Истина означает вывод всех полей.
ПроцессорВывода.Вывести(ПроцессорКомпоновки, Истина);
Исключение
Сообщить("Ошибка при получении данных СКД: " + ОписаниеОшибки(), СтатусСообщения.Важное);
Возврат Неопределено;
КонецПопытки;
Возврат ТаблицаИсходныхДанных;
КонецФункции
В этом коде СхемаКомпоновкиДанных – это объект схемы, который мы получаем, например, из макета отчета (ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных")), а Настройки – это объект настроек, который может быть загружен из сохраненных настроек пользователя или создан по умолчанию (СхемаКомпоновкиДанных.НастройкиПоУмолчанию) с программной установкой параметров и отборов.
Программная обработка полученной таблицы значений:
После того как мы получили все детальные записи из СКД в таблицу значений ТаблицаИсходныхДанных, мы можем программно обработать их. Наша задача – пройтись по всем строкам, собрать все уникальные материалы (номенклатуру) и суммировать их количества по всем вхождениям. Для этого мы создадим новую таблицу значений, которая будет содержать агрегированные итоги.
// Функция для агрегации данных по материалам
Функция АгрегироватьИтогиПоМатериалам(ТаблицаИсходныхДанных) Экспорт
Если ТаблицаИсходныхДанных = Неопределено Тогда
Возврат Новый ТаблицаЗначений;
КонецЕсли;
// Создаем таблицу для сбора итогов по материалам
ТаблицаИтоговПоМатериалам = Новый ТаблицаЗначений;
ТаблицаИтоговПоМатериалам.Колонки.Добавить("Номенклатура"); // Поле для ссылки на материал
ТаблицаИтоговПоМатериалам.Колонки.Добавить("ОбщееКоличество", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(15, 3))); // Поле для суммарного количества
// Используем Соответствие для быстрого доступа к уже учтенным материалам
// Ключ - ссылка на Номенклатуру, Значение - строка ТаблицыИтоговПоМатериалам
СопоставлениеИтогов = Новый Соответствие;
Для Каждого СтрокаИсходныхДанных Из ТаблицаИсходныхДанных Цикл
// Предполагаем, что в ТаблицаИсходныхДанных есть поля "Номенклатура" и "КоличествоВБазовыхЕдиницах"
// или другие поля, содержащие материал и его количество на данном уровне.
// Нам нужно определить, какое поле содержит ссылку на Номенклатуру, и какое - количество.
// Например, если поля называются "Материал" и "ТребуемоеКоличество":
Материал = СтрокаИсходныхДанных.Материал;
Количество = СтрокаИсходныхДанных.ТребуемоеКоличество;
Если СопоставлениеИтогов.Получить(Материал) = Неопределено Тогда
// Материал еще не встречался, добавляем новую строку в итоги
НоваяСтрока = ТаблицаИтоговПоМатериалам.Добавить();
НоваяСтрока.Номенклатура = Материал;
НоваяСтрока.ОбщееКоличество = Количество;
СопоставлениеИтогов.Вставить(Материал, НоваяСтрока);
Иначе
// Материал уже есть, обновляем количество
СтрокаИтогов = СопоставлениеИтогов.Получить(Материал);
СтрокаИтогов.ОбщееКоличество = СтрокаИтогов.ОбщееКоличество + Количество;
КонецЕсли;
КонецЦикла;
Возврат ТаблицаИтоговПоМатериалам;
КонецФункции
В этом примере СтрокаИсходныхДанных.Материал и СтрокаИсходныхДанных.ТребуемоеКоличество – это условные имена полей, которые присутствуют в вашей исходной таблице значений, полученной из СКД. Мы должны быть уверены, что эти поля содержат корректные данные (например, поле Материал должно быть ссылкой на элемент справочника Номенклатура, а ТребуемоеКоличество – числовым значением).
Также можно использовать метод Свернуть() для таблицы значений, если структура полей позволяет это сделать и если нам не нужна сложная логика агрегации:
// Предполагаем, что в ТаблицаИсходныхДанных есть колонки "Материал" и "ТребуемоеКоличество"
// и других колонок, которые не нужно агрегировать, нет или их можно игнорировать.
ТаблицаИтоговПоМатериалам = ТаблицаИсходныхДанных.Скопировать();
ТаблицаИтоговПоМатериалам.Свернуть("Материал", "ТребуемоеКоличество");
// После свертки колонка "ТребуемоеКоличество" будет содержать сумму по "Материалу".
// Возможно, потребуется переименовать ее в "ОбщееКоличество" для удобства.
Однако метод Свернуть() требует, чтобы все остальные колонки были указаны в качестве полей группировки или исключены, что может быть не всегда удобно, если нам нужны только агрегированные данные по материалам и мы не хотим терять другие поля из исходной таблицы.
Создание нового набора данных типа "Объект" в схеме компоновки данных:
Теперь, когда у нас есть агрегированные данные по материалам в ТаблицаИтоговПоМатериалам, мы можем вернуть их обратно в схему СКД для вывода. Для этого мы используем набор данных "Объект". В вашей схеме СКД мы добавляем новый набор данных с типом "Объект". Его структура должна соответствовать структуре вашей ТаблицаИтоговПоМатериалам (поля "Номенклатура" и "ОбщееКоличество").
Набор данных "Объект" позволяет нам передавать в СКД произвольные программно сформированные данные (например, из таблиц значений). В момент компоновки отчета, после получения и обработки ТаблицаИсходныхДанных, мы заполняем этот набор данных "Объект" нашей ТаблицаИтоговПоМатериалам. Это делается путем передачи структуры, где ключ – это имя набора данных "Объект" в СКД, а значение – наша таблица значений.
// ... (после вызова ПолучитьИсходныеДанныеСКДВТаблицуЗначений и АгрегироватьИтогиПоМатериалам)
// Получаем схему компоновки данных еще раз, но уже для основного вывода
СхемаКомпоновкиДанныхДляВывода = ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных"); // Используем ту же схему или новую
НастройкиДляВывода = СхемаКомпоновкиДанныхДляВывода.НастройкиПоУмолчанию; // Или загружаем сохраненные
// Важно: в схеме СКД должен быть набор данных типа "Объект" с именем, например, "ИтогиПоМатериалам"
// и полями "Номенклатура", "ОбщееКоличество".
// Создаем структуру для передачи данных в наборы данных типа "Объект"
ДанныеОбъектовСКД = Новый Структура;
// Ключ структуры должен совпадать с именем вашего набора данных "Объект" в СКД
ДанныеОбъектовСКД.Вставить("ИтогиПоМатериалам", ТаблицаИтоговПоМатериалам);
// Создаем компоновщик макета для основного вывода
КомпоновщикМакетаВывода = Новый КомпоновщикМакетаКомпоновкиДанных;
МакетКомпоновкиВывода = КомпоновщикМакетаВывода.Выполнить(СхемаКомпоновкиДанныхДляВывода, НастройкиДляВывода);
// Создаем процессор компоновки данных для основного вывода
ПроцессорКомпоновкиВывода = Новый ПроцессорКомпоновкиДанных;
// Инициализируем процессор, передавая ему структуру с данными для наборов данных "Объект"
ПроцессорКомпоновкиВывода.Инициализировать(МакетКомпоновкиВывода, ДанныеОбъектовСКД, Новый ДанныеРасшифровкиКомпоновкиДанных);
Важно: Убедитесь, что в схеме СКД вы правильно определили поля набора данных "Объект", или позволили СКД автоматически определить их по первой строке данных. Если поля не совпадают, СКД не сможет корректно обработать переданные данные. Также необходимо, чтобы набор данных "Объект" имел поля, по которым будет выполняться связь с основным набором данных (в нашем случае, это "Номенклатура").
Вывод объединенных данных:
После того как набор данных "Объект" заполнен и процессор компоновки инициализирован с этими данными, мы можем приступить к выводу отчета. У нас есть несколько вариантов, как представить эти объединенные данные пользователю:
Дополнительная колонка в основной иерархии: Это наиболее востребованный вариант, позволяющий сохранить иерархическое представление и одновременно отобразить агрегированные итоги. Мы можем связать наш основной набор данных (который формирует иерархию) с набором данных "Объект" по полю "Номенклатура". В настройках СКД мы добавляем связь наборов данных, например, "НаборДанныхОсновной.Номенклатура = ИтогиПоМатериалам.Номенклатура". Тип связи обычно "Левое соединение", чтобы не терять строки из основного набора данных, если для какого-либо элемента нет агрегированных итогов (хотя в нашем случае они будут для всех).
После настройки связи, мы можем добавить поле ИтогиПоМатериалам.ОбщееКоличество в качестве дополнительной колонки в детальных записях основного отчета. Таким образом, для каждой строки номенклатуры в иерархии будет показано ее общее суммарное количество по всему отчету.
// В схеме компоновки данных настраиваем связь наборов данных:
// Раздел "Связи наборов данных"
// Добавить новую связь:
// Источник: НаборДанных1 (ваш основной набор данных с иерархией)
// Приемник: ИтогиПоМатериалам (ваш набор данных типа "Объект")
// Поле Источника: Номенклатура
// Поле Приемника: Номенклатура
// Тип связи: Левое соединение
// Использование: Истина
// Затем в выбранных полях отчета (или в группировке "Детальные записи")
// добавляем новое поле:
// Поле: ИтогиПоМатериалам.ОбщееКоличество
// Заголовок: "Общее количество"
Отдельный раздел отчета: Если мы хотим вывести итоги по материалам в отдельном разделе отчета (например, в конце или начале), мы можем добавить в СКД дополнительную группировку, основанную только на наборе данных "Объект", или просто вывести поля из набора данных "Объект" в отдельной области отчета, например, на второй вкладке или в другом табличном документе. Для этого мы используем ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент.
// ... (после инициализации ПроцессорКомпоновкиВывода с ДанныеОбъектовСКД)
// Создаем табличный документ для вывода отчета
ТабличныйДокумент = Новый ТабличныйДокумент;
// Создаем процессор вывода в табличный документ
ПроцессорВыводаВТабДок = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
ПроцессорВыводаВТабДок.УстановитьДокумент(ТабличныйДокумент);
// Выводим отчет, который теперь содержит объединенные данные
ПроцессорВыводаВТабДок.Вывести(ПроцессорКомпоновкиВывода);
// Показываем сформированный табличный документ пользователю
ТабличныйДокумент.Показать();
Этот программный подход позволяет нам гибко управлять данными, выполнять сложную агрегацию, которая невозможна средствами декларативного описания СКД, и при этом сохранять все преимущества визуализации иерархии и пользовательских настроек отчета. Мы используем СКД там, где она сильна (построение иерархии, запросы), и компенсируем ее ограничения программной обработкой.
В процессе реализации описанного выше подхода мы можем выбрать между использованием одной или двух схем компоновки данных. Рассмотрим оба варианта, чтобы понять, какой из них будет наиболее подходящим в той или иной ситуации.
Использование одной схемы СКД:
В данном случае мы можем использовать одну и ту же схему СКД, которая содержит как основной набор данных (для построения иерархии), так и набор данных типа "Объект" (для агрегированных итогов). Этот вариант, как отметили в обсуждении, может быть проще в реализации, поскольку все настройки пользователя, параметры, отборы и поля уже находятся в одной схеме. Мы сначала используем эту схему для получения детальных записей в таблицу значений (шаги 1-2), затем программно обрабатываем эти данные (шаг 3) и после этого повторно инициализируем процессор компоновки данных с нашей уже обработанной таблицей, передавая ее в набор данных "Объект" (шаг 4), а затем выводим объединенный отчет (шаг 5).
Преимущества:
Недостатки:
Использование двух отдельных схем СКД:
При подходе с двумя схемами мы создаем:
Результаты этих двух схем могут быть объединены в одном отчете программно. Например, первая схема формирует основную часть отчета (иерархию), а вторая — блок с итоговыми данными, который выводится в отдельный раздел табличного документа.
Преимущества:
Недостатки:
ТабличныйДокумент.Вывести() с указанием областей).Выбор между одной и двумя схемами зависит от конкретной сложности задачи, удобства сопровождения и требований к гибкости настроек. Для нашей задачи подсчета итогов по материалам в иерархии детальных записей, вариант с одной схемой, которая используется сначала для извлечения данных, а затем для их объединения с агрегированными результатами через НаборДанныхОбъект, часто оказывается наиболее оптимальным и достаточно простым в реализации.
Помимо основного решения, мы должны рассмотреть несколько дополнительных моментов, которые могут быть полезны при работе с подобными задачами и помогут сделать отчет более гибким и производительным.
1. Установка параметров и отборов:
При работе с программным формированием отчета СКД крайне важно не забывать передавать параметры и устанавливать отборы, которые могли бы быть заданы пользователем через стандартный интерфейс отчета. Это делается через объект Настройки, который мы получаем из схемы компоновки данных. Все пользовательские настройки должны быть учтены при формировании как исходной таблицы, так и итогового отчета.
// Пример получения настроек и установки параметров/отборов
Настройки = СхемаКомпоновкиДанных.НастройкиПоУмолчанию;
// Установка значения параметра
// Найдем параметр "НачалоПериода" в коллекции параметров данных
ЭлементПараметра = Настройки.ПараметрыДанных.Элементы.Найти("НачалоПериода");
Если ЭлементПараметра <> Неопределено Тогда
ЭлементПараметра.Значение = НачалоМесяца(ТекущаяДата());
ЭлементПараметра.Использование = Истина;
КонецЕсли;
// Установка отбора по номенклатуре
ЭлементОтбора = Настройки.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Номенклатура"); // Поле из основного набора данных
ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.ВГруппе;
ЭлементОтбора.ПравоеЗначение = Справочники.Номенклатура.НайтиПоНаименованию("ГотоваяПродукцияГруппа"); // Группа номенклатуры
ЭлементОтбора.Использование = Истина;
// Если нужно добавить отбор, который отсутствует в схеме, сначала добавляем его в список доступных отборов.
// Но в большинстве случаев отбор уже должен быть доступен.
2. Обработка ошибок и производительность:
При работе с большими объемами данных программная выгрузка в таблицу значений и ее последующая обработка может потребовать значительных ресурсов. Мы должны учитывать оптимизацию запросов в самой СКД, а также эффективность алгоритмов обработки таблиц значений в 1С. Для очень больших объемов данных иногда приходится декомпозировать задачу, использовать временные таблицы в запросах для предварительной агрегации (если это возможно без нарушения рекурсивной логики) или применять методы построения запросов с помощью МенеджерВременныхТаблиц.
Соответствие) мы должны стремиться к алгоритмам с минимальной сложностью. Использование Соответствие для быстрого поиска элементов по ключу является хорошей практикой. Для очень больших таблиц можно рассмотреть варианты агрегации через временные таблицы в запросе, если структура позволяет.3. Макетирование вывода:
Если требуется сложный макет вывода итоговой таблицы или ее интеграция с основной иерархией, мы можем использовать макеты СКД, определенные в схеме, или программно формировать области табличного документа. Если мы хотим, чтобы итоговая колонка отображалась прямо в иерархии, связывание наборов данных по "Номенклатуре" внутри СКД является самым удобным способом. В этом случае, даже если набор данных "Объект" заполняется программно, СКД сама "подтянет" нужные данные к каждой строке иерархии согласно настроенной связи. Мы можем настроить внешний вид этой колонки, используя условное оформление или параметры формата в СКД.
4. Гибкость иерархии:
СКД позволяет настраивать внешний вид иерархии, используя различные макеты для группировок или детальных записей. Мы можем использовать эти возможности для более наглядного представления данных. В нашем случае, итоговая колонка будет частью этих детальных записей, и ее отображение можно гибко настроить с помощью стандартных средств СКД.
Рассмотренное решение демонстрирует мощь и гибкость СКД в сочетании с программными возможностями платформы 1С:Предприятие. Оно позволяет преодолеть ограничения стандартных механизмов компоновки данных и построить отчеты, точно отвечающие сложным бизнес-требованиям, таким как подсчет общих итогов в рекурсивной иерархии детальных записей. Ключевым моментом является умение комбинировать декларативный подход СКД с императивным программным кодом для обработки данных в тех случаях, когда стандартных средств оказывается недостаточно.