Перейти к основному содержимому

Обновить данные сотрудника в узле оргструктуры

PUT 
/api/v1/clients/:clientId/orgStructures/:id/elements/:elementId/employees/:employeeId

Описание метода​

Обновляет данные сотрудника в указанном узле оргструктуры. Сейчас в теле редактируется только название должности сотрудника в узле (positionName); состав сотрудников узла не меняется, счётчики у узла и предков от этой операции не меняются. В affectedElements возвращается только сам узел с актуальными счётчиками — цепочка предков не раскрывается, так как операция не меняет счётчики родителей.

Если новое название должности (после trim()) совпадает с текущим — операция трактуется как no-op: БД не меняется, версия оргструктуры не увеличивается, в ответе — тот же узел с актуальными счётчиками.

Имя EMPLOYEE_AS_NODE-узла и должность сотрудника в узле живут независимо: при создании такого узла его имя копируется из названия должности сотрудника, но после создания эти поля не синхронизируются — этот метод меняет только должность сотрудника, имя узла переименовывается отдельно через обновление узла.

Валидации запроса​

  • Тело запроса задано.

  • Название должности не пусто и не состоит из пробелов после trim(), длина не больше 200 символов.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID; клиент существует, не удалён, к нему относится пользователь, выполняющий операцию.

  • У пользователя клиента есть право ORG_STRUCTURES_UPDATE.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. оргструктуры соответствует формату UUID; оргструктура существует, принадлежит клиенту, не является Юридической, находится в статусе DRAFT.

  • Если version задана — совпадает с актуальной версией оргструктуры в БД.

  • Режим редактирования оргструктуры свободен либо захвачен инициатором операции.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. узла соответствует формату UUID; узел существует в указанной оргструктуре.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудника соответствует формату UUID; сотрудник состоит в этом узле.

  • Функционал оргструктур включён в настройках клиента.

Request​

Responses​

Успешная операция.