Получение информации о пользователе
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>