Как заполнить Дерево Значений в 1С: Обычные формы

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

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

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

Инициализация объекта и объявление колонок

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

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

⚠️ Внимание: При добавлении колонок в обычных формах тип данных должен быть строго определен. Использование типа Строка(Неограниченная) без необходимости может замедлить работу формы при большом объеме данных.

Рассмотрим пример объявления колонок для отчета по номенклатуре. Нам понадобятся колонки для наименования товара, его количества и суммы. Имя колонки часто делают на английском или транслите для удобства программирования, а заголовок — на русском языке для интерфейса.

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

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

Заполнение строк и работа с иерархией

Основное преимущество Дерева Значений перед Таблицей Значений — возможность создания вложенных структур. Каждая строка в дереве является объектом типа СтрокаДереваЗначений. У этого объекта есть свойство Родитель, которое ссылается на вышестоящую строку. Если свойство Родитель не установлено (равно Неопределено), строка считается корневой.

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

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

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

СтрокаГруппы = Дерево.Добавить;
СтрокаГруппы["Номенклатура"] = Справочники.ВидыНоменклатуры.НайтиПоНаименованию("Электроника");
СтрокаГруппы["Количество"] = 0; // Итоговое количество можно посчитать позже

СтрокаТовара = Дерево.Добавить(СтрокаГруппы);
СтрокаТовара["Номенклатура"] = Справочники.Номенклатура.НайтиПоНаименованию("Телевизор");
СтрокаТовара["Количество"] = 5;
СтрокаТовара["Сумма"] = 50000;

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

Настройка отображения в обычных формах

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

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

Свойство формы	Описание	Влияние на отображение
Видимость	Определяет, виден ли элемент пользователю	Скрывает таблицу целиком
ТолькоПросмотр	Запрещает редактирование ячеек	Данные видны, но нельзя менять
РежимЗаголовка	Показывать или скрывать шапку колонок	Управляет видимостью заголовков
ВыделениеСтроки	Разрешает выделение строки мышью	Необходимо для работы с текущей строкой

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

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

Почему данные не видны в форме?

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

Сортировка, отборы и поиск данных

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

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

• 🔍 Отборы: позволяют скрыть строки, не подходящие под заданные условия (например, показать только товары с остатком > 0).
• 🔍 Сортировка: упорядочивает строки по алфавиту, дате или числовому значению.
• 🔍 Поиск: встроенная функция формы позволяет быстро найти строку по частичному совпадению текста.

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

ЭлементФормы.Отборы.Добавить("Количество", ВидСравнения.Больше, 0);

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

⚠️ Внимание: При изменении состава колонок или структуры дерева во время работы формы, ранее установленные отборы и сортировки могут сброситься. Рекомендуется переустанавливать их после существенных изменений структуры данных.

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

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

Самое часто используемое событие — ПриВыборе (или НачалоВыбора / Выбор в зависимости от контекста элемента). Оно срабатывает, когда пользователь дважды кликает по строке или нажимает Enter. В этом обработчике мы получаем доступ к текущей строке через Элемент.ТекущиеДанные.

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

Процедура Таблица_ПриИзменении(Элемент)
Если Элемент.ИмяКолонки ="Количество" Тогда
ТекущаяСтрока = Элемент.ТекущиеДанные;
Цена = ТекущаяСтрока["Номенклатура"].Цена; // Условное свойство
ТекущаяСтрока["Сумма"] = ТекущаяСтрока["Количество"] * Цена;
КонецЕсли;
КонецПроцедуры

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

Оптимизация и типичные ошибки разработки

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

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

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

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

⚠️ Внимание: Интерфейс и возможности обычных форм могут отличаться в зависимости от версии платформы 1С:Предприятие и режима запуска (Тонкий/Толстый клиент). Некоторые свойства могут быть недоступны в тонком клиенте для обычных форм.

Часто задаваемые вопросы (FAQ)

Можно ли использовать Дерево Значений в управляемых формах?

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

Как удалить строку из Дерева Значений программно?

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

Почему не работает сортировка по колонке с картинками?

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

Как скопировать все данные из Таблицы Значений в Дерево Значений?

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

Можно ли объединять ячейки в Дереве Значений обычных форм?

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