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

Другое · 6 мин

Как программно очистить табличную часть в 1С: подробная инструкция

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

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

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

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

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

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

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

Как очистить табличную часть объекта

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

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

bsl
Объект.Товары.Очистить;
ЭтаФорма.Обновить();

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

Очистка циклом с конца

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

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

Очистка в управляемой форме

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

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

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

Типичные ошибки
01
Очистили форму, но не записали объект — данные не сохранились
02
Удаляли строки циклом с начала — часть строк осталась или индексы сбились
03
Пытались очистить табличную часть проведённого документа без отмены проведения

Когда табличную часть нельзя очистить

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

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

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

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

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

Ноль строк

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

Строки остались или количество не изменилось

Повторное открытие объекта
Норма

Табличная часть пуста

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

Старые строки отображаются снова

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

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

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

Сравнение вариантов

Метод Очистить

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

Цикл с конца

Подходит для выборочного удаления, сложнее в написании

Очистка только формы

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

Частая ошибка — очистить табличную часть на форме, но не записать объект. Пользователь видит пустую таблицу, а при следующем открытии старые строки возвращаются. Другая ошибка — удалять строки циклом с начала, что приводит к пропуску строк или некорректным индексам.

Сравнение способов очистки

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

Итог

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

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

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

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

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

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

В чем разница между очисткой формы и объекта?

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

Как проверить, что табличная часть очищена?

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