Различия

Показаны различия между двумя версиями страницы.

--- product:api:list:editperson [15.07.2019 06:09] – ↷ Страница перемещена из product:api:editperson в product:api:list:editperson mayn
+++ product:api:list:editperson [11.10.2024 05:14] (текущий) – [Передаваемые параметры] ekaterina.menkhuzina
@@ Строка 3: / Строка 3: @@
 Метод: **EditPerson**
-=====Передаваемые параметры=====
+Пользователю, инициирующему сессию с ASPNETSessionId, не обязательно иметь лицензию «Администратор», достаточно обладать правами: «Просмотр пользователей», «Создание и приглашение пользователей» и «Изменение профайлов пользователей».
+Пользователь, инициирующий сессию с ASPNETSessionId для изменения своего профиля, может это сделать без проверки указанных выше прав. Исключение: параметры allowLogin, LicenseType и ExpireDate может изменить только Администратор.
+=====Передаваемые параметры=====
 ^Параметр^Описание^
-|ASPNETSessionId''*''|Идентификатор сессии|
+|ASPNETSessionId*|Идентификатор сессии|
-|uid''*''|Идентификатор пользователя|
+|uid*|Идентификатор пользователя|
 |firstName|Имя|
 |lastName|Фамилия|
@@ Строка 19: / Строка 20: @@
 |email|E-Mail|
 |photoBase64|Фотография в кодировке Base64 (null если изменения не требуются)|
-|allowLogin|Разрешить пользователю доступ в систему True/False|
+|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** – Нет  |
+%%*%% -- параметры, обязательные для заполнения. \\
+%%**%% -- эти параметры может указать только пользователь с лицензией «Администратор», для пользователей с другими типами лицензий параметры игнорируются. \\
 <code xml>
@@ Строка 40: / Строка 56: @@
       <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>