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

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

Статья будет полезна как начинающим разработчикам, так и опытным программистам, которые хотят систематизировать знания или найти более эффективные решения для своих задач.

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

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

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

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

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


КонецЦикла;

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

  • ✅ Простота и читаемость кода
  • ✅ Подходит для небольших таблиц (до 1000 строк)
  • ⚠️ Риск зависания при обработке больших массивов (10 000+ строк)
  • ⚠️ Изменения в цикле применяются сразу к исходной таблице
💡

Если вам нужно только прочитать данные без изменений, добавьте модификатор ПрямойОбход для ускорения: Для Каждого Строка Из Таблица Цикл ПрямойОбход. Это подскажет платформе, что порядок обхода не важен, и она сможет оптимизировать процесс.

2. Перебор с использованием индексов: Для и Пока

Альтернативный подход — обход таблицы по индексам с помощью циклов Для или Пока. Этот метод даёт больше контроля над процессом, например, позволяет пропускать строки или обходить таблицу в обратном порядке. Также он полезен, когда нужно работать с номерами строк или обращаться к элементам по конкретному индексу.

Пример обратного перебора (с конца к началу):

КоличествоСтрок = ДокументОбъект.Товары.Количество();

Для Индекс = КоличествоСтрок По 1 Цикл


Строка = ДокументОбъект.Товары[Индекс - 1]; // Индексация с 0!


Сообщить(Строка.Номенклатура);


КонецЦикла;

Особенности этого метода:

  • 🔢 Точный контроль над порядком обхода (можно начинать с любой строки)
  • 🔄 Возможность пропуска строк с помощью Продолжить
  • ⚠️ Опасность выхода за границы массива, если неверно рассчитать количество строк
  • 🐢 Медленнее, чем Для Каждого, для больших таблиц

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

📊 Какой цикл вы чаще используете для перебора таблиц в 1С?
Для Каждого
Для (по индексу)
Пока
Не знаю разницы

3. Методы платформы: НайтиСтроки() и Получить()

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

Пример использования НайтиСтроки() для поиска строк с количеством больше 10:

РезультатыПоиска = ДокументОбъект.Товары.НайтиСтроки(Новый Структура("Количество", Новый Число(10)), "Количество > Значение");

Для Каждого НайденнаяСтрока Из РезультатыПоиска Цикл


Сообщить(НайденнаяСтрока.Номенклатура);


КонецЦикла;

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

Метод Преимущества Ограничения
НайтиСтроки() ⚡ Быстрый поиск по условию
🔍 Поддерживает сложные фильтры		 📌 Требует знания синтаксиса запросов
🔄 Не подходит для последовательной обработки всех строк
Получить() 🎯 Точный доступ по ключу
⚡ Мгновенный результат		 🔑 Требует уникального идентификатора строки
🚫 Не работает без ключевого поля

Эти методы особенно полезны в серверных процедурах, где важна производительность. Однако они требуют более глубокого понимания структуры данных и синтаксиса платформы. Например, если ключевое поле не задано, метод Получить() вернёт ошибку.

Как работает метод НайтиСтроки() внутри?

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

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

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

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

Выборка = ДокументОбъект.Товары.Выбрать();

Пока Выборка.Следующий() Цикл


// Обработка пакета из 1000 строк


Счётчик = 0;


Пока Счётчик < 1000 И Выборка.Следующий() Цикл


Счётчик = Счётчик + 1;


// Обработка текущей строки


КонецЦикла;


// Сохранение промежуточных результатов


Если НЕ Выборка.Следующий() Тогда


Прервать;


КонецЕсли;


КонецЦикла;

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

  • 📦 Разбиение на порции фиксированного размера (обычно 500–2000 строк)
  • 💾 Регулярное сохранение промежуточных данных (например, в регистры или временные таблицы)
  • ⏱️ Контроль времени выполнения (для фоновых задач)
  • ⚠️ Избегайте блокировки интерфейса — используйте фоновые задания или прогресс-бары

Для особенно крупных таблиц (100 000+ строк) рекомендуется переносить обработку на сервер или использовать внешние обработки с оптимизированными алгоритмами. В некоторых случаях целесообразно выгрузить данные во временную таблицу базы данных и работать с ней через запросы.

1. Оценить объём данных (количество строк)

2. Определить размер пакета (оптимально 1000–2000 строк)

3. Подготовить механизм сохранения промежуточных результатов

4. Проверить наличие индексов на ключевых полях

5. Тестировать на копии базы данных-->

5. Работа с табличными частями в управляемых формах

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

Пример корректного обхода таблицы в управляемой форме:

// На клиенте

ТаблицаТоваров = ЭлементыФормы.Товары.Значение;


Для Каждого Строка Из ТаблицаТоваров Цикл


Если Строка.Количество > 100 Тогда


Строка.Цена = Строка.Цена * 0.9; // Скидка 10%


КонецЕсли;


КонецЦикла;

Особенности работы в управляемых формах:

  • 🖥️ Изменения в таблице на клиенте не сохраняются автоматически в базе
  • 🔄 Для отображения изменений может потребоваться вызов Обновить()
  • ⚡ Для сложных операций лучше переносить логику на сервер
  • ⚠️ Не используйте Для Каждого для больших таблиц на клиенте — это заблокирует интерфейс

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

💡

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

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

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

⚠️ Внимание: Изменение коллекции (добавление/удаление строк) в цикле Для Каждого без предварительного копирования приводит к ошибке "Коллекция была изменена". Всегда создавайте копию таблицы перед модификацией!

Пример неправильного кода:

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

Если Строка.Количество = 0 Тогда


ДокументОбъект.Товары.Удалить(Строка); // ОШИБКА!


КонецЕсли;


КонецЦикла;

Правильный вариант:

ТаблицаКопия = ДокументОбъект.Товары.Скопировать();

Для Каждого Строка Из ТаблицаКопия Цикл


Если Строка.Количество = 0 Тогда


ДокументОбъект.Товары.Удалить(Строка);


КонецЕсли;


КонецЦикла;

Другие распространённые ошибки:

  • 🔄 Забывают сбросить пометку удаления после обработки, что приводит к потере данных
  • 📊 Не учитывают пустые строки, из-за чего сбиваются расчёты
  • 🔑 Используют неключевые поля для метода Получить(), что вызывает ошибки
  • ⏳ Не оптимизируют циклы для больших таблиц, вызывая зависания

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

7. Альтернативные подходы: запросы и временные таблицы

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

  • 🔍 Выполнить сложную фильтрацию или группировку
  • 📊 Получить сводные данные (например, сумму по группам номенклатуры)
  • ⚡ Обработать очень большой объём данных (100 000+ строк)

Пример использования запроса для анализа табличной части:

Запрос = Новый Запрос;

Запрос.Текст =


"ВЫБРАТЬ


|  Товары.Номенклатура КАК Номенклатура,


|  СУММА(Товары.Количество) КАК ИтогоКоличество


|ИЗ


|  Документ.РеализацияТоваровУслуг.Товары КАК Товары


|ГДЕ


|  Товары.Ссылка = &СсылкаНаДокумент


|СГРУППИРОВАТЬ ПО


|  Товары.Номенклатура";


Запрос.УстановитьПараметр("СсылкаНаДокумент", ДокументОбъект.Ссылка);


Результат = Запрос.Выполнить();

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

  • ⚡ Высокая скорость даже для миллионов строк
  • 🛠️ Гибкие возможности анализа (группировка, сортировка, joins)
  • 🔄 Можно комбинировать данные из нескольких таблиц

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

💡

Если вам нужно обновить данные на основе результатов запроса, используйте конструкцию ОБНОВИТЬ в самом запросе. Это позволит сделать изменения атомарно и значительно быстрее, чем построчный обход.

FAQ: Частые вопросы по перебору табличных частей

Можно ли использовать Продолжить и Прервать в цикле Для Каждого?

Да, эти операторы полностью поддерживаются. Продолжить пропускает текущую итерацию и переходит к следующей строке, а Прервать полностью завершает цикл. Например:

Для Каждого Строка Из Таблица Цикл

Если Строка.Количество <= 0 Тогда


Продолжить; // Пропустим пустые строки


КонецЕсли;


Если Строка.Цена < 0 Тогда


Прервать; // Завершим цикл при отрицательной цене


КонецЕсли;


КонецЦикла;

Как перебрать табличную часть в обратном порядке?

Для этого удобно использовать цикл Для с индексами, начиная с последней строки:

Количество = Таблица.Количество();

Для i = Количество По 1 Цикл


Строка = Таблица[Количество - i];


// Обработка строки


КонецЦикла;

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

Почему при удалении строк в цикле пропускаются элементы?

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

// Правильный способ (обратный обход)

Для i = Таблица.Количество() По 1 Цикл


Если Таблица[i-1].ПометкаУдаления Тогда


Таблица.Удалить(i-1);


КонецЕсли;


КонецЦикла;

Как ускорить перебор таблицы с 50 000 строк?

Для таких объёмов данных:

  1. Используйте пакетную обработку (по 1000–2000 строк за итерацию).
  2. Перенесите логику на сервер (в серверную процедуру).
  3. Если возможно, используйте запросы вместо построчного обхода.
  4. Отключите обновление интерфейса на время обработки (НачатьИзменение()/ЗакончитьИзменение()).

Также проверьте, есть ли индексы на полях, по которым выполняется фильтрация.

Можно ли перебирать табличную часть в фоновом задании?

Да, это один из лучших способов обработки больших таблиц. Фоновое задание выполнит операцию без блокировки интерфейса пользователя. Пример:

ФоновоеЗадание = ФоновыеЗадания.Создать("ОбработкаТабличнойЧасти");

ФоновоеЗадание.Параметры.Документ = ДокументОбъект.Ссылка;


ФоновоеЗадание.Выполнить();

В самом фоновом задании используйте серверные методы для работы с данными.