Управление персоналом

\Bitrix\HumanResources — пространство имен модуля Управление персоналом, который доступен только в Битрикс24.

API предназначен для работы с организационной структурой компании, ее подразделениями, командами и участниками.

Подключение модуля

Перед обращением к API подключите модуль:

use Bitrix\Main\Loader;

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

Основные понятия

• Организационная структура — иерархия узлов, которая описывает подразделения и команды компании.
• Узел — элемент организационной структуры. Узел хранит свое положение в иерархии и может иметь родительские и дочерние узлы.
• Участник узла — запись о связи пользователя с узлом и его роли в этом узле.
• Подразделение — узел для сотрудников в административной структуре компании.
• Команда — узел для объединения участников команды и описания их ролей.

Возможности API

API позволяет:

• находить узлы по идентификаторам, названиям, внешним идентификаторам, кодам доступа и участникам,
• получать корневой, родительские и дочерние узлы организационной структуры,
• находить участников узлов и ограничивать выборку по пользователям, ролям и типам узлов,
• получать руководителей, заместителей и подчиненных пользователей в подразделениях и командах,
• назначать пользователей в подразделения и проверять их положение в структуре,
• получать сведения о правах доступа пользователей,
• получать настройки пользователей, а также читать и изменять настройки узлов и подразделений,
• строить ORM-запросы к узлам и участникам с фильтрацией, сортировкой и ограничением выборки.

Пространства имен API

Статьи по работе с модулем

Раздел Управление персоналом содержит подробные материалы о возможностях API.