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

Другое · 6 мин

Перебор табличной части документа 1С 8.3

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

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

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

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

Перебор строк в модуле объекта

В модуле объекта документа табличная часть доступна как реквизит объекта, например Объект.Товары. Для перебора используется цикл «Для Каждого ... Из»: Для Каждого Строка Из Объект.Товары Цикл ... КонецЦикла.

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

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

Порядок действий
  1. 1
    Откройте модуль объекта документа и найдите реквизит табличной части.
  2. 2
    Напишите цикл Для Каждого Строка Из Объект.ИмяТабличнойЧасти Цикл.
  3. 3
    Обращайтесь к полям через Строка.ИмяПоля и вносите изменения.
  4. 4
    Завершите цикл и вызовите Объект.Запись() для сохранения.

Доступ к табличной части из модуля формы

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

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

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

Добавление, удаление и редактирование строк

Новая строка добавляется методом НоваяСтрока у табличной части: НоваяСтрока = Объект.Товары.Добавить(); затем заполняются поля новой строки.

Удаление строки выполняется методом Удалить(Индекс) или Удалить(Строка). Удалять строки внутри прямого цикла «Для Каждого» опасно: после удаления индексы смещаются, и часть строк может быть пропущена.

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

Типичные ошибки
01
Смешивание модуля объекта и модуля формы: изменение формы без записи в объект документа.
02
Удаление строк внутри прямого цикла «Для Каждого», из-за чего строки пропускаются.
03
Забыть вызвать Запись() после редактирования табличной части.

Проверка результата и контрольные точки

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

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

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

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

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

Соответствует ожидаемому значению

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

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

Вызов Запись()
Норма

Документ сохранён и изменения видны при повторном открытии

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

Изменения исчезают после закрытия документа

Обязательные реквизиты строк
Норма

Все заполнены

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

Есть пустые обязательные поля

Типичные ошибки и ограничения

Самая частая ошибка — смешивание модуля объекта и модуля формы: попытка обратиться к Объект.Товары из модуля формы без обращения к объекту документа, или наоборот изменить форму, не затронув объект.

Вторая ошибка — изменение табличной части во время прямого цикла, что приводит к пропуску строк. Третье — отсутствие вызова Запись(), из-за чего изменения теряются.

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

Когда обращаться к программисту 1С

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

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

Итог

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

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

Можно ли перебирать табличную часть по индексу?

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

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

Перейдите на обратный перебор: от последней строки к первой. Тогда удаление текущей строки не меняет индексы уже не пройденных строк, и каждая строка будет обработана корректно.

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

Да, изменения в объекте документа сохраняются только после вызова метода Запись(). Без него правки могут существовать только в памяти и пропасть при закрытии документа без записи.

В чём разница между перебором в модуле объекта и формы?

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

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

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