Api модуля humanresources. Отделы. Часть 2.

Получить список отделов

use Bitrix\HumanResources\Service\NodeService;

$nodeService = new NodeService();
$nodeId = 1;
$nodes = $nodeService->getNodeChildNodes($nodeId)->getItemMap();

$arResult = [];
foreach ($nodes as $node) {
    $arResult[$node->id] = $node->name;
}

Метод getNodeChildNodes()Bitrix\HumanResources\Item\Collection\NodeCollection

Описание методов коллекции

$nodeService
   ->getNodeChildNodes($nodeId)
   ->filter(fn($node) => $node->id === 1);

Рассмотрим объект класса Bitrix\HumanResources\Item\Node

Получить список отделов напрямую из таблицы

use Bitrix\HumanResources\Model\NodeTable;

$nodeId = 3;
$structureId = 1;
$nodes = NodeTable::getList([
    'select' => ['*'],
    'filter' => ['=PARENT_ID' => $nodeId, '=STRUCTURE_ID' => $structureId],
])->fetchAll();

Получить отделы, в которых работает сотрудник

use Bitrix\HumanResources\Model\NodeMemberTable;  
use Bitrix\HumanResources\Model\NodeTable;  
use Bitrix\Main\Engine\CurrentUser;  
use Bitrix\Main\ORM\Query\Join;  
use Bitrix\HumanResources\Service\NodeService;  

// через api
$nodeService = new NodeService();  
$result = $nodeService->getNodesByUserId(1);

// через таблицы
$nodes = NodeMemberTable::getList([  
    'filter' => ['ENTITY_ID' => CurrentUser::get()->getId(), 'ACTIVE' => 'Y'],  
    'select' => ['ID', 'DEPARTMENT'],  
    'runtime' => [  
        'DEPARTMENT' =>  
            [  
                'data_type' => NodeTable::class,  
                'reference' => ['=this.NODE_ID' => 'ref.ID'],  
                'join_type' => Join::TYPE_LEFT  
            ]  
    ]  
])->FetchCollection();  
  
foreach ($nodes as $node) {  
    echo $node->get('DEPARTMENT')->getName();  
    echo '<br>';  
}

Создать отдел

use Bitrix\HumanResources\Exception\CreationFailedException;  
use Bitrix\HumanResources\Item\Node;  
use Bitrix\HumanResources\Service\NodeService;  
use Bitrix\HumanResources\Type\NodeEntityType;

/** на вход свойства объекта Bitrix\HumanResources\Item\Node
 * @param string $name  
 * @param NodeEntityType = DEPARTMENT  
 * @param int $structureId =1  
 * @param ?string $accessCode  
 * @param ?int $id  
 * @param ?int $parentId  
 */  
$node = new Node(  
    'It-отдел',  
    NodeEntityType::DEPARTMENT,  
    1,  
    null,  
    null,  
    1  
);  
try {  
    $nodeService->insertNode($node);  
} catch (Exception $e) {  
    print_r($e->getErrors()->toArray());  
}

Обновить описание и переместить отдел в подчинение другому отделу

use Bitrix\HumanResources\Repository\NodeRepository;  
use Bitrix\HumanResources\Service\NodeService;  

$nodeService = new NodeService();  
$nodeRepository = new NodeRepository();  

$departmentId = 9;  
$node = $nodeRepository->getById($departmentId);  
$node->description = "Просто какое-то описание";  
$node->parentId = 2;

try {  
    $nodeService->updateNode($node);  
} catch (Exception $e) {  
    print_r($e->getErrors()->toArray());  
}

Удалить отдел

use Bitrix\HumanResources\Exception\DeleteFailedException;  
use Bitrix\HumanResources\Repository\NodeRepository;  
use Bitrix\HumanResources\Service\NodeService;  

$nodeService = new NodeService();  
$nodeRepository = new NodeRepository();  

$departmentId = 9;  
$node = $nodeRepository->getById($departmentId);  

try {  
    $nodeService->removeNode($node);  
} catch (DeleteFailedException $e) {  
    print $e->getErrors()->toArray();  
}

Полезные ссылки

• Статья о разработке новой структуры в блоге Битрикс24 на хабре
• Статья об оргструктуре в книге разработчика Битрикс24
• Новая структура компании в Битрикс24. Часть 1
• Api модуля humanresources. Сотрудники. Часть 3