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

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Получение информации о пользователе ======

Метод: **GetPerson**

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

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


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

<code xml>
<?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>
</code>

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

^Параметр^Описание^
|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)|
%%*%% -- в списке групп всегда отображается системная группа «Все пользователи». \\
%%**%% -- значения этих параметров возвращают только Администратору. \\

<code xml>
<?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>
</code>

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

<code xml>
<?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>
</code>