Как обойти табличную часть формы в 1С

Табличная часть на форме документа или справочника в 1С — это не сам объект данных, а его отображение через реквизит формы типа «ДанныеФормыКоллекция». Поэтому обход строк на управляемой форме отличается от привычного перебора табличной части объекта на сервере: у строк формы нет методов объекта, зато есть идентификаторы строк, а контекст делится на клиентский и серверный.

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

Ниже разобраны рабочие варианты перебора: прямой цикл «Для Каждого», обход через количество строк и индекс, поиск через НайтиСтроки, а также серверный обход через ДанныеФормыВЗначение. Для каждого варианта указаны условия применения, ограничения и типичные ошибки.

Что представляет собой табличная часть на форме

Когда документ открывается в управляемой форме, его табличная часть помещается в реквизит формы. Если основной реквизит формы называется «Объект», то табличная часть доступна как Объект.Товары (или другое имя табличной части). Технически это значение типа «ДанныеФормыКоллекция», а каждая строка — «ДанныеФормыЭлементКоллекции».

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

Простой обход циклом «Для Каждого»

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

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

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

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

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

Обход по индексу и через количество строк

Когда нужен контроль над позицией — например, обход с конца или обращение к соседним строкам — используют цикл по индексу. Коллекция поддерживает обращение по индексу от 0 до Количество() - 1.

&НаСервере
Процедура ОбходПоИндексу()
Для Инд = 0 По Объект.Товары.Количество() - 1 Цикл
Строка = Объект.Товары[Инд];
// работа со строкой
КонецЦикла;
КонецПроцедуры

Обход с конца (Количество() - 1 до 0 с шагом -1) — корректный способ удалять строки по условию без промежуточного массива, потому что удаление не сдвигает ещё не обработанные элементы. Это удобно для очистки строк с нулевым количеством или отменённых позиций.

Поиск строк по условию через НайтиСтроки

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

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

Отбор в НайтиСтроки работает только на равенство и только по полям, реально существующим в табличной части. Условия вида «больше», «содержит», «не равно» через НайтиСтроки не выразить — для них нужен полный перебор с проверкой внутри цикла. Также учтите, что метод ищет по точному совпадению значения, включая тип: число 0 не совпадёт с пустой ссылкой.

1. 1
   Сформируйте структуру отбора: Новый Структура("Поле", Значение)
2. 2
   Вызовите Объект.ТабличнаяЧасть.НайтиСтроки(Отбор) и сохраните массив
3. 3
   Проверьте, что массив не пуст (Найденные.Количество() > 0)
4. 4
   Обойдите массив циклом и выполните нужные изменения
5. 5
   При необходимости обновите связанные итоги или элементы формы

Серверный обход через ДанныеФормыВЗначение

Когда логика тяжёлая — запросы к базе, вызовы менеджеров объектов, массовые проверки — работать с коллекцией формы неудобно и медленно. Правильный приём: на сервере преобразовать реквизит формы в объект, выполнить обход его табличной части и при необходимости вернуть данные обратно.

&НаСервере
Процедура ЗаполнитьЦеныНаСервере()
ДокументОбъект = РеквизитФормыВЗначение("Объект");
Для Каждого Строка Из ДокументОбъект.Товары Цикл
Строка.Цена = ПолучитьЦену(Строка.Номенклатура);
КонецЦикла;
ЗначениеВРеквизитФормы(ДокументОбъект, "Объект");
КонецПроцедуры

Здесь обход идёт по табличной части самого объекта, где доступны все серверные возможности. Но есть цена вопроса: ЗначениеВРеквизитФормы полностью пересоздаёт данные формы, из-за чего сбрасывается текущая строка таблицы на форме и пользовательские динамические настройки отображения. Если важно сохранить позицию курсора, запомните идентификатор текущей строки до преобразования и восстановите после.

Работа с текущей строкой и элементом формы «Таблица»

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

&НаКлиенте
Процедура ОбработатьВыделенные(Команда)
Для Каждого ИдСтроки Из Элементы.Товары.ВыделенныеСтроки Цикл
Строка = Объект.Товары.НайтиПоИдентификатору(ИдСтроки);
Строка.Пометка = Истина;
КонецЦикла;
КонецПроцедуры

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

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

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

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

FAQ