Как очистить дерево значений в 1С

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

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

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

Что происходит при очистке дерева значений

Объект «ДеревоЗначений» состоит из двух частей: коллекции колонок (описание структуры) и коллекции строк (сами данные). Очистка затрагивает именно строки: удаляются все элементы коллекции Строки верхнего уровня, а вместе с ними — все вложенные подчинённые строки любой глубины вложенности.

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

Очистка строк методом Очистить()

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

Дерево.Строки.Очистить();

Если нужно очистить не всё дерево, а только ветку конкретной строки, вызовите метод у её коллекции подчинённых строк:

СтрокаРодитель = Дерево.Строки.Найти(ИскомоеЗначение, "Номенклатура");
Если СтрокаРодитель <> Неопределено Тогда
СтрокаРодитель.Строки.Очистить();
КонецЕсли;

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

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

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

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

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

ДеревоДанных.ПолучитьЭлементы().Очистить();

Здесь ДеревоДанных — имя реквизита формы. Метод ПолучитьЭлементы() возвращает коллекцию строк верхнего уровня, и её очистка удаляет всё содержимое вместе с вложенными ветками. Элемент формы, связанный с реквизитом, обновится автоматически.

Второй вариант — получить объект через РеквизитФормыВЗначение(), выполнить операции и вернуть результат обратно через ЗначениеВРеквизитФормы(). Такой подход оправдан, когда очистка совмещена со сложной обработкой на сервере, но для простой очистки он избыточен и медленнее.

Удаление строк в цикле и по условию

Иногда требуется удалить не все строки, а только часть — по условию или по одной. Для единичного удаления используется метод Удалить() коллекции строк:

СтрокаДляУдаления = Дерево.Строки.Найти(ЗначениеПоиска, "Код", Истина);
Если СтрокаДляУдаления <> Неопределено Тогда
Родитель = СтрокаДляУдаления.Родитель;
Если Родитель = Неопределено Тогда
Дерево.Строки.Удалить(СтрокаДляУдаления);
Иначе
Родитель.Строки.Удалить(СтрокаДляУдаления);
КонецЕсли;
КонецЕсли;

Для выборочного удаления по условию удобен обход коллекции с конца, чтобы удаление не сбивало индексы:

КоллекцияСтрок = Дерево.Строки;
Для Индекс = 1 - КоллекцияСтрок.Количество() По 0 Цикл
Строка = КоллекцияСтрок[-Индекс];
Если Строка.Пометка = Ложь Тогда
КоллекцияСтрок.Удалить(Строка);
КонецЕсли;
КонецЦикла;

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

Пересоздание объекта как альтернатива очистке

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

Дерево = Новый ДеревоЗначений;
Дерево.Колонки.Добавить("Номенклатура");
Дерево.Колонки.Добавить("Количество");

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

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

После очистки убедитесь, что дерево действительно пусто: проверьте Дерево.Строки.Количество() = 0 для переменной или ДеревоДанных.ПолучитьЭлементы().Количество() = 0 для реквизита формы. Для вложенных уровней дополнительная проверка не нужна — очистка верхнего уровня удаляет всё поддерево.

Частая ситуация: код очистки выполнен, но на форме данные остались. Причина почти всегда в том, что очищена локальная копия объекта, полученная через РеквизитФормыВЗначение(), а результат не возвращён в реквизит формы. Либо очищена другая переменная, не связанная с отображаемым деревом.

FAQ