findAllByName

\Bitrix\HumanResources\Item\Collection\NodeCollection public
\Bitrix\HumanResources\Public\Service\NodeService::findAllByName(
	?string $name,
	?int $structureId = null,
	?array $parentIds = null,
	array $nodeTypes = [\Bitrix\HumanResources\Type\NodeEntityType::DEPARTMENT],
	\Bitrix\HumanResources\Enum\DepthLevel|int $depthLevel = \Bitrix\HumanResources\Enum\DepthLevel::FULL,
	bool $strict = false,
	?\Bitrix\HumanResources\Type\StructureAction $structureAction = null,
	\Bitrix\HumanResources\Enum\NodeActiveFilter $activeFilter = \Bitrix\HumanResources\Enum\NodeActiveFilter::ONLY_GLOBAL_ACTIVE,
	?int $limit = 100
);

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

Параметры

Параметр	Описание
`$name`	Название или часть названия узла. Значение `null` или пустая строка отключает фильтр по названию
`$structureId`	Идентификатор организационной структуры. При значении `null` метод использует структуру по умолчанию
`$parentIds`	Идентификаторы родительских узлов. Метод учитывает параметр при поиске по названию и при получении дочерних узлов без названия
`$nodeTypes`	Типы узлов из перечисления `NodeEntityType`. По умолчанию метод выбирает подразделения
`$depthLevel`	Глубина поиска от родительских узлов из перечисления `DepthLevel` или целое число уровней. Значение по умолчанию — `DepthLevel::FULL`
`$strict`	Режим сравнения названия. Значение `true` требует полного совпадения, `false` выполняет поиск по части строки. Значение по умолчанию — `false`
`$structureAction`	Действие из перечисления `StructureAction`, для которого нужно проверить доступ. Значение `null` отключает фильтр по правам
`$activeFilter`	Режим фильтрации по активности из перечисления `NodeActiveFilter`. Значение по умолчанию — `NodeActiveFilter::ONLY_GLOBAL_ACTIVE`
`$limit`	Максимальное количество узлов при поиске по названию или без родительских узлов. Значение по умолчанию — `100`

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

Метод возвращает коллекцию \Bitrix\HumanResources\Item\Collection\NodeCollection. Если подходящие узлы не найдены, коллекция будет пустой.

Особенности

При пустом $name и непустом $parentIds метод получает дочерние узлы и не применяет параметр $limit. Если оба параметра пустые, метод возвращает все подходящие узлы с учетом лимита.

Пример

<?php

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

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

// Название или часть названия существующего подразделения
$name = 'Отдел продаж';
$nodes = Container::getNodeService()->findAllByName($name, limit: 20);

foreach ($nodes as $node)
{
	echo $node->id . ': ' . $node->name . PHP_EOL;
}

Пользовательские комментарии

Помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

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

Наверх