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

Другое · 8 мин

Как получить родителя в 1С: справочники, запросы и иерархия

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

В 1С:Предприятии понятие «родитель» чаще всего относится к элементам иерархических справочников. Каждый такой элемент может быть либо группой, либо обычным элементом, и у обычного элемента есть ссылка на тот объект справочника, внутри которого он находится. Эта ссылка хранится в свойстве Родитель и используется при формировании отчётов, разделении прав доступа и обходе вложенности.

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

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

Что понимать под родителем в 1С

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

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

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

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

В модуле объекта или формы обращайтесь к свойству Родитель у ссылки на элемент. Например, если есть ссылка ЭлементСсылки, то выражение ЭлементСсылки.Родитель вернёт ссылку на родительский элемент или группу, а для корневого элемента — пустую ссылку. Проверяйте результат на пустоту перед дальнейшим использованием.

Чтобы почитать реквизиты родителя, получите объект через ссылку: ОбъектРодителя = ЭлементСсылки.Родитель.ПолучитьОбъект(). После этого доступны реквизиты родительского элемента, но изменения требуют записи и могут затрагивать другие дочерние элементы, поэтому действуйте осторожно.

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

Порядок действий
  1. 1
    Откройте модуль объекта или формы справочника
  2. 2
    Получите ссылку на текущий элемент
  3. 3
    Обратитесь к свойству Родитель у ссылки
  4. 4
    Проверьте результат на пустоту
  5. 5
    При необходимости получите объект родителя через ПолучитьОбъект()

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

В языке запросов 1С у иерархического справочника есть поле Родитель, по которому можно делать отбор. Пример условия: Где Справочник.Номенклатура.Родитель = &Родитель. Это позволяет выбрать все элементы, находящиеся непосредственно под выбранной группой, без вложенных папок нижних уровней.

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

Отбор по пустому родителю ищет элементы корневого уровня. Условие Родитель = NULL или сравнение с пустой ссылкой зависит от диалекта запроса и конфигурации, поэтому проверяйте результат на тестовом наборе данных перед вводом в эксплуатацию.

Цепочка родителей и обход иерархии вверх

Иногда одного родителя недостаточно: требуется пройти от элемента к корню справочника, собрав всех предков. Реализуйте цикл, который берёт текущего родителя, добавляет его в список и переходит к родителю этого родителя, пока ссылка не станет пустой.

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

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

Ограничения и частые ошибки

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

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

Типичные ошибки
01
Обращение к свойству Родитель у документа или неиерархического справочника
02
Считание родителя группы и родителя элемента одним и тем же
03
Перемещение элемента между группами без проверки прав и влияния на отчёты

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

Проверка результата и безопасная работа

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

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

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

Свойство Родитель у элемента
Норма

Возвращает ссылку на группу или пустую ссылку для корня

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

Ошибка выполнения или неожидаемый тип объекта

Отбор по родителю в запросе
Норма

Возвращает элементы только выбранной группы

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

Пустой результат или элементы из всех уровней

Цепочка предков
Норма

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

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

Бесконечный цикл или превышение лимита шагов

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

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

Итог

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

Родитель берётся через свойство Родитель иерархического справочника, отбор делается по полю Родитель в запросе, а цепочка предков собирается рекурсивно с проверкой на пустоту и зацикливание.

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

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

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

Что вернёт свойство Родитель для элемента на корневом уровне?

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

Как найти всех детей одного родителя?

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

Безопасно ли программно менять родителя элемента?

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

Нужен ли объект родителя, или достаточно ссылки?

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