Другое · 7 мин
Как получить всех родителей справочника 1С
Практическая инструкция по получению цепочки родителей элементов и групп справочника в 1С: алгоритм, пример кода, проверка и ошибки.
В иерархическом справочнике 1С у каждой записи может быть поле Родитель, которое указывает на группу или другую запись выше по иерархии. «Все родители» означает не только непосредственного предка, но и всю цепочку вверх до корня справочника.
Такая цепочка нужна при построении отчётов по иерархии, проверке прав доступа, переносе данных, настройке отбора и отладке ссылочных связей. Если взять только прямого родителя, можно пропустить промежуточные группы и получить неполную картину принадлежности элемента.
Ниже описано получение цепочки родителей средствами встроенного языка, без изменения конфигурации, с проверкой результата и предупреждениями о рисках.
Перед началом уточните, какая запись анализируется: элемент или группа, помечена ли она на удаление, доступна ли ссылка в текущем сеансе. Работа с удалённой или недоступной ссылкой может вернуть Неопределено или привести к ошибке при обращении к свойствам.
Не путайте Родитель справочника с Владельцем документа или движениями регистров: для справочника цепочка строится по полю Родитель, а для документов и других объектов применяются другие связи.
Как проверить результат
Соответствует глубине вложенности
Ноль строк для вложенной записи или дубли
Корневая группа или пустая цепочка
Запись не является корнем и не имеет Родитель
Все родители доступны и не помечены на удаление
Есть Неопределено или недоступная ссылка
Что означает «все родители» в справочнике 1С
Справочник может быть неиерархическим, тогда у записей нет родительской связи, кроме общих настроек хранения. В иерархическом справочнике записи делятся на группы и элементы, а у каждой записи есть ссылка на родителя. Элемент обычно находится в группе, а группа может быть вложена в другую группу.
Цепочка родителей для элемента начинается с его группы, затем переходит к родителю этой группы и так далее, пока не встретится пустая ссылка. Для группы цепочка начинается с её собственного родителя, без включения самой группы, если требуются только предки.
Когда цепочка родителей нужна в практической работе
Сценарий распространён при формировании отчёта «отделы и сотрудники», где нужно показать, к какому вышестоящему подразделению относится текущий. Также цепочка помогает при сверке выгрузок, восстановлении ссылок после переноса базы и проверке корректности вложенности справочника «Номенклатура» или «Контрагенты».
Ещё один случай — администрирование прав, когда доступ настраивается по иерархии, а не по отдельным записям. Тогда недостаточно знать прямого родителя, нужно проверить весь путь до корня, чтобы не пропустить ограничение на уровне вышестоящей группы.
Как выбрать действие
Алгоритм получения цепочки родителей на встроенном языке
Базовый алгоритм: взять ссылку на запись, создать пустую таблицу значений или массив для результата, в цикле обращаться к свойству Родитель текущей ссылки. Если родитель не пуст, добавить его в результат и сделать его текущей ссылкой. Повторять до тех пор, пока Родитель не станет равен Неопределено.
Важно не включать исходную запись в число родителей, если задача — найти только предков. Если нужно получить путь включая саму запись, добавьте её отдельно перед циклом или после завершения в зависимости от требуемого порядка.
Функция ПолучитьЦепочкуРодителей(Ссылка)Результат = Новый ТаблицаЗначений;
Результат.Колонки.Добавить("Родитель");
Текущий = Ссылка;
Пока Текущий <> Неопределено Цикл
Текущий = Текущий.Родитель;
Если Текущий <> Неопределено Тогда
НоваяСтрока = Результат.Добавить();
НоваяСтрока.Родитель = Текущий;
КонецЕсли;
КонецЦикла;
Возврат Результат;
КонецФункции
Порядок записи в таблице зависит от задачи: иногда удобнее получать список от ближайшего родителя к корню, иногда от корня к элементу. Если нужен обратный порядок, переверните таблицу после цикла или добавляйте записи в начало коллекции.
Проверяйте результат на пустоту: для элемента корня справочника цепочка родителей может быть пустой, и это нормально. Отсутствие родителей не всегда означает ошибку, но для вложенной записи пустой результат требует проверки заполнения поля Родитель.
Пример кода и порядок проверки
Приведённый выше фрагмент работает в общем модуле или модуле объекта, где доступна встроенная ссылка. В клиентском коде вызывайте функцию осторожно, если цепочка длинная, чтобы не создавать лишние round-трипы к серверу. В серверном вызове производительность обычно выше.
После получения таблицы проверьте количество строк, соответствие последней записи корню справочника и отсутствие дублей. Если в результате встречается одна и та же ссылка дважды, данные повреждены или настройки иерархии некорректны, и дальнейшая обработка требует остановки.
Ограничения, риски и типичные ошибки
Не вносите изменения в иерархию справочника напрямую через изменение поля Родитель без понимания последствий. Перемещение группы или элемента может сломать отчёты, документы, настройки прав и исторические движения, которые ссылаются на старый путь. Перед экспериментами сделайте резервную копию информационной базы.
Опасность зацикливания минимальна в исправной конфигурации, но возможна при повреждении данных или ручном изменении ссылок. Добавьте в цикл защиту от превышения разумной глубины или отслеживание уже пройденных ссылок, чтобы остановиться при подозрительном зацикливании.
Не используйте этот алгоритм для документов, регистров сведений или справочников без иерархии. Для таких объектов понятие «все родители» не применимо или требует других связей, например владельца, регистратора или измерения.
Альтернативные способы и запросы к данным
В некоторых задачах проще получить путь через запрос к таблице иерархии, если конфигурация предоставляет такие таблицы, или через встроенные функции получения родительской ссылки. Запрос может быть удобнее при массовой обработке тысяч записей, но требует знания структуры хранения конкретной конфигурации.
Для разовых проверок достаточно открыть форму элемента справочника и посмотреть поле Родитель в более древовидном представлении, если оно есть. Для автоматизации используйте программный алгоритм, а не ручной обход форм.
Как выбрать подходящий вариант и завершить работу
Если цепочка нужна редко и для одной записи, достаточно простой функции на встроенном языке с проверкой на пустоту. Для регулярных отчётов вынесите логику в общий модуль, добавьте логирование и ограничение глубины, чтобы избежать зависаний при некорректных данных.
После внедрения протестируйте на границах: корневые элементы, глубокая вложенность, помечённые на удаление записи, пустые ссылки. Только после успешного тестирования переносите код в рабочую базу.
ИтогЧто важно запомнить
Все родители справочника получаются по полю Родитель в цикле до пустого значения; проверяйте иерархию, не путать с Владельцем и делайте резервную копию перед изменениями.
Нужно ли включать саму запись в список родителей?
Нет, если требуются только предки. Исходную запись добавляйте отдельно, только когда задача explicitly включает полный путь от самой записи до корня.
Что делать, если результат пуст для вложенной записи?
Проверьте, заполнено ли поле Родитель, не помечена ли запись на удаление и доступна ли ссылка в текущем сеансе. Пустой результат для корневой группы является нормальным.
Можно ли изменить поле Родитель программно для перемещения записи?
Технически возможно в некоторых конфигурациях, но это высокорисковое действие, которое может нарушить ссылки, отчёты и настройки прав. Делайте только после резервного копирования и тщательного тестирования.
Как защититься от зацикливания цепочки?
Отслеживайте уже пройденные ссылки или ограничьте количество итераций в цикле. Если встречается повторная ссылка, прерывайте обработку и проверяйте целостность данных.