Как выгрузить результат запроса в дерево значений в 1С

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

Механизм строится на двух элементах: конструкции ИТОГИ ... ПО в тексте запроса и методе Выгрузить(ТипОбходаРезультатаЗапроса.ПоГруппировкамСИерархией). Если в запросе нет итогов или указан неправильный тип обхода, дерево не построится — вы получите либо плоскую таблицу, либо ошибку.

Ниже разобран полный рабочий код, варианты группировок, обход дерева, типичные ошибки и ограничения метода.

Базовый пример: запрос с итогами и выгрузка в дерево

Минимальный рабочий сценарий выглядит так. Запрос выбирает детальные записи и содержит секцию ИТОГИ ПО, где перечислены поля, по которым строится иерархия. Порядок полей в ИТОГИ ПО определяет уровни дерева: первое поле — верхний уровень, последнее — самый глубокий.

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Товары.Номенклатура КАК Номенклатура,
| Товары.Склад КАК Склад,
| СУММА(Товары.Количество) КАК Количество
|ИЗ
| РегистрНакопления.ТоварыНаСкладах.Остатки КАК Товары
|СГРУППИРОВАТЬ ПО
| Товары.Номенклатура,
| Товары.Склад
|ИТОГИ ПО
| Товары.Номенклатура";

РезультатЗапроса = Запрос.Выполнить();
Дерево = РезультатЗапроса.Выгрузить(
 ТипОбходаРезультатаЗапроса.ПоГруппировкамСИерархией);

После выполнения переменная Дерево содержит объект ДеревоЗначений. На верхнем уровне — строки группировки по номенклатуре, внутри каждой — детальные строки по складам. Колонки дерева соответствуют полям выборки запроса.

Обратите внимание: если вызвать Выгрузить() без параметра, будет использован тип обхода ПоГруппировкам по умолчанию в ряде контекстов либо прямой обход — поведение зависит от того, как сформирован результат. Всегда указывайте тип обхода явно, чтобы код был предсказуемым.

Как устроена секция ИТОГИ ПО и почему без неё дерева не будет

Дерево значений строится только из итоговых записей запроса. Секция ИТОГИ ПО Поле1, Поле2 заставляет платформу сформировать для каждого уникального сочетания значений этих полей отдельную итоговую запись, внутрь которой вкладываются детальные строки.

Допустимы два варианта секции итогов:

• ИТОГИ ПО Номенклатура — группировка по элементам; если поле ссылочного типа и ссылка — элемент иерархического справочника, иерархия групп справочника сама по себе не разворачивается, группировка идёт только по значению ссылки.
• ИТОГИ ПО Номенклатура ИЕРАРХИЯ — группировка с разворачиванием иерархии справочника: в дереве появятся родительские группы справочника как промежуточные уровни.

Также доступна конструкция ИТОГИ СУММА(Количество) ПО ОБЩИЕ — она добавляет одну верхнюю строку с общим итогом по всей выборке. Её удобно использовать, когда нужен итог «всего» в корне дерева.

Разница между типами обхода результата запроса

Метод Выгрузить принимает три основных типа обхода, и выбор влияет на итоговую структуру.

Частая ошибка — выбрать ПоГруппировкам и удивляться, что в дереве только один уровень. Для полноценного дерева с детальными строками нужен именно ПоГруппировкамСИерархией.

Как обойти дерево значений после выгрузки

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

Процедура ОбойтиДерево(Строки, Уровень = 0)
 Для Каждого Строка Из Строки Цикл
  Сообщить(Строка.Номенклатура);
  ОбойтиДерево(Строка.Строки, Уровень + 1);
 КонецЦикла;
КонецПроцедуры;

ОбойтиДерево(Дерево.Строки);

У каждой строки дерева доступны свойства Родитель и Уровень(), что позволяет определять положение строки в иерархии. Итоговые строки можно отличить от детальных по заполненности полей: в строке группировки поля более глубоких уровней обычно пустые.

Если дерево нужно показать пользователю, его привязывают к элементу формы «Дерево значений» через реквизит формы соответствующего типа. Для управляемых форм данные передаются через РеквизитФормыВЗначение и ЗначениеВРеквизитФормы.

1. 1
   Сформируйте запрос с детальными полями и секцией ИТОГИ ПО по нужным измерениям
2. 2
   Выполните запрос и получите РезультатЗапроса
3. 3
   Вызовите Выгрузить с типом обхода ПоГруппировкамСИерархией
4. 4
   Проверьте структуру: у строк верхнего уровня должны быть вложенные Строки
5. 5
   Обойдите дерево рекурсивно или выведите его в форму

Типичные ошибки и ограничения метода

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

Помните, что дерево значений — это копия данных в памяти, а не живая ссылка на результат запроса. Изменения в базе после выгрузки в дереве не отразятся; для актуализации запрос нужно выполнить заново.

Проверка результата и альтернативные подходы

После выгрузки полезно убедиться, что структура соответствует ожиданиям. Быстрая проверка — пройти по дереву в отладчике и посмотреть количество уровней и вложенность строк.

Альтернатива выгрузке — прямой обход результата запроса выборкой: РезультатЗапроса.Выбрать(ТипОбходаРезультатаЗапроса.ПоГруппировкамСИерархией). Этот способ экономит память, так как данные читаются последовательно, но не даёт готовой структуры для формы. Выбор зависит от задачи: для отображения в форме — дерево, для разовой обработки больших объёмов — выборка.

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