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

Другое · 8 мин

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

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

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

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

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

Что такое табличная часть и где она используется

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

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

Как получить доступ к строкам табличной части

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

Пример обращения к табличной части в модуле документа:

Для Каждого СтрокаТаблицы Из Объект.ТабличнаяЧасть Цикл
// действия с СтрокаТаблицы
КонецЦикла;

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

Порядок действий
  1. 1
    Откройте модуль документа или серверную процедуру обработки
  2. 2
    Получите объект документа по ссылке, если это необходимо
  3. 3
    Обратитесь к свойству табличной части через Объект
  4. 4
    Организуйте цикл перебора строк
  5. 5
    Выполните проверку, изменение или запись
  6. 6
    Проверьте результат после сохранения документа

Организация цикла перебора строк

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

Перебор с условием

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

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

Если Строка.Количество <= 0 Тогда
Продолжить;
КонецЕсли;

// основная обработка строки
КонецЦикла;

Перебор с индексом

Если нужно знать порядковый номер строки или обращаться к строкам по индексу, используется цикл Для с границами от 1 до Количества() табличной части. Обращение к строке выполняется через метод Получить(Индекс). Это удобно, когда требуется сравнить текущую строку с предыдущей или следующей.

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

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

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

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

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

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

Типичные ошибки
01
Изменение или удаление строк при прямом переборе приводит к пропуску строк
02
Обращение к табличной части через форму вместо объекта в серверном коде
03
Сохранение изменений без записи документа
04
Игнорирование режима документа и блокировок при проведённом документе

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

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

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

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

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

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

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

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

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

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

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

Изменения применены к нужным строкам

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

Значения не изменились или изменились не те строки

Запись документа
Норма

Документ сохранён без ошибок

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

Ошибка записи или блокировка объекта

Когда стоит использовать альтернативные способы

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

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

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

Итог

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

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

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

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

Можно ли удалять строки табличной части внутри цикла Для Каждого?

Не рекомендуется. Удаление сдвигает строки коллекции и может привести к пропуску элементов. Безопаснее собирать строки для удаления или перебирать коллекцию в обратном порядке.

Что делать, если строки не сохраняются после обработки?

Убедитесь, что изменения вносились в объект документа, а не только в форму, и что после обработки выполнена запись документа. Также проверьте права доступа и режим документа.

Как перебрать только заполненные строки?

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

Подходит ли перебор строк для обработки многих документов сразу?

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