findParentsByNodeId
?\Bitrix\HumanResources\Item\Collection\NodeCollection public \Bitrix\HumanResources\Public\Service\NodeService::findParentsByNodeId( int $nodeId, ?array $nodeTypes = null, \Bitrix\HumanResources\Enum\DepthLevel|int $depthLevel = \Bitrix\HumanResources\Enum\DepthLevel::FIRST, ?\Bitrix\HumanResources\Type\StructureAction $structureAction = null );
Метод возвращает родительские узлы для указанного узла организационной структуры. Нестатический метод.
Параметры
| Параметр | Описание |
|---|---|
$nodeId | Идентификатор исходного узла |
$nodeTypes | Типы родительских узлов из перечисления NodeEntityType. При значении null метод определяет фильтр по типу исходного узла: для команды использует подразделения и команды, для подразделения — подразделения |
$depthLevel | Глубина поиска из перечисления DepthLevel или целое число уровней. Значение по умолчанию — DepthLevel::FIRST |
$structureAction | Действие из перечисления StructureAction, для которого нужно проверить доступ. Значение null отключает фильтр по правам |
Возвращаемое значение
Метод возвращает коллекцию \Bitrix\HumanResources\Item\Collection\NodeCollection. Если исходный узел не найден и $nodeTypes равен null, метод возвращает пустую коллекцию. Если типы переданы явно, а исходный узел не найден, метод может вернуть null.
Пример
<?php
use Bitrix\HumanResources\Enum\DepthLevel;
use Bitrix\HumanResources\Public\Service\Container;
use Bitrix\Main\Loader;
if (!Loader::includeModule('humanresources'))
{
echo 'Модуль humanresources не установлен';
return;
}
// Идентификатор существующего вложенного узла организационной структуры
$nodeId = 2;
$parents = Container::getNodeService()->findParentsByNodeId(
$nodeId,
depthLevel: DepthLevel::FULL,
);
print_r($parents?->getIds() ?? []);
Была ли эта страница полезна?
Что можно улучшить?
Пользовательские комментарии
Помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2026, «1С-Битрикс», 2026