1С: обход результата запроса по группировкам и деталям

1С: обход результата запроса по группировкам — минимальный запрос

Полный запрос ниже создаёт три строки из литералов: А/X/2, А/Y/3, Б/Z/4. Он не читает документы, справочники и регистры. Вставьте его в Консоль запросов; для программного обхода используйте самостоятельные BSL-фрагменты ниже. Длинная вторая строка — только подготовка собственных данных.

ВЫБРАТЬ Д.Группа, Д.Позиция, Д.Количество
ИЗ (ВЫБРАТЬ "А" КАК Группа, "X" КАК Позиция, 2 КАК Количество ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ "А", "Y", 3 ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ "Б", "Z", 4) КАК Д
УПОРЯДОЧИТЬ ПО Группа, Позиция
ИТОГИ СУММА(Количество) ПО Группа

В секции ВЫБРАТЬ число не агрегируется: исходные детали сохраняются. Сумма считается в ИТОГИ: для группы А — 5, для Б — 4. УПОРЯДОЧИТЬ ПО Группа, Позиция задаёт сортировку по полям результата. Ниже показан ожидаемый состав сообщений; порядок групп при обходе итогов этим примером не доказан.

Группы и вложенные детали без ОБЩИЕ

Место вставки — тело серверной процедуры общего модуля либо серверная Консоль кода. В модуле управляемой формы поместите тело в процедуру с директивой &НаСервереБезКонтекста и вызовите её штатным способом. Реквизиты формы, параметры и типовые общие модули не нужны. Не выполняйте этот код непосредственно в тонком или веб-клиенте.

Запрос = Новый Запрос;
Запрос.Текст =
    "ВЫБРАТЬ Д.Группа, Д.Позиция, Д.Количество
    |ИЗ (ВЫБРАТЬ ""А"" КАК Группа, ""X"" КАК Позиция, 2 КАК Количество ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ ""А"", ""Y"", 3 ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ ""Б"", ""Z"", 4) КАК Д
    |УПОРЯДОЧИТЬ ПО Группа, Позиция
    |ИТОГИ СУММА(Количество) ПО Группа";
Результат = Запрос.Выполнить();

Группы = Результат.Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам);
Пока Группы.Следующий() Цикл
    Сообщить("Группа " + Группы.Группа + ": " + Строка(Группы.Количество));
    Детали = Группы.Выбрать(ОбходРезультатаЗапроса.Прямой);
    Пока Детали.Следующий() Цикл
        Сообщить("  " + Детали.Позиция + ": " + Строка(Детали.Количество));
    КонецЦикла;
КонецЦикла;

Ожидаемый состав пяти сообщений для этих литералов (целые числа меньше 10), не журнал платформы. Порядок А/Б и X/Y показан иллюстративно; детали выводятся после своей группы:

Группа А: 5
  X: 2
  Y: 3
Группа Б: 4
  Z: 4

Первый Выбрать() вызывается у РезультатЗапроса. Второй — у ВыборкаИзРезультатаЗапроса внутри цикла после успешного Следующий(). Это разные получатели одного имени метода. Создание выборки ещё не позиционирует её на строке.

ОБЩИЕ: дополнительная выборка верхнего итога

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

Запрос = Новый Запрос;
Запрос.Текст =
    "ВЫБРАТЬ Д.Группа, Д.Позиция, Д.Количество
    |ИЗ (ВЫБРАТЬ ""А"" КАК Группа, ""X"" КАК Позиция, 2 КАК Количество ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ ""А"", ""Y"", 3 ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ ""Б"", ""Z"", 4) КАК Д
    |УПОРЯДОЧИТЬ ПО Группа, Позиция
    |ИТОГИ СУММА(Количество) ПО ОБЩИЕ, Группа";
Результат = Запрос.Выполнить();

ОбщийИтог = Результат.Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам);
Если ОбщийИтог.Следующий() Тогда
    Сообщить("Всего: " + Строка(ОбщийИтог.Количество));
    Группы = ОбщийИтог.Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам);
    Пока Группы.Следующий() Цикл
        Сообщить("Группа " + Группы.Группа + ": " + Строка(Группы.Количество));
        Детали = Группы.Выбрать(ОбходРезультатаЗапроса.Прямой);
        Пока Детали.Следующий() Цикл
            Сообщить("  " + Детали.Позиция + ": " + Строка(Детали.Количество));
        КонецЦикла;
    КонецЦикла;
КонецЕсли;

Ожидаемый состав шести сообщений, не журнал платформы. «Всего: 9» выводится перед вложенным циклом по коду; взаимный порядок групп и деталей ниже показан иллюстративно, а не подтверждён запуском. Детали выводятся после своей группы.

Всего: 9
Группа А: 5
  X: 2
  Y: 3
Группа Б: 4
  Z: 4

Почему видна только верхняя группа

Проверьте порядок после ПО в секции ИТОГИ. Без ОБЩИЕ верхний уровень здесь — А и Б; с ОБЩИЕ — единственная запись общего итога. Один внешний цикл не раскрывает все уровни автоматически.

Если добавить ещё одно поле группировки после Группа, для его итогов потребуется ещё один вложенный обход ПоГруппировкам. Прямой обход от текущей группы нужен для деталей, а не для вывода промежуточных итоговых строк.

Имя группировки можно явно передать вторым параметром Выбрать() и выбрать нужный уровень. Наличие ОБЩИЕ не делает этот приём ошибочным: официальная статья ИТС использует именованную группировку напрямую от результата. В примерах выше выбран последовательный обход всех уровней без пропуска общего итога.

Параметры Выбрать и правильное имя перечисления

Сигнатура у обоих получателей: Выбрать(<ТипОбхода>, <Группировки>, <ГруппировкиДляЗначенийГруппировок>); все параметры необязательны. ТипОбхода — имя параметра, а перечисление называется ОбходРезультатаЗапроса, не «ТипОбходаРезультатаЗапроса».

• Прямой — обход детальных записей; это значение по умолчанию.
• ПоГруппировкам — обход итоговых группировок, предусмотренных запросом.
• Пропущенный второй параметр означает следующую группировку из ИТОГИ. Явная пустая строка означает детальные записи: эти случаи нельзя отождествлять.
• Третий параметр «Все» нужен, например, для полного набора колонок кросс-отчёта, а не для обычной детализации текущей группы. В наших примерах он не задан: расширять набор значений незачем.

Группировки итогов не равны иерархии справочника. У примеров строковые ключи, поэтому отдельный режим обхода иерархии ссылочных данных не нужен.

ИТОГИ не заменяет СГРУППИРОВАТЬ ПО

При СГРУППИРОВАТЬ ПО Группа и сумме в SELECT две строки А превращаются в одну агрегированную запись; исходных X и Y в таком результате уже нет. ИТОГИ нашего запроса оставляет X и Y деталями и добавляет сумму А отдельным уровнем. Обход не способен восстановить строки, которые запрос заранее свернул.

Здесь решается именно программный обход выборок. Получение таблицы или дерева значений — отдельный сценарий выгрузки результата запроса; настройки итогов СКД в этот рецепт не входят.

Частые ошибки при обходе по группировкам

• Нет ИТОГИ в запросе. Режим обхода сам не добавляет отсутствующие группировки; задайте их в тексте.
• Чтение поля до Следующий(). Сначала позиционируйте выборку, затем обращайтесь к полям или создавайте вложенную выборку.
• Каждый раз берут детали от Результат. Так получается общий набор деталей вместо подчинённого: получателем должен быть текущий узел группы.
• Остановились на ОБЩИЕ. Для групп и деталей нужны вложенные выборки.
• Сложили общую сумму, суммы групп и детали. Это повторный учёт одних данных; для расчёта выбирайте один нужный уровень, не суммируйте все уровни вместе.
• Перенесли серверный запрос в клиентский обработчик. Объекты запроса и выборки в тонком и веб-клиенте недоступны; выполняйте весь обход на сервере.

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