ПланФикс API user.update

Материал из ПланФикс
Перейти к: навигация, поиск

Функция обновления данных пользователя. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="user.update">
  <account></account>
  <sid></sid>
  <user>
    <id></id>
    <name></name>
    <lastName></lastName>
    <email></email>
    <jabber></jabber>
    <role></role>
    <status></status>
    <password></password>
    <notify>
      <byEmail></byEmail>
      <byJabber></byJabber>
      <byPlanfix></byPlanfix>
    </notify>
    <birthdate></birthdate>
    <sex></sex>
    <phone></phone>
    <coeff></coeff>
    <timezone></timezone>
    <useDst></useDst>
    <isInvisibleOutOfGroup></isInvisibleOutOfGroup>
    <isBlindOutOfGroup></isBlindOutOfGroup>
    <userPic></userPic>
    <post>
        <id></id>
    </post>
  </user>
  <signature></signature>
</request>
Название Тип Значение Примечание
id int
name string имя, отчество пользователя необязательное поле
lastName string фамилия пользователя необязательное поле
email string электронный адрес почты необязательное поле
jabber string jabber-аккаунт необязательное поле
role enum роль пользователя в системе необязательное поле. доступно для изменения только пользователям с правами администратор. полный список смотри в разделе роли пользователей
status enum статус необязательное поле. доступно для изменения только пользователям с правами администратор. список допустимых значений смотри в разделе статусы пользователей
password string пароль необязательное поле
notify уведомления необязательное поле
notify.byEmail bool получать уведомления по электронной почте необязательное поле
notify.byJabber bool получать уведомления по jabber необязательное поле
notify.byPlanfix bool получать уведомления по внутренней системе уведомлений ПланФикс необязательное поле
birthdate DateTime дата рождения необязательное поле
sex enum пол сотрудника необязательное поле. список допустимых значений смотри в разделе пол сотрудника
phone string телефон необязательное поле
coeff float личный коэффициент необязательное поле. доступно для изменения только пользователям с правами администратор
timezone int часовой пояс необязательное поле. Допустимые значения от -12 до 14
useDst bool переход на летнее время необязательное поле
isInvisibleOutOfGroup bool true=Видит только членов своих групп; false=Видит всех сотрудников необязательное поле. доступно для изменения только пользователям с правами администратор
isBlindOutOfGroup bool true=Его видят только члены его групп; false=Его видят все сотрудники необязательное поле. доступно для изменения только пользователям с правами администратор
userPic string base64 закодированная картинка необязательное поле
post.id int должность которую занимает пользователь необязательное поле


Результат успешного выполнения функции:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <user>
    <id></id>
  </user>
</response>
Название Тип Значение Примечание
user.id int идентификатор обновляемого пользователя


В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти