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

Другое · 8 мин

Обход табличной части в 1С: циклы, отбор и проверка строк

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

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

В встроенном языке 1С основные инструменты — цикл «Для каждого» и индексный цикл по номерам строк. Первый удобен для чтения и записи в существующие строки, второй — когда нужен порядковый номер или доступ к строке по индексу. Оба варианта работают с табличной частью как с коллекцией, но ведут себя по-разному при изменении коллекции во время обхода.

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

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

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

Важно различать обычные и управляемые формы: в управляемых приложениях табличная часть может отображаться в элементе формы «Табличное поле», а данные живут в объекте на сервере или клиенте в зависимости от режима работы. Это влияет на то, где именно выполняется код обхода и как быстро происходит доступ к строкам.

Основные способы обхода строк табличной части

Цикл «Для каждого» по строкам табличной части

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

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

Порядок действий
  1. 1
    Откройте форму документа и найдите реквизит табличной части
  2. 2
    Выберите цикл «Для каждого» для чтения или индексный для доступа по номеру
  3. 3
    Добавьте условие отбора и проверьте результат на тестовом документе

Индексный обход по номерам строк

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

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

Изменение и удаление строк во время обхода

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

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

Цикл «Для каждого»Чтение и запись в строки

Подходит для простого обхода, не подходит для удаления строк внутри цикла

Индексный циклДоступ по номеру строки

Удобен для сравнения соседних строк и нумерации

Пометка удаленияСтрока исключена пользователем

Проверяйте явно, нужны ли такие строки в расчёте

Отбор строк и работа с пометкой удаления

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

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

Типичные ошибки
01
Удаление строк внутри цикла «Для каждого» приводит к пропуску строк и потере данных
02
Забывание про строки с пометкой удаления искажает итоговые суммы
03
Отсутствие проверки результата после записи делает ошибки невидимыми до сверки с первичкой

Перенос в таблицу значений и использование запросов

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

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

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

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

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

Совпадает с ожидаемым или изменено согласно условию

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

Меньше строк, чем должно быть, без объяснения

Итоговые суммы по табличной части
Норма

Схожи с первичными данными и отчётами

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

Расходятся с источником без видимой причины

Проводки и движения по регистрам
Норма

Отображаются корректно после проведения

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

Отсутствуют или дублируются движения

Частые ошибки и проверка результата

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

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

Итог

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

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

Можно ли удалять строки табличной части прямо в цикле «Для каждого»?

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

Нужно ли исключать строки с пометкой удаления из расчёта?

Зависит от задачи. Такие строки остаются в табличной части до записи объекта, поэтому при обходе они будут доступны, если не добавить явное условие исключения. Уточните, должны ли они участвовать в итогах, иначе расчёты могут быть неверными.

Когда лучше использовать таблицу значений вместо прямого обхода?

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

Как проверить, что обход табличной части прошёл корректно?

Сравните количество строк и итоговые значения до и после обработки, проверьте проведение документа и движения по регистрам. Любое несоответствие с первичными данными должно быть объяснено условием отбора или логикой изменения.