Содержание

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


URL: components/services/persons.asmx

Метод: GetPerson

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

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

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

ПараметрОписание
ASPNETSessionIdИдентификатор сессии
uidИдентификатор пользователя
<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:str="http://streamline/">
   <soapenv:Header/>
   <soapenv:Body>
      <str:GetPerson>
         <str:ASPNETSessionId>string</str:ASPNETSessionId>
         <str:uid>string</str:uid>
      </str:GetPerson>
   </soapenv:Body>
</soapenv: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"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <GetPersonResponse xmlns="http://streamline/">
         <GetPersonResult>
            <Errors/>
            <Objects>
               <SlPerson>
                  <UID>string</UID>
                  <FullName>string</FullName>
                  <EMail>string</EMail>
                  <URL>string</URL>
                  <LinksToOpenIdConnect/>
                  <ChangedAt>dateTime</ChangedAt>
                  <LicenseType>string</LicenseType>
                  <ExpireDate>string</ExpireDate>
                  <QuestionsToEmail>string</QuestionsToEmail>
                  <MessagesToEmail>string</MessagesToEmail>
                  <NotifyToAltEmail>string</NotifyToAltEmail>
                  <Groups>
                     <GroupWrapper>
                        <Id>string</Id>
                     </GroupWrapper>
                     <GroupWrapper>
                        <Id>string</Id>
                     </GroupWrapper>
                  </Groups>
               </SlPerson>
            </Objects>
            <Persons>
               <SlPerson>
                  <UID>string</UID>
                  <FullName>string</FullName>
                  <EMail>string</EMail>
                  <URL>string</URL>
                  <LinksToOpenIdConnect/>
                  <ChangedAt>string</ChangedAt>
                  <LicenseType>string</LicenseType>
                  <ExpireDate>string</ExpireDate>
                  <QuestionsToEmail>string</QuestionsToEmail>
                  <MessagesToEmail>string</MessagesToEmail>
                  <NotifyToAltEmail>string</NotifyToAltEmail>
                  <Groups>
                     <GroupWrapper>
                        <Id>string</Id>
                     </GroupWrapper>
                     <GroupWrapper>
                        <Id>string</Id>
                     </GroupWrapper>
                  </Groups>
               </SlPerson>
            </Persons>
         </GetPersonResult>
      </GetPersonResponse>
   </s:Body>
</s:Envelope>