getByAccessCode

?\Bitrix\HumanResources\Item\Node public
\Bitrix\HumanResources\Public\Service\NodeService::getByAccessCode(
	string $accessCode,
	?\Bitrix\HumanResources\Type\NodeEntityType $nodeType = null,
	?\Bitrix\HumanResources\Type\StructureAction $structureAction = null
);

Метод возвращает узел организационной структуры по коду доступа. При передаче действия метод дополнительно проверяет доступ текущего пользователя. Нестатический метод.

Параметры

Возвращаемое значение

Метод возвращает объект \Bitrix\HumanResources\Item\Node. Если узел не найден, метод возвращает null.

Исключения

Метод может выбросить \Bitrix\Main\ArgumentException, \Bitrix\Main\ObjectPropertyException или \Bitrix\Main\SystemException при ошибке ORM-запроса. При проверке действия неподдерживаемый код доступа вызывает \InvalidArgumentException.

Особенности

В текущей реализации передача ненулевого $structureAction приводит к \TypeError: метод передает $nodeType и $structureAction в репозиторий в позиции с другими типами. До исправления реализации вызывайте метод без проверки действия.

Пример

<?php

use Bitrix\HumanResources\Public\Service\Container;
use Bitrix\Main\Loader;

if (!Loader::includeModule('humanresources'))
{
	echo 'Модуль humanresources не установлен';
	return;
}

$nodeService = Container::getNodeService();
$rootNode = $nodeService->getRootNode();
if ($rootNode?->accessCode === null)
{
	echo 'Код доступа корневого узла не найден';
	return;
}

$node = $nodeService->getByAccessCode($rootNode->accessCode);

echo $node === null ? 'Узел не найден' : $node->name;