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

Метод: EditPerson

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

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

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

ПараметрОписание
ASPNETSessionId*Идентификатор сессии
uid*Идентификатор пользователя
firstNameИмя
lastNameФамилия
companyОрганизация
positionДолжность
notesЗаметки
businessPhoneРабочий телефон
mobilePhoneМобильный телефон
faxФакс
emailE-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>