Как эффективно перебрать строки табличной части в 1С: от простых циклов до сложных алгоритмов

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

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

Особое внимание уделим скрытым ловушкам при работе с большими табличными частями (10 000+ строк), которые могут приводить к зависанию интерфейса или ошибкам памяти. Эти нюансы редко освещают в стандартной документации, но именно они определяют разницу между "работающим" и "эффективным" кодом.

1. Базовый перебор строк: цикл Для Каждого

Начнем с самого простого и интуитивно понятного метода — цикла Для Каждого...Из...Цикл. Этот подход идеально подходит для начинающих разработчиков и небольших табличных частей (до 1 000 строк). Его основное преимущество — лаконичный синтаксис и автоматическая обработка коллекции.

Пример кода для перебора строк табличной части документа РеализацияТоваровУслуг:

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

Важно понимать, что в этом цикле переменная СтрокаТовар представляет собой ссылку на текущую строку, а не её копию. Это означает:

• 🔹 Изменения свойств строки (например, СтрокаТовар.Количество = 10) сразу отразятся в табличной части
• 🔹 Удаление строки через СтрокаТовар.Удалить() приведет к ошибке (нужно использовать ДокументОбъект.Товары.Удалить(СтрокаТовар))
• 🔹 Добавление новых строк в процессе перебора может вызвать бесконечный цикл

⚠️ Внимание: При работе с большими табличными частями (более 5 000 строк) цикл Для Каждого может значительно тормозить интерфейс. В таких случаях рассмотрите альтернативные методы из следующих разделов.

2. Перебор по индексу: когда нужен контроль над порядком

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

Пример обратного перебора (с последней строки к первой):

КолВоСтрок = ДокументОбъект.Товары.Количество();
Для Инд = КолВоСтрок По 1 Убыв Цикл
ТекущаяСтрока = ДокументОбъект.Товары.Получить(Инд - 1); // Индексация с 0!
Если ТекущаяСтрока.Количество = 0 Тогда
ДокументОбъект.Товары.Удалить(ТекущаяСтрока);
КонецЕсли;
КонецЦикла;

Ключевые особенности этого метода:

• 📌 Индексация строк начинается с 0 (первая строка имеет индекс 0)
• 📌 Метод Получить() возвращает копию строки, а не ссылку (в отличие от цикла Для Каждого)
• 📌 Позволяет безопасно удалять строки во время перебора (при движении с конца)

⚠️ Внимание: При использовании метода Получить() помните, что он создает копию строки. Если вам нужно изменить оригинальную строку, используйте метод ДокументОбъект.Товары[Индекс] (но это работает только в управляемых формах).

3. Метод НайтиСтроки(): фильтрация без циклов

Когда нужно обработать только строки, соответствующие определенному условию, оптимальным решением становится метод НайтиСтроки(). Он возвращает массив строк, удовлетворяющих заданному критерию, что избавляет от необходимости проверять каждое условие вручную.

Пример поиска строк с нулевым количеством:

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

Преимущества этого метода:

• ⚡ Значительно быстрее ручного перебора при сложных условиях
• 🎯 Позволяет использовать составные критерии (например, диапазон дат + определенный контрагент)
• 🔄 Возвращает динамический массив, который можно дальнейшем модифицировать

Однако есть и ограничения:

• 🚫 Не работает с вычисляемыми полями (только с хранящимися в табличной части)
• 🚫 Синтаксис условия должен строго соответствовать структуре данных
• 🚫 При частом вызове может снижать производительность

4. Выгрузка в массив: работа с большими данными

Когда табличная часть содержит тысячи строк, стандартные методы перебора могут приводить к "подвисанию" интерфейса. В таких случаях опытные разработчики используют прием выгрузки данных в массив с последующей обработкой. Этот подход особенно актуален для фонового выполнения или обработки в транзакциях.

Пример оптимизированной обработки:

// Выгружаем данные в массив
МассивСтрок = ДокументОбъект.Товары.Выгрузить();

// Обрабатываем массив (без блокировки интерфейса)
Для Каждого Строка Из МассивСтрок Цикл
Если Строка.Цена < 100 Тогда
Строка.Цена = 100; // Изменяем в массиве
КонецЕсли;
КонецЦикла;

// Загружаем обратно измененные данные
ДокументОбъект.Товары.Загрузить(МассивСтрок);

Преимущества этого подхода:

• 🚀 Минимизирует нагрузку на интерфейс при работе с большими объемами
• 🔄 Позволяет легко откатывать изменения (достаточно не выполнять Загрузить())
• 📊 Удобно для сложных вычислений с промежуточными результатами

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

Выгрузить данные в массив|Обработать массив в фоновом задании|Использовать пакетные операции|Проверить память после обработки|Загрузить изменения обратно-->

5. Пакетная обработка: транзакции и производительность

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

Пример транзакционной обработки:

НачатьТранзакцию();
Попытка
// Выгружаем данные
МассивСтрок = ДокументОбъект.Товары.Выгрузить();

// Обрабатываем в пакете по 100 строк
РазмерПакета = 100;
КолВоПакетов = Цел(МассивСтрок.Количество() / РазмерПакета) + 1;

Для НомерПакета = 1 По КолВоПакетов Цикл
НачалоПакета = (НомерПакета - 1) * РазмерПакета;
КонецПакета = Мин(НачалоПакета + РазмерПакета - 1, МассивСтрок.Количество() - 1);

Для Инд = НачалоПакета По КонецПакета Цикл
МассивСтрок[Инд].Сумма = МассивСтрок[Инд].Количество * МассивСтрок[Инд].Цена;
КонецЦикла;
КонецЦикла;

// Загружаем изменения
ДокументОбъект.Товары.Загрузить(МассивСтрок);
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка обработки: " + ОписаниеОшибки());
КонецПопытки;

Ключевые принципы пакетной обработки:

• 📦 Разбивайте большие операции на пакеты по 100-500 строк
• 🔄 Используйте транзакции для обеспечения целостности данных
• ⏱ Добавляйте таймауты для долгих операций (через ПрерватьОжидание())
• 📊 Ведите лог обработки для отладки

6. Типичные ошибки и как их избежать

Даже опытные разработчики иногда допускают ошибки при работе с табличными частями. Вот наиболее распространенные проблемы и способы их решения:

Ошибка 1: Изменение коллекции во время перебора

При использовании цикла Для Каждого попытка добавить или удалить строку приводит к исключению. Решение — использовать обратный перебор по индексу или собирать строки для удаления в отдельный массив.

Ошибка 2: Работа с несуществующими строками

Обращение к строке по индексу, превышающему Количество() - 1, вызывает ошибку. Всегда проверяйте границы:

Если Индекс < ДокументОбъект.Товары.Количество() Тогда
Строка = ДокументОбъект.Товары.Получить(Индекс);
КонецЕсли;

Ошибка 3: Неучет изменений при выгрузке/загрузке

Методы Выгрузить()/Загрузить() не сохраняют некоторые свойства строк (например, пометки удаления). Для критических операций используйте транзакции.

Ошибка 4: Забывают про реквизиты табличной части

При копировании строк не забывайте про реквизиты табличной части (если они есть):

НоваяСтрока = ДокументОбъект.Товары.Добавить();
НоваяСтрока.Заполнить(ИсходнаяСтрока); // Копирует все реквизиты

FAQ: Ответы на частые вопросы

Для Каждого Строка Из ЭлементыФормы.ТабличнаяЧастьТовары Цикл
// Обработка строки
КонецЦикла;

Процедура ВыполнитьОбработкуНаСервере()
Данные = ДокументОбъект.Товары.Выгрузить();
// Обработка данных
ДокументОбъект.Товары.Загрузить(Данные);
ДокументОбъект.Записать();
КонецПроцедуры

МассивКоличеств = ДокументОбъект.Товары.ВыгрузитьКолонку("Количество");
МассивЦен = ДокументОбъект.Товары.ВыгрузитьКолонку("Цена");

// Параллельная обработка (требует 1С:Предприятие 8.3.14+)
Результаты = Новый Массив();
Параллельно Для Каждого Количество Из МассивКоличеств Индексом Инд Цикл
Результаты.Добавить(Количество * МассивЦен[Инд]);
КонецЦикла;

Макет = Отчет.Макеты.Товары;
Для Каждого Строка Из Макет Цикл
// Обработка строки макета
КонецЦикла;