Группировка таблицы значений в 1С: как свернуть строки и просуммировать итоги

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

Метод принимает два списка колонок в виде строк: по каким полям склеивать строки и какие числовые поля суммировать. Строки с одинаковыми значениями в колонках группировки превращаются в одну, а числа в колонках итогов складываются. Всё остальное метод удаляет. Ниже — как это устроено, где метод подводит и чем его заменить.

Как работает метод Свернуть: что происходит со строками

Метод меняет таблицу на месте. Он не возвращает новую таблицу, а перестраивает ту, у которой вызван. Порядок действий внутри такой:

1. Берутся колонки из первого списка (группировка).
2. Строки с одинаковым набором значений в этих колонках объединяются в одну.
3. В объединённой строке колонки из второго списка получают сумму значений всех слитых строк.
4. Колонки, которых нет ни в одном списке, из таблицы исчезают.

Последний пункт чаще всего удивляет новичков. Если в таблице были колонки Номенклатура, Склад, Количество, Комментарий, а вы свернули по Номенклатура с суммой по Количество, колонки Склад и Комментарий пропадут вместе с данными.

Пример на пальцах. Исходная таблица:

После сворачивания по Номенклатура с суммированием Количество, Сумма остаётся две строки:

Проверка: 10 + 5 + 2 = 17 штук болтов, 150 + 75 + 30 = 255 по сумме.

Синтаксис и параметры: как вызвать Свернуть правильно

Общий вид вызова:

Таблица.Свернуть("КолонкиГруппировки", "КолонкиСуммирования");

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

Полный пример с заполнением таблицы:

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Номенклатура");
Таблица.Колонки.Добавить("Склад");
Таблица.Колонки.Добавить("Количество");
Таблица.Колонки.Добавить("Сумма");

Строка = Таблица.Добавить();
Строка.Номенклатура = "Болт М8";
Строка.Склад        = "Основной";
Строка.Количество   = 10;
Строка.Сумма        = 150;

Строка = Таблица.Добавить();
Строка.Номенклатура = "Болт М8";
Строка.Склад        = "Запасной";
Строка.Количество   = 5;
Строка.Сумма        = 75;

Таблица.Свернуть("Номенклатура", "Количество, Сумма");

После вызова в таблице одна строка: Болт М8, количество 15, сумма 225.

Три приёма, без которых метод ломает данные

Сохраните копию, если исходные строки ещё нужны. Метод необратим: слитые строки назад не вернуть. Сделайте копию заранее:

Итоги = Таблица.Скопировать();
Итоги.Свернуть("Номенклатура", "Количество, Сумма");

Теперь Таблица осталась как была, а Итоги содержит свёрнутый результат.

Копируйте только нужные колонки. Если свёртка нужна по двум полям, не тащите в копию двадцать:

Итоги = Таблица.Скопировать(, "Номенклатура, Количество");
Итоги.Свернуть("Номенклатура", "Количество");

Первый параметр Скопировать() — отбор строк, его пропустили; второй — список нужных колонок.

Выгрузите уникальные значения одной колонки. Для списка без дублей есть отдельный метод ВыгрузитьКолонку(), но он вернёт повторы. Если нужен список уникальных номенклатур, свёртка с пустым вторым параметром делает это за один вызов.

Поля группировки и поля итогов: как их выбирать

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

Правила выбора простые:

• ➕ В группировку идут то, по чему вы хотите видеть итоги: номенклатура, контрагент, договор, склад, месяц.
• 🔢 В суммирование идут числа: количество, сумма, НДС, вес.
• ❌ Не ставьте одну колонку в оба списка: её роль станет неоднозначной.
• 🧹 Всё лишнее перед вызовом лучше убрать самим, чтобы не гадать, что осталось.

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

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

Для Каждого Строка Из Таблица Цикл
	Строка.Период = НачалоМесяца(Строка.Период);
КонецЦикла;

Таблица.Свернуть("Период, Номенклатура", "Сумма");

Без этого шага документы одного месяца с разным временем проведения останутся отдельными строками.

Нечисловые данные при свёртке: строки, даты, булево

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

Склеивание текстов выглядит так:

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

Сначала собираете соответствие «ключ → объединённый текст», потом, при необходимости, раскладываете в свёрнутую таблицу.

Колонка с числовым типом, но пустым значением в части строк, ведёт себя безопасно только если тип задан. Для таблицы без типов (Колонки.Добавить("Сумма")) значение может оказаться чем угодно, включая строку.

Скорость на больших таблицах: что делать при сотнях тысяч строк

Свёртка в памяти — операция быстрая, но на миллионе строк с несколькими колонками группировки она заметна. Что помогает:

1. Группируйте на стороне базы. Запрос с СГРУППИРОВАТЬ ПО уменьшит выборку до того, как данные попадут на клиент или в таблицу значений.
2. Отрежьте лишние колонки до свёртки. Чем уже таблица, тем меньше памяти и времени. Для этого и нужен второй параметр Скопировать().
3. Уменьшите число колонок группировки. Каждая добавленная колонка — ещё одно сравнение для каждой пары строк.
4. Выполняйте свёртку на сервере. Не гоняйте большую таблицу между клиентом и сервером: передача объёмной таблицы стоит дороже самой свёртки. Вызывайте метод в серверной процедуре и возвращайте на клиент уже готовый результат.
5. Не сворачивайте в цикле по одной строке. Накопите данные и вызовите метод один раз.

Ориентир такой: до десятков тысяч строк свёртка в памяти не требует оптимизации, дальше имеет смысл мерить время через ТекущаяУниверсальнаяДатаВМиллисекундах() до и после вызова.

Начало = ТекущаяУниверсальнаяДатаВМиллисекундах();
Таблица.Свернуть("Номенклатура, Склад", "Количество, Сумма");
Затрачено = ТекущаяУниверсальнаяДатаВМиллисекундах() - Начало;
Сообщить("Свёртка заняла, мс: " + Формат(Затрачено, "ЧГ=0"));

Если таблица пришла из запроса, самый короткий путь — вообще не сворачивать её потом, а вернуть уже сгруппированной.

Типичные ошибки при сворачивании и как их исправить

Чаще всего проблемы одни и те же. Сверьтесь с таблицей:

Для отладки пригодится проверка набора колонок. Выведите их список прямо перед вызовом:

Для Каждого Колонка Из Таблица.Колонки Цикл
	Сообщить(Колонка.Имя);
КонецЦикла;

Так сразу видно, не вылетела ли нужная колонка на предыдущем шаге.

Чем заменить метод: запрос, группировка вручную, макет отчёта

Метод Свернуть() — не единственный способ получить итоги. Иногда другой подход лучше.

Группировка запросом

Если данные берутся из базы, пусть группирует сама база:

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

Здесь доступны СУММА, МИНИМУМ, МАКСИМУМ, СРЕДНЕЕ, КОЛИЧЕСТВО. Метод таблицы так не умеет: он только складывает. Имя регистра в примере условное, подставьте свой объект.

Запрос к самой таблице значений

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

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

Типы колонок в передаваемой таблице должны быть заданы, иначе запрос не поймёт, как с ними работать.

Цикл с соответствием

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

Что выбрать

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