К статье
Практический материал

Другое · 8 мин

Как перебрать все строки в табличном поле 1С

Практическая инструкция по обходу строк табличного поля на форме 1C: способы доступа по индексу и коллекции, текущая и выделенная строка, редактирование, удаление и частые ошибки.

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

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

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

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

H2: Как получить доступ к строкам табличного поля

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

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

Пример чтения через коллекцию:

Порядок обхода строк
  1. 1
    Откройте форму и найдите элемент табличного поля
  2. 2
    Выберите способ обхода: через коллекцию Строки или по индексу
  3. 3
    Обратитесь к реквизитам строки по имени
  4. 4
    Проверьте результат после обработки
Для Каждого СтрокаТаблицы Из ЭлементыФормы.МояТаблица.Строки Цикл
Сообщить(СтрокаТаблицы.Номенклатура);
КонецЦикла;

Пример чтения по индексу:

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

H2: Текущая, выделенная и редактируемая строка

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

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

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

H2: Изменение и удаление строк при переборе

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

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

Контрольные точки

Как проверить результат

Количество обработанных строк
Норма

Совпадает с количеством строк в поле до начала изменений

Тревожный признак

Меньше ожидаемого или ошибка доступа к индексу

Значения после редактирования
Норма

Отображаются на форме и сохраняются при записи документа

Тревожный признак

Значения сбрасываются или не появляются после записи

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

H2: Проверка результата и границы самостоятельной работы

После обхода строк убедитесь, что все ожидаемые значения прочитаны или изменены. Можно вывести контрольную сумму, количество обработанных строк или сравнить данные до и после операции. Если изменения не отображаются, проверьте режим редактирования, активность формы и наличие несохранённых правок пользователя.

Типичные ошибки
01
Обращение к строке с индексом, равным количеству строк, вызывает ошибку
02
Удаление строк в цикле от начала к концу пропускает строки из-за сдвига индексов
03
Изменение значения без завершения редактирования не фиксируется в форме

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

Если табличное поле связано с большим объёмом данных, обход всех строк на клиенте может замедлить работу формы. В таких случаях целесообразно фильтровать данные до отображения или переносить тяжёлые расчёты на сервер, если конфигурация это позволяет.

Сравнение вариантов обхода

Коллекция Строки

Подходит для чтения и простой обработки всех строк без привязки к позиции

Цикл по индексу

Удобен для удаления, сравнения соседей и работы с порядковым номером, требует осторожности с границами

Выделенные строки

Используется, когда нужно обработать только строки, отмеченные пользователем

H2: Сравнение подходов к обходу

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

Если нужно обработать только выделенные пользователем строки, обычный перебор всех строк не подходит. В этом случае работа ведётся с набором выделенных строк, а не со всей таблицей. Неправильный выбор набора приведёт к обработке лишних данных или пропуску нужных строк.

Итог

Что важно запомнить

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

Можно ли перебирать строки табличного поля на сервере?

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

Что делать, если после изменения ячейки значение не сохраняется?

Проверьте, находится ли табличное поле в режиме редактирования и завершено ли редактирование строки. Также убедитесь, что форма не отменяет изменения при перемещении фокуса, и что документ или справочник записан после внесения правок.

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

Удаляйте строки в обратном порядке: от последней к первой. Если удалять от начала к концу, индексы оставшихся строк сдвигаются, и часть строк будет пропущена или обработана некорректно.

В чём разница между текущей и выделенной строкой?

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

Нужно ли фиксировать количество строк перед циклом?

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