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

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Информация

При запросе getUserProfile вы получите одинаковый статус для уволенных и заблокированных — 3

Чтобы различать статус уволенных и заблокированных статусы сотрудников, используйте запрос getUserProfileV2. Так, в параметре status заблокированные сотрудники будут обозначаться статусом 3, уволенные — 5.

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

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

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

...

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

...
ПараметрТипОписание
userIdstringID пользователя.
statusint

Статус пользователя:

1 — активный,

3 — неактивный.

3 — неактивный,

5 — уволенный

departmentIdstringПодразделение, в котором состоит пользователь.
emailstringEmail пользователя.
groupsstring[]ID групп, в которых состоит пользователь.
fieldsstring[][2]Поля профиля пользователя (UserFields)  — массив объектов со следующими со следующими свойствами: Id, value.
addedDatedateДата добавления пользователя.
lastLoginDatedateДата последнего входа пользователя в аккаунт.
manageableDepartmentIdsstring[]ID подразделенийID подразделений, которыми управляет пользователь, если его роль — роль — администратор подразделения или автор.
rolestringРоль пользователя.
subordination (необязательный)arrayОбъект с данными о типе подчинения линейного руководителя.
coSubordination (необязательный)arrayОбъект с данными о типе подчинения функционального руководителя.
subordinationType (обязательный)string

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

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

  • inherit — Наследуется от вышестоящего подразделения.,
  • manual — Указать вручную.,
  • no_supervisor — Без руководителя
workLeaveStatus (необязательный)string

Рабочий статус отсутствия. Массив с параметрами:

  • workLeaveReason — причины отсутствия,
  • startDate — дата начала отсутствия. Указывается в формате yyyy-mm-dd,
  • endDate — дата завершения отсутствия. Указывается в формате yyyy-mm-dd
supervisorId (необязательный)stringID руководителяУказываете, если subordinationType = manual
-Если subordinationType = inherit, no_supervisor, указывать не нужно

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

ОшибкиОписание
Unknown userПользователь с указанным ID не найден
Permission deniedУ пользователя недостаточно прав для получения информации.

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

Блок кода
languagexml
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
    <GetUserProfileRequest>
      <credentials>
           <accountUrl>https://myaccount.ispringlearn.ru</accountUrl>  <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
        <email>email@email.com</email>
        <password>password</password>
         </credentials>
      <userId>string</userId>
    </GetUserProfileRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

...