ПланФикс API user.get — различия между версиями

Текущая версия на 14:36, 12 января 2022

Функция получения информации о пользователе. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="user.get">
  <account></account>
  <sid></sid>
  <user>
    <id></id>
  </user>
  <signature></signature>
</request>

Название	Тип	Значение	Примечание
user.id	int	идентификатор пользователя	при отсутствии данного параметра, возвращаются данные сотрудника, от которого происходит запрос
signature	string(32)	подпись

Ответ:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <user>
    <id></id>
    <general></general>
    <name></name>
    <lastName></lastName>
    <midName></midName>
    <login></login>
    <email></email>
    <secondaryEmails>
        <email></email>
        <!-- ... -->
    </secondaryEmails>
    <role></role>
    <status></status>
    <birthdate></birthdate>
    <sex></sex>
    <phones>
        <phone>
            <number></number>
            <typeId><typeId>
            <typeName><typeName>
        </phone>
        ...
    </phones>
    <isInvisibleOutOfGroup></isInvisibleOutOfGroup>
    <isBlindOutOfGroup></isBlindOutOfGroup>
    <userPic></userPic>
    <isOnline></isOnline>
    <timezone></timezone>
    <post>
        <id></id>
        <name></name>
    </post>
    <userGroups>
      <userGroup>
        <id></id>
        <name></name>
      </userGroup>
      <userGroup>
        <id></id>
        <name></name>
      </userGroup>
      <!-- ... -->
    </userGroups>
  </user>
</response>

Название	Тип	Значение	Примечание
id	int	идентификатор сотрудника
general	int	номер сотрудника
name	string	имя, отчество пользователя
lastName	string	фамилия пользователя
midName	string	отчество пользователя
login	string	имя учетной записи в системе
email	string	электронный адрес почты
secondaryEmails.email		дополнительные адреса email, если есть
role	enum	роль пользователя в системе
status	enum	статус	список допустимых значений смотри в разделе статусы пользователей
birthdate	DateTime	дата рождения	если значение не установлено, то значение пусто
sex	enum	пол сотрудника	список допустимых значений смотри в разделе пол сотрудника, если значение не установлено, то значение пусто
phones		список телефонов
phones.phone.number	string	номер телефона
phones.phone.typeId	int	идентификатор типа номера телефона
phones.phone.typeName	string	название типа номера телефона
isInvisibleOutOfGroup	bool	true=Видит только членов своих групп; false=Видит всех сотрудников	доступно для пользователей с правами администратор
isBlindOutOfGroup	bool	true=Его видят только члены его групп; false=Его видят все сотрудники	доступно для пользователей с правами администратор
userPic	string	возвращает полный URL к картинке	если не установлен - узел пустой
timezone	string	часовой пояс сотрудника
post		должность пользователя
post.id	int	идентификатор должности
post.name	string	название должности
userGroups		список групп в которых состоит пользователь
userGroups.userGroup		группа
userGroups.userGroup.id	int	идентификатор группы
userGroups.userGroup.name	string	название группы

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

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

Перейти

@@ Строка 33: / Строка 33: @@
    <user>
      <id></id>
+    <general></general>
      <name></name>
      <lastName></lastName>
+    <midName></midName>
      <login></login>
      <email></email>
@@ Строка 57: / Строка 59: @@
      <userPic></userPic>
      <isOnline></isOnline>
+    <timezone></timezone>
      <post>
          <id></id>
@@ Строка 78: / Строка 81: @@
 !width="150"|Название !!width="200"| Тип !!width="50%"| Значение !! Примечание
 |-
-|id ||int || ||
+|id ||int || идентификатор сотрудника ||
+|-
+|general ||int || номер сотрудника ||
 |-
 |name ||string ||имя, отчество пользователя ||
 |-
 |lastName ||string ||фамилия пользователя ||
+|-
+|midName ||string ||отчество пользователя ||
 |-
 |login ||string ||имя учетной записи в системе ||
@@ Строка 111: / Строка 118: @@
 |-
 |userPic ||string || возвращает полный URL к картинке || если не установлен - узел пустой
+|-
+|timezone||string || часовой пояс сотрудника ||
 |-
 |post || || должность пользователя ||