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

Разработка и Конфигурация · 10 мин

Дерево объектов конфигурации 1С: структура, назначение и работа с ним

Что такое дерево объектов конфигурации 1С, из каких ветвей оно состоит, как найти нужный объект, изменить структуру и не сломать базу при доработке.

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

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

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

Из каких ветвей состоит дерево объектов

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

Стандартный набор ветвей включает: общие объекты (подсистемы, общие модули, роли, интерфейсы, критерии отбора), константы, справочники, документы, журналы документов, перечисления, отчёты, обработки, планы видов характеристик, планы счетов, планы видов расчёта, регистры сведений, регистры накопления, регистры бухгалтерии, регистры расчёта, бизнес-процессы и задачи.

Конкретный состав ветвей зависит от конфигурации. В «Управлении торговлей» будет развитая ветвь документов и регистров накопления, в «Зарплате и управлении персоналом» — планы видов расчёта и регистры расчёта, а в простой самописной конфигурации часть ветвей может отсутствовать вовсе.

Что находится внутри отдельного объекта дерева

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

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

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

Как открыть дерево и найти нужный объект

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

Когда объектов много, искать глазами долго. Практичные способы поиска: начать вводить имя объекта, когда фокус стоит на дереве — платформа перейдёт к совпадению; использовать глобальный поиск (Ctrl+Shift+F) по имени объекта; через «Правка → Найти ссылки на объект» определить, где объект используется, прежде чем его менять или удалять.

Как найти объект в дереве конфигурации
  1. 1
    Откройте конфигуратор и выполните «Конфигурация → Открыть конфигурацию».
  2. 2
    Раскройте нужную ветвь верхнего уровня, например «Документы».
  3. 3
    Установите курсор на дерево и начните набирать имя объекта для быстрого перехода.
  4. 4
    Двойным щелчком откройте объект и проверьте его реквизиты, формы и движения.
  5. 5
    Через контекстное меню выполните «Найти ссылки на объект», чтобы оценить связанность перед изменением.

Как добавить новый объект и что происходит при обновлении

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

Физическое создание таблиц происходит только после команды «Конфигурация → Обновить конфигурацию базы данных» (F7). Платформа покажет окно реструктуризации со списком изменений: добавление таблиц, полей, индексов. Пока обновление не выполнено, пользователи не увидят новый объект, а при попытке обратиться к нему из кода возникнет ошибка.

Реструктуризация при изменении существующих объектов может занимать значительное время на больших таблицах и требует монопольного доступа. На рабочих базах её выполняют в нерабочее время и обязательно после создания резервной копии.

Типичные ошибки при работе с деревом объектов

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

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

Типичные ошибки
01
Удаление объекта без поиска ссылок — после обновления падают отчёты, обмены и код, который к нему обращался.
02
Обновление конфигурации базы без резервной копии — при сбое реструктуризации данные восстановить сложно.
03
Переименование объекта без проверки внешних обработок и планов обмена — обмены перестают работать.
04
Изменение типа или состава измерений регистра на заполненной базе — искажение или потеря накопленных данных.
05
Добавление объекта без настройки ролей — пользователи не видят его в интерфейсе или, наоборот, получают лишний доступ.

Расширения как альтернатива изменению дерева

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

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

Сравнение вариантов доработки

Прямое изменение дерева конфигурации

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

Расширение конфигурации

Сохраняет поддержку и упрощает обновления, но имеет ограничения по типам дорабатываемых объектов. Рекомендуется для типовых решений.

Внешние обработки и отчёты

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

Как проверить, что изменения в дереве корректны

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

На больших базах дополнительно выполняют тестирование и исправление (chdbfl для файловых баз или средства СУБД) после нештатных ситуаций, а также контрольный прогон ключевых бизнес-процессов на копии: создание документа, проведение, закрытие периода, обмен.

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

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

Обновление конфигурации базы данных
Норма

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

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

Появляются неожиданные удаления полей или ошибки реструктуризации

Доступность объекта пользователям
Норма

Объект виден в интерфейсе под целевой ролью, открывается без ошибок прав

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

Объект отсутствует в меню или возникает нарушение прав доступа

Работа связанных механизмов
Норма

Отчёты, обмены и печатные формы работают как до изменения

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

Ошибки в модулях, пустые отчёты, сбои обмена

Частые вопросы о дереве объектов конфигурации

Почему в дереве нет ветви, например «Регистры расчёта»?

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

Можно ли изменить порядок объектов в дереве?

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

Что означает замок или другие пиктограммы у объектов?

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

Удалится ли объект сразу после нажатия «Удалить» в дереве?

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

Как понять, какие объекты дерева используются в конкретном обмене?

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

Видят ли дерево объектов обычные пользователи?

Нет. Дерево доступно только в конфигураторе. Пользователи режима «Предприятие» видят интерфейс, сформированный подсистемами и командным интерфейсом, состав которого настраивается через ветвь «Подсистемы» и роли.

Итог

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

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