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

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

В этой статье мы разберем 5 основных способов перебора элементов табличных частей — от классического цикла Для Каждого до специализированных методов платформы, таких как НайтиСтроки() и ПолучитьСтроки(). Особое внимание уделим оптимизации производительности при работе с большими таблицами (10 000+ строк) и типичным ошибкам, которые приводят к падению системы. Все примеры приведены с учетом актуальных версий платформы и протестированы на конфигурациях УТ 11, БП 3.0 и ЗУП 3.1.

1. Классический цикл Для Каждого: простота vs производительность

Наиболее интуитивный способ перебора — использование конструкции Для Каждого ... Из ... Цикл. Этот метод подходит для большинства задач, где требуется последовательный обход всех строк без сложных условий фильтрации. Например, так можно рассчитать сумму по колонке "Количество" в табличной части документа "РеализацияТоваровУслуг":

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

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

• 📌 Простота чтения кода — идеален для начинающих разработчиков.
• 🔄 Автоматическая работа с коллекцией — не требует ручного управления индексами.
• 🛠️ Универсальность — работает со всеми типами табличных частей (документов, справочников, регистров).

Однако у этого подхода есть критические недостатки:

• ⚠️ Низкая производительность при работе с большими таблицами (более 5 000 строк). Платформа 1С создает временные объекты для каждой итерации.
• 🚫 Ошибки при изменении коллекции — если внутри цикла добавить или удалить строку, возникнет исключение "Коллекция была изменена".

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

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

Альтернатива Для Каждого — явный перебор строк по их порядковому номеру с помощью свойства Количество() и метода Получить(). Этот подход дает больше контроля над процессом и позволяет модифицировать коллекцию "на лету". Пример кода для обнуления цен в табличной части "Номенклатура":

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

Когда стоит использовать этот метод:

• 🔢 Нужно знать текущий индекс строки (например, для логгирования или условной обработки каждой 10-й строки).
• 🔄 Требуется изменять коллекцию во время перебора (удалять или добавлять строки).
• ⚡ Оптимизация производительности — в некоторых случаях работает быстрее Для Каждого (особенно в управляемых формах).

Важные нюансы:

• Индексация начинается с 0, а не с 1.
• При удалении строки все последующие индексы сдвигаются, что может привести к пропуску элементов. Решение — перебор с конца к началу:

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

3. Метод ПолучитьСтроки(): работа с копией данных

Метод ПолучитьСтроки() возвращает массив строк табличной части, что позволяет обрабатывать данные без привязки к исходному объекту. Это полезно, когда нужно:

• 📊 Отсортировать строки по произвольному критерию (например, по убыванию цены).
• 🔍 Фильтровать данные без изменения оригинальной таблицы.
• 🚀 Параллельная обработка (в фоновых заданиях или при использовании многопоточности в серверных процедурах).

Пример: получение строк табличной части "Услуги" и сортировка по колонке "Сумма":

СтрокиУслуг = ДокументОбъект.Услуги.ПолучитьСтроки();
СтрокиУслуг.СортироватьПо("Сумма Убыв"); // Требует указания направления сортировки

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

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

⚠️ Внимание: Метод ПолучитьСтроки() создает полную копию табличной части в памяти. При работе с таблицами более 50 000 строк это может привести к переполнению памяти сервера 1С. В таких случаях используйте постраничную обработку (см. раздел 5).

4. Специализированные методы: НайтиСтроки() и Выгрузить()

Платформа 1С:Предприятие предоставляет два мощных инструмента для работы с табличными частями:

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

Метод позволяет получить отфильтрованный набор строк по заданным критериям, не перебирая всю таблицу вручную. Например, найдем все строки с количеством больше 10 в табличной части "Товары":

Фильтр = Новый Структура();
Фильтр.Вставить("КоличествоСравнение", ЗначениеПеречисления.Сравнение.Больше);
Фильтр.Вставить("КоличествоЗначение", 10);

НайденныеСтроки = ДокументОбъект.Товары.НайтиСтроки(Фильтр);
Для Каждого Строка Из НайденныеСтроки Цикл
Строка.Цена = Строка.Цена * 0.9; // Скидка 10%
КонецЦикла;

Поддерживаемые условия фильтрации:

• 🔢 Числовые сравнения (Больше, Меньше, Равно).
• 📝 Строковые операции (Содержит, НачинаетсяС).
• 🗓️ Даты (ВДиапазоне, РавноДате).

Выгрузить(): экспорт в таблицу значений

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

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

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

5. Оптимизация для больших таблиц: постраничная обработка

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

• 📄 Метода ВыбратьСтроки() — возвращает выборку строк с поддержкой пагинации.
• 🔄 Циклов с ограничением по времени — обработка порциями по 100–500 строк с паузой.
• 🗃️ Временных таблиц — выгрузка данных в СУБД для сложных операций.

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

РазмерПорции = 200;
КоличествоСтрок = ДокументОбъект.Товары.Количество();
Для Начало = 0 По КоличествоСтрок - 1 Шаг РазмерПорции Цикл
КонецПорции = Мин(Начало + РазмерПорции - 1, КоличествоСтрок - 1);

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

// Пауза для освобождения ресурсов
Если Начало Mod (РазмерПорции * 5) = 0 Тогда
Подождать(1); // Пауза 1 секунда каждые 1000 строк
КонецЕсли;
КонецЦикла;

⚠️ Внимание: При постраничной обработке в клиент-серверном варианте убедитесь, что транзакции не блокируют таблицы на длительное время. Используйте явное управление транзакциями с помощью НачатьТранзакцию() и ЗафиксироватьТранзакцию() для порций данных.

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

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

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

Ситуация: внутри цикла Для Каждого вы удаляете текущую строку. Результат — исключение "Коллекция была изменена".

Решение: Используйте перебор по индексу с конца или собирайте индексы удаляемых строк в массив:

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

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

⚡ Ошибка 2: Забываем про связь с владельцем

При создании новой строки через Добавить() не устанавливаете ссылку на владельца (например, номенклатуру или документ). Это приводит к ошибкам при записи.

Решение: Всегда заполняйте обязательные реквизиты:

НоваяСтрока = ДокументОбъект.Товары.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");
НоваяСтрока.Количество = 1;

🐢 Ошибка 3: Медленный код из-за лишних операций

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

Решение: Кэшируйте данные заранее или используйте пакетные операции:

// Плохо: обращение к справочнику в каждом витке цикла
Для Каждого Строка Из ДокументОбъект.Товары Цикл
Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию(Строка.Наименование);
КонецЦикла;

// Хорошо: предварительная загрузка данных
НоменклатураКэш = Новый Соответствие();
Для Каждого Строка Из ДокументОбъект.Товары Цикл
Если НЕ НоменклатураКэш.Содержит(Строка.Наименование) Тогда
НоменклатураКэш.Вставить(Строка.Наименование, Справочники.Номенклатура.НайтиПоНаименованию(Строка.Наименование));
КонецЕсли;
КонецЦикла;

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

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

Фильтр = Новый Структура("Номенклатура", Справочники.Номенклатура.Товар1);
НайденныеСтроки = ДокументОбъект.Товары.НайтиСтроки(Фильтр);
Если НайденныеСтроки.Количество() > 0 Тогда
ПерваяСтрока = НайденныеСтроки[0];
КонецЕсли;

Процедура ОбработатьТабличнуюЧастьФоново(ДокументОбъект) Экспорт
ТЗ = ДокументОбъект.Товары.Выгрузить();
РазмерПорции = 200;

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

НачатьТранзакцию();
Для Индекс = Начало По КонецПорции Цикл
СтрокаТЗ = ТЗ.Получить(Индекс);
// ... обработка ...
КонецЦикла;
ЗафиксироватьТранзакцию();

Если Начало Mod (РазмерПорции * 10) = 0 Тогда
Подождать(1); // Пауза каждые 2000 строк
КонецЕсли;
КонецЦикла;
КонецПроцедуры