Другое · 6 мин
Перебор табличной части документа 1С 8.3
Инструкция по перебору табличной части документа 1С 8.3: цикл Для Каждого, поля строк, добавление и удаление, проверка результата, типичные ошибки.
Табличная часть документа в 1С 8.3 представляет собой набор строк с одинаковой структурой, который хранится в реквизите документа. Каждая строка содержит поля, описанные в конфигурации, и доступ к ним возможен через встроенный язык 1С:Предприятия.
Перебор строк нужен, когда требуется проверить значения, рассчитать сумму, заполнить поля по условию или скопировать данные в другой реквизит. Работа ведётся либо с объектом документа в модуле объекта, либо с элементом формы в модуле формы, и эти два способа не взаимозаменяемы.
Перед началом изменений обязательно определите, где именно находится табличная часть: в самом документе или только на форме. От этого зависит выбор конструкции цикла и способ сохранения результата.
Перебор строк в модуле объекта
В модуле объекта документа табличная часть доступна как реквизит объекта, например Объект.Товары. Для перебора используется цикл «Для Каждого ... Из»: Для Каждого Строка Из Объект.Товары Цикл ... КонецЦикла.
Внутри цикла переменная Строка ссылается на текущую строку табличной части, а поля доступны через точку: Строка.Номенклатура, Строка.Количество, Строка.Сумма. Изменение таких полей сразу отражается в объекте документа.
После внесения изменений документ нужно сохранить методом Запись(), иначе правки не попадут в базу при закрытии объекта без записи.
- 1Откройте модуль объекта документа и найдите реквизит табличной части.
- 2Напишите цикл Для Каждого Строка Из Объект.ИмяТабличнойЧасти Цикл.
- 3Обращайтесь к полям через Строка.ИмяПоля и вносите изменения.
- 4Завершите цикл и вызовите Объект.Запись() для сохранения.
Доступ к табличной части из модуля формы
В модуле формы табличную часть удобнее получать через элемент формы, связанный с табличным полем: Элементы.ТаблицаТовары.Список. Однако список формы отображает данные, а не всегда является прямым источником записи в объект.
Для записи изменений обратно в объект часто используют методы объекта документа или перезапись строк через Объект.ТабличнаяЧасть. Прямое изменение списка формы без синхронизации с объектом может не сохраниться.
Если форма открыта в режиме просмотра, попытка записи может быть ограничена правами или состоянием документа (проведён, закрыт).
Добавление, удаление и редактирование строк
Новая строка добавляется методом НоваяСтрока у табличной части: НоваяСтрока = Объект.Товары.Добавить(); затем заполняются поля новой строки.
Удаление строки выполняется методом Удалить(Индекс) или Удалить(Строка). Удалять строки внутри прямого цикла «Для Каждого» опасно: после удаления индексы смещаются, и часть строк может быть пропущена.
Безопасный способ — обратный перебор по индексу от количества строк к единице или предварительное копирование строк, подлежащих удалению, во временный список.
Проверка результата и контрольные точки
После перебора проверьте количество строк методом Количество() или сравните контрольную сумму до и после обработки. Если ожидалось заполнение всех строк, убедитесь, что пустых обязательных реквизитов не осталось.
Полезно вывести сообщение пользователю о количестве обработанных строк и обнаруженных расхождениях, чтобы результат был проверяемым.
Как проверить результат
Соответствует ожидаемому значению
Меньше ожидаемого или строки пропущены
Документ сохранён и изменения видны при повторном открытии
Изменения исчезают после закрытия документа
Все заполнены
Есть пустые обязательные поля
Типичные ошибки и ограничения
Самая частая ошибка — смешивание модуля объекта и модуля формы: попытка обратиться к Объект.Товары из модуля формы без обращения к объекту документа, или наоборот изменить форму, не затронув объект.
Вторая ошибка — изменение табличной части во время прямого цикла, что приводит к пропуску строк. Третье — отсутствие вызова Запись(), из-за чего изменения теряются.
Ограничение: табличная часть большого документа может содержать множество строк, поэтому тяжёлые вычисления внутри цикла замедляют работу и могут привести к превышению времени выполнения.
Когда обращаться к программисту 1С
Если табличная часть используется в регистрах накопления, документах проведения или требуется массовая обработка многих документов, самостоятельное изменение кода может нарушить проводки и остатки.
В таких случаях безопаснее обратиться к разработчику, который проверит блокировки, порядок проведения и целостность данных.
Что важно запомнить
Перебирайте табличную часть через реквизит объекта документа, сохраняйте изменения методом Запись, не удаляйте строки внутри прямого цикла и проверяйте результат после обработки.
Можно ли перебирать табличную часть по индексу?
Да, можно использовать цикл по индексу от 1 до Количество() или в обратном порядке. Это удобно при удалении строк, так как прямой цикл «Для Каждого» при удалении может пропускать строки из-за смещения индексов.
Что делать, если строки пропускаются при удалении?
Перейдите на обратный перебор: от последней строки к первой. Тогда удаление текущей строки не меняет индексы уже не пройденных строк, и каждая строка будет обработана корректно.
Нужно ли вызывать Запись после изменения табличной части?
Да, изменения в объекте документа сохраняются только после вызова метода Запись(). Без него правки могут существовать только в памяти и пропасть при закрытии документа без записи.
В чём разница между перебором в модуле объекта и формы?
В модуле объекта вы работаете с данными документа в базе и можете сохранить их через Запись. В модуле формы вы чаще работаете с отображением на экране, и изменения в списке формы не всегда автоматически попадают в объект документа без дополнительной синхронизации.
Можно ли менять табличную часть проведённого документа?
Обычно нет без отмены проведения: проведённый документ защищён от прямых изменений, чтобы не нарушить проводки и остатки. Безопасный путь — отменить проведение, внести правки в табличную часть, сохранить и провести документ заново.