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

Другое · 7 мин

Свертка строк дерева значений в 1C: инструкция и проверка

Как свернуть строки дерева значений в 1C: пошаговое руководство, условия работы, проверка результата и типичные ошибки без потери данных.

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

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

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

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

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

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

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

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

Не стоит автоматически сворачивать все строки, если пользователи часто работают с deepest-уровнями и не привыкли раскрывать ветви вручную. В таких случаях лучше оставить дерево развёрнутым по умолчанию или предоставить кнопки «свернуть всё» и «развернуть всё» вместо жёсткой автоматизации. Выбор зависит от сценария работы и объёма иерархии.

Порядок действий при настройке свертки
  1. 1
    Откройте копию базы и форму с деревом значений.
  2. 2
    Определите, какие строки должны быть свёрнуты по умолчанию.
  3. 3
    Напишите код в модуле формы после заполнения дерева.
  4. 4
    Проверьте визуальное состояние строк и сохранение набора данных.
  5. 5
    Повторите проверку после переоткрытия формы.

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

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

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

Ограничения и риски самостоятельной настройки

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

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

Типичные ошибки при работе с деревом значений
01
Путаница свертки с удалением строк из набора.
02
Массовая свертка без проверки наличия дочерних элементов.
03
Ожидание сохранения состояния свертки после перезаполнения дерева.

Типичные ошибки и как их избежать

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

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

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

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

Родительская строка осталась в списке
Норма

Родитель виден, потомки скрыты

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

Родитель исчез или дерево пустое

Состояние после переоткрытия формы
Норма

Соответствует заданному в коде

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

Сброс к развёрнутому виду без причины

Набор данных не изменился
Норма

Количество строк и суммы прежние

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

Данные пропали или уменьшились

Как выбрать подходящий способ управления отображением

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

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

Итог

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

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

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

Удаляются ли данные при свертке строк?

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

Сохранится ли состояние свертки после перезапуска программы?

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

Можно ли свернуть все строки одной кнопкой?

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

Что делать, если после свертки не видны нужные суммы?

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

]-->