Редактирование пользователя

URL: components/services/persons.asmx

Метод: EditPerson

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

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

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

Параметр	Описание
`ASPNETSessionId`*	Идентификатор сессии
`uid`*	Идентификатор пользователя
`firstName`	Имя
`lastName`	Фамилия
`company`	Организация
`position`	Должность
`notes`	Заметки
`businessPhone`	Рабочий телефон
`mobilePhone`	Мобильный телефон
`fax`	Факс
`email`	E-Mail
`photoBase64`	Фотография в кодировке Base64 (null, если изменения не требуются)
`allowLogin`**	Разрешить пользователю доступ в систему True/False
`Login`**	Логин пользователя
`Password`**	Пароль пользователя
`LicenseType`**	Тип лицензии. Возможные значения: • Administrator (Администратор); • Director (Директор); • Supervisor (Руководитель); • Executor (Исполнитель); • Resource (Ресурс); • NOT_SET (Не выбрано). По умолчанию значение «Null» (тип лицензии остается прежним)
`ExpireDate`**	Дата окончания действия учетной записи (в формате ГГГГ-ММ-ДД). По умолчанию значение «Null» (значение параметра остается прежним). Для сброса параметра необходимо передать значение «NOT_SET» (отключается опция «Дата окончания действия учетной записи»).
`fields`	Массив пользовательских реквизитов профиля
`FieldWrapper`	Массив из полей, описывающих каждый реквизит (см. ниже)
`FieldName`	Название реквизита
`FieldId`	Идентификатор реквизита
`FieldVal`	Значение реквизита Дата вставляется в формате yyyy-MM-dd HH:mm:ssZ
`FieldType`	Тип реквизита
`questionsToEmail`	`(с версии 3.27)` Значение опции «Отправлять запросы на E-mail» карточки пользователя. Доступные значения: • Always – Всегда. • Never – Никогда. • WhenOffline – Только когда я не в системе
`messagesToEmail`	`(с версии 3.27)` Значение опции «Отправлять события на E-mail» карточки пользователя. Доступные значения: • Always – Всегда. • Never – Никогда . • WhenOffline – Только когда я не в системе
`notifyToAltEmail`	`(с версии 3.27)` Значение опции «Дублировать на дополнительный E-mail» карточки пользователя. Доступные значения: • True – Да. • False – Нет

* - параметры, обязательные для заполнения.

** - эти параметры может указать только пользователь с лицензией «Администратор», для пользователей с другими типами лицензий параметры игнорируются.

<?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:EditPerson>
         <str:ASPNETSessionId>string</str:ASPNETSessionId>
         <str:uid>string</str:uid>
         <str:firstName>string</str:firstName>
         <str:lastName>string</str:lastName>
         <str:company>string</str:company>
         <str:position>string</str:position>
         <str:notes>string</str:notes>
         <str:businessPhone>string</str:businessPhone>
         <str:mobilePhone>string</str:mobilePhone>
         <str:fax>string</str:fax>
         <str:email>string</str:email>
         <str:photoBase64>string</str:photoBase64>
         <str:questionsToEmail>string</str:questionsToEmail>
         <str:messagesToEmail>string</str:messagesToEmail>
         <str:notifyToAltEmail>boolean</str:notifyToAltEmail>
         <str:allowLogin>boolean</str:allowLogin>
         <str:login>string</str:login>
         <str:password>string</str:password>
         <str:licenseType>string</str:licenseType>
         <str:expireDate>string</str:expireDate>
 
      <!-- массив fields - описание изменяемых пользовательских реквизитов -->
         <str:fields>
            <str:FieldWrapper>
               <str:FieldName>string</str:FieldName>
               <str:FieldId>string</str:FieldId>
               <str:FieldVal>string</str:FieldVal>
               <str:FieldType>string</str:FieldType>
            </str:FieldWrapper>
         </str:fields>
         <str:prohibitAuthWithLocalAccount>boolean</str:prohibitAuthWithLocalAccount>
      </str:EditPerson>
   </soapenv:Body>
</soapenv:Envelope>

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

Параметр	Описание
`EditPersonResult`	Результат выполнения запроса

<?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">
      <EditPersonResponse xmlns="http://streamline/">
         <EditPersonResult>
            <Errors>
               <string>string</string>
            </Errors>
            <Objects>
               <string>string</string>
            </Objects>
         </EditPersonResult>
      </EditPersonResponse>
   </s:Body>
</s:Envelope>