Получение информации о пользователе

Метод: GetPerson

Пользователю, инициирующему сессию с ASPNETSessionId, не обязательно иметь лицензию «Администратор», достаточно обладать правом «Просмотр пользователей».

Пользователь, инициирующий сессию с ASPNETSessionId для просмотра своего профиля, может это сделать без указанного выше права, в том числе параметры LicenseType и ExpireDate.

Передаваемые параметры

Параметр	Описание
ASPNETSessionId	Идентификатор сессии
uid	Идентификатор пользователя

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetPerson xmlns="http://streamline/">
      <ASPNETSessionId>string</ASPNETSessionId>
      <uid>string</uid>
    </GetPerson>
  </soap:Body>
</soap:Envelope>

Возвращаемые параметры

Параметр	Описание
UID	Идентификатор пользователя
FullName	Полное имя пользователя
EMail	Электронный почтовый ящик пользователя
URL	Ссылка на пользователя
LinkToAD	Привязка пользователю к Active Directory
LicenseType**	Тип лицензии. Возможные значения: Administrator (Администратор), Director (Директор), Supervisor (Руководитель), Executor (Исполнитель), Resource (Ресурс), NOT_SET (Не выбрано).
ExpireDate**	Дата окончания действия учетной записи (в формате ГГГГ-ММ-ДД). Если учетная запись бессрочная, то возвращается «NOT_SET»
PersonsGroupsWrapper*	Список с группами пользователей Системы, где состоит пользователь
PersonsGroupId	Идентификатор группы
questionsToEmail	`(с версии 3.27)` Значение опции «Отправлять запросы на E-mail» карточки пользователя. Доступные значения: • Always – Всегда. • Never – Никогда. • WhenOffline – Только когда я не в системе
messagesToEmail	`(с версии 3.27)` Значение опции «Отправлять события на E-mail» карточки пользователя. Доступные значения: • Always – Всегда. • Never – Никогда . \\• WhenOffline – Только когда я не в системе
notifyToAltEmail	`(с версии 3.27)` Значение опции «Дублировать на дополнительный E-mail» карточки пользователя. Доступные значения: • True – Да. • False – Нет
LinksToOpenIdConnect	`(с версии 3.29)` Содержит в себе массив <OpenIdConnectPersonLink>, то есть массив идентификаторов пользователей в сервисе (NameIdentifier) и идентификаторы провайдера авторизации (AuthenticationType)

* – в списке групп всегда отображается системная группа «Все пользователи».
** – значения этих параметров возвращают только Администратору.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetPersonResponse xmlns="http://streamline/">
      <GetPersonResult>
        <Persons>
          <SlPerson>
            <UID>string</UID>
            <FullName>string</FullName>
            <EMail>string</EMail>
            <URL>string</URL>
            <LinkToAD>string</LinkToAD>
            <ChangedAt>dateTime</ChangedAt>
            <LicenseType>string</LicenseType>
            <ExpireDate>string</ExpireDate>
            <Groups xsi:nil="true" />
          </SlPerson>
          <SlPerson>
            <UID>string</UID>
            <FullName>string</FullName>
            <EMail>string</EMail>
            <URL>string</URL>
            <LinkToAD>string</LinkToAD>
            <ChangedAt>dateTime</ChangedAt>
            <LicenseType>string</LicenseType>
            <ExpireDate>string</ExpireDate>
            <Groups xsi:nil="true" />
          </SlPerson>
        </Persons>
      </GetPersonResult>
    </GetPersonResponse>
  </soap:Body>
</soap:Envelope>

Пример запроса с добавленным в версии системы 3.29 параметром LinksToOpenIdConnect:

<?xml version="1.0" encoding="utf-8"?>
<PersonQueryResult xmlns="http://streamline/">
  <Persons>
    <SlPerson>
      <UID>string</UID>
      <FullName>string</FullName>
      <EMail>string</EMail>
      <URL>string</URL>
      <LinkToAD>string</LinkToAD>
      <LinksToOpenIdConnect>
        <OpenIdConnectPersonLink d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <OpenIdConnectPersonLink d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </LinksToOpenIdConnect>
      <ChangedAt>dateTime</ChangedAt>
      <LicenseType>string</LicenseType>
      <ExpireDate>string</ExpireDate>
      <QuestionsToEmail>string</QuestionsToEmail>
      <MessagesToEmail>string</MessagesToEmail>
      <NotifyToAltEmail>string</NotifyToAltEmail>
      <Groups>
        <GroupWrapper d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <GroupWrapper d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </Groups>
    </SlPerson>
    <SlPerson>
      <UID>string</UID>
      <FullName>string</FullName>
      <EMail>string</EMail>
      <URL>string</URL>
      <LinkToAD>string</LinkToAD>
      <LinksToOpenIdConnect>
        <OpenIdConnectPersonLink d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <OpenIdConnectPersonLink d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </LinksToOpenIdConnect>
      <ChangedAt>dateTime</ChangedAt>
      <LicenseType>string</LicenseType>
      <ExpireDate>string</ExpireDate>
      <QuestionsToEmail>string</QuestionsToEmail>
      <MessagesToEmail>string</MessagesToEmail>
      <NotifyToAltEmail>string</NotifyToAltEmail>
      <Groups>
        <GroupWrapper d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <GroupWrapper d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </Groups>
    </SlPerson>
  </Persons>
</PersonQueryResult>