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

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

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

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

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