ipr.employee.get
Scope:
iprКто может вызывать: Сам сотрудник либо тот, кто им управляет (
canManageEmployee: руководитель по оргструктуре, HR, администратор). Подробнее: Модель доступа
Возвращает профиль развития сотрудника: должность, полученные компетенции и компетенции «поддерживает», сроки действия компетенций, а также справочного и вычисленного руководителя.
HTTP: GET
Побочные эффекты: none
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
userId |
int |
нет | ID сотрудника. По умолчанию — текущий пользователь |
Возвращаемые данные
| Поле | Тип | Описание |
|---|---|---|
userId |
int |
ID сотрудника |
positionId |
int|null |
ID элемента инфоблока должностей (UF_POSITION) |
competenceIds |
int[] |
ID полученных компетенций |
supportCompetenceIds |
int[] |
ID компетенций, которые сотрудник «поддерживает» |
competenceActiveUntil |
array |
Активные строки журнала компетенций: { competenceId, activeUntil }[], activeUntil — YYYY-MM-DD или null (бессрочно) |
lineManagerId |
int|null |
Значение пользовательского поля UF_LINE_MANAGER_ID «как есть». Справочное поле: ИПР его не использует |
defaultManagerId |
int |
Руководитель, которого ИПР реально подставляет в карточку: определяется кастомной функцией либо главой подразделения сотрудника; если не найден — 1 |
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
NOT_FOUND |
Пользователь не найден |
PERMISSION_DENIED |
Нет прав смотреть профиль этого сотрудника |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/ipr.employee.get.json"
-H "Accept: application/json"
--data-urlencode "userId=15"
Пример ответа
{
"result": {
"result": {
"userId": 15,
"positionId": 210,
"competenceIds": [501, 502],
"supportCompetenceIds": [502],
"competenceActiveUntil": [
{ "competenceId": 501, "activeUntil": "2027-03-31" },
{ "competenceId": 502, "activeUntil": null }
],
"lineManagerId": null,
"defaultManagerId": 8
},
"total": null,
"next": null,
"error": null
}
}
См. также
Предыдущая
Следующая