Документация по iSpring Learn

Дерево страниц

ДОСТУПНО В BUSINESS ПОДПИСКЕ

Метод: changeUserSubordination

Права для выполнения запроса 

Владелец и Администратор аккаунта или роль с индивидуальными настройками, которая позволяет просмотривать, создавать, редактировать и удалять пользователя.

Администратор подразделения и пользователь с ролью с индивидуальными настройками могут назначать руководителя только на сотрудников, которыми управляют.

  • Владелец и Администратор аккаунта могут назначить себя руководителями.

  • Администратор подразделения и пользователь с ролью с индивидуальными настройками не могут назначать себя руководителем.

Параметры запроса

Параметр

Тип

Описание

token (обязательный)stringТокен доступа. Вы можете получить токен с помощью запроса
userId (обязательный)stringID сотрудника, о котором вы хотите получить информацию
subordination (необязательный)arrayОбъект с данными о типе подчинения линейного руководителя
coSubordination (необязательный)arrayОбъект с данными о типе подчинения функционального руководителя
subordinationType (обязательный)string

Тип подчинения линейного и фукнционального руководителя.

Возможные значения:

  • inherit — наследуется от вышестоящего подразделения,
  • manual — указать вручную,
  • no_supervisor — без руководителя
supervisorId (необязательный)stringID руководителяУказываете, если subordinationType = manual
-Если subordinationType = inherit, no_supervisor, указывать не нужно

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

После того, как запрос был успешно обработан, система отправляет объект со следующими свойствами:

Параметр

Тип

Описание

success

bool

True, если тип подчинения руководителя изменился

Возможные ошибки

Тип

Описание

Permission deniedНедостаточно прав у пользователя для выполнения запроса
Wrong parametersНе удалось обработать запрос, т.к. он не включает все нужные параметры или они заданы неверно

Пример запроса

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://ispringlearn.com/go/services/api/soap">
   <soapenv:Body>
      <soap:ChangeUserSubordinationRequest>
         <soap:credentials>
            <soap:token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</soap:token>
         </soap:credentials>
         <soap:userId>0ccca211-b60f-11ea-bc49-028d9ecdf612</soap:userId>
         <soap:subordination>
            <soap:subordinationType>manual</soap:subordinationType>
            <soap:supervisorId>ea100904-279b-11ed-82e7-0242ac160042</soap:supervisorId>
         </soap:subordination>
         <soap:coSubordination>
            <soap:subordinationType>inherit</soap:subordinationType>
         </soap:coSubordination>
      </soap:ChangeUserSubordinationRequest> 
   </soapenv:Body>
</soapenv:Envelope>

Пример ответа

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://ispringlearn.com/go/services/api/soap">
    <SOAP-ENV:Body>
        <ns1:SuccessResult>
            <ns1:success>true</ns1:success>
        </ns1:SuccessResult>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
  • Нет меток