Как очистить таблицу формы в 1С

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

Основная ошибка начинающих разработчиков — попытка очистить таблицу через присваивание новой пустой таблицы или через цикл удаления строк. Такой подход ломает связь элемента формы с данными, вызывает ошибки обращения к объектам и приводит к лишним обходам коллекции. Встроенный метод Очистить() решает задачу одной строкой и безопасно.

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

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

Табличная часть — это коллекция строк, хранящаяся внутри объекта (документа, справочника). Чтобы удалить все строки, вызовите метод Очистить() у табличной части объекта:

Объект.Товары.Очистить();
// или через переменную
ТЧ = Объект.Товары;
ТЧ.Очистить();

Если код выполняется в модуле формы документа, обращение идёт через реквизит Объект. Если код находится в модуле объекта или в обработчике проведения, табличная часть доступна напрямую по имени: Товары.Очистить().

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

Очистка таблицы значений на форме

Реквизит формы типа «ТаблицаЗначений» очищается тем же методом. Если таблица отображается элементом формы, после вызова Очистить() интерфейс обновится автоматически — дополнительных действий не требуется:

&НаКлиенте
Процедура ОчиститьТаблицу(Команда)
	ТаблицаДанных.Очистить();
КонецПроцедуры

Не присваивайте реквизиту новую пустую таблицу через ТаблицаДанных = Новый ТаблицаЗначений — на клиенте такой код вообще недоступен, а на сервере он разорвёт связь элемента формы с данными, и таблица на экране перестанет обновляться корректно.

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

Очистка дерева значений и вложенных структур

Дерево значений очищается через коллекцию строк корневого уровня: ДеревоДанных.Строки.Очистить(). Если требуется очистить только вложенные строки конкретной ветки, вызовите Очистить() у коллекции строк нужного родителя:

// Очистить всё дерево
ДеревоДанных.Строки.Очистить();
// Очистить подчинённые строки одной ветки
НайденнаяСтрока.Строки.Очистить();

Для частичной очистки табличной части по условию (например, удалить только строки с нулевым количеством) сначала найдите строки методом НайтиСтроки(), затем удаляйте их в цикле методом Удалить(). Полный Очистить() здесь не подойдёт — он удалит всё безусловно.

Динамический список и динамическое считывание

Динамический список (таблица формы с типом «ДинамическийСписок») нельзя очистить методом Очистить() — он отображает данные из базы по запросу, а не хранит строки. Чтобы «очистить» такой список, нужно либо удалить сами записи из базы, либо изменить запрос или отбор списка так, чтобы он не возвращал строк.

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

Типичные ошибки при очистке таблиц

Самая распространённая ошибка — удаление строк в цикле перебора по индексу от нуля вверх: при удалении строки индексы сдвигаются, и часть строк пропускается. Если цикл всё же нужен, перебирайте коллекцию с конца или используйте НайтиСтроки().

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

Проверка результата после очистки

После вызова Очистить() убедитесь, что количество строк равно нулю: Количество() для таблицы значений или табличной части должно вернуть 0. Для таблицы на форме дополнительно проверьте визуально, что элемент формы пуст.

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

Частые вопросы