Заполнение Дерева значений в 1С на управляемой форме

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

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

В этой статье мы подробно разберем алгоритм создания дерева программно, рассмотрим работу с отбором и научимся перехватывать действия пользователя. Вы узнаете, как правильно использовать реквизиты структуры и какие нюансы есть при работе с реквизитами, которые не входят в базовую структуру 1С.

Подготовка формы и реквизита структуры

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

После создания реквизита нужно определить его структуру. Для этого откройте свойства формы и найдите вкладку «Реквизиты». Выберите ваше дерево и перейдите к настройке колонок. Здесь вы добавляете необходимые поля, такие как «Наименование», «Код» или «Сумма». Каждой колонке можно присвоить свой тип данных, что делает дерево универсальным инструментом отображения.

Особое внимание следует уделить свойству ИерархияДанных. Если вы планируете загружать данные из существующего справочника, это свойство можно привязать к полю данных. Однако, если дерево формируется динамически или агрегирует данные из разных источников, иерархию придется строить программно, манипулируя свойством Родитель у каждой строки.

⚠️ Внимание: Тип данных в колонках дерева должен строго соответствовать типу значения, которое вы планируете туда записать. Попытка записать Строку в колонку типа Число вызовет ошибку выполнения.

Программное создание и заполнение структуры

Заполнение дерева значений происходит в модуле формы, обычно в обработчике события ПриСозданииНаСервере или по кнопке обновления. Первым шагом является создание нового объекта ДеревоЗначений. Это делается через конструктор типа, после чего мы можем приступать к добавлению строк.

Для добавления данных используется метод Строки.Добавить(). Каждая новая строка автоматически получает ссылку на родительскую строку, если вызов происходит в контексте текущей выбранной строки, либо на корень, если дерево пусто. Для явного указания родителя используется свойство Родитель. Именно оно определяет визуальный уровень вложенности элемента.

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

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

// Добавляем корневую строку
Строка1 = Дерево.Строки.Добавить();
Строка1.Наименование = "Группа 1";
Строка1.Сумма = 0;

// Добавляем дочернюю строку к первой
Строка2 = Строка1.Строки.Добавить();
Строка2.Наименование = "Элемент 1.1";
Строка2.Сумма = 100;

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

Работа с иерархией и свойствами строк

Управление вложенностью — ключевой аспект работы с данным типом поля. Свойство Родитель позволяет перемещать строки между уровнями уже после их создания. Вы можете программно свернуть или разверть ветки, установив свойство Раскрыто в нужное значение. Это полезно, если дерево получается слишком громоздким и пользователю сложно ориентироваться в нем с первого взгляда.

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

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

Свойство строки	Тип данных	Описание
Родитель	СтрокаДереваЗначений	Ссылка на родительскую строку. Если пустое — строка корневая.
Раскрыто	Булево	Определяет, видны ли дочерние элементы данной строки.
ТолькоПросмотр	Булево	Запрещает редактирование ячеек в конкретной строке.
ИндексКартинки	Число	Номер изображения из списка картинок поля формы.

Рекурсивный обход дерева

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

Использование отборов и поиска в дереве

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

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

Если встроенного отбора недостаточно, можно реализовать программный поиск. Для этого используется метод НайтиСтроку() или цикл с проверкой условий. Найденную строку можно выделить программно, установив свойство ТекущаяСтрока у поля формы, чтобы сфокусировать внимание пользователя.

⚠️ Внимание: При использовании отборов помните, что скрытые строки всё равно остаются в структуре дерева. Если ваша логика зависит от количества строк, используйте свойство Количество() с учетом отбора, а не общий счетчик.

Обработка событий и взаимодействие с пользователем

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

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

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

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

Оптимизация производительности и типичные ошибки

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

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

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

Как добавить картинку к строке дерева?

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

Можно ли сделать ячейки дерева недоступными для редактирования?

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

Как программно свернуть все ветки дерева?

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

Почему не работает отбор по колонке типа УникальныйИдентификатор?

Отбор по уникальным идентификаторам может не срабатывать корректно, если типы данных не совпадают точно. Убедитесь, что в условии отбора вы используете значение типа УникальныйИдентификатор, а не строковое представление GUID.