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

Материал из ПланФикс
Версия от 11:57, 23 августа 2010; Seva (обсуждение | вклад) (Новая страница: «Функция обновления данных в действии. Формат запроса: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <reques...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

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

<?xml version="1.0" encoding="UTF-8"?>
<request method="action.update">
  <account></account>
  <sid></sid>
  <action>
    <id></id>
    <description></description>
    <timeTracker>
      <workDate></workDate>
      <beginTime></beginTime>
      <endTime></endTime>
      <workKind>
        <id></id>
        <workType>
          <id></id>
        </workType>
      </workKind>
    </timeTracker>
    <notifiedList>
      <user>
        <id></id>
        <id></id>
        <!-- ... -->
      </user>
    </notifiedList>
    <reminder>
      <date></date>
    </reminder>
  </action>
  <signature></signature>
</request>
Название Тип Значение Примечание
id int идентификатор действия
description string текст с описанием действия, комментарий
timeTracker таймтрекер
timeTracker.workDate DateTime дата действия
timeTracker.beginTime Time час начала
timeTracker.endTime Time час окончания
timeTracker.workKind тип работы
timeTracker.workKind.id int идентификатор типа работы
timeTracker.workKind.workType вид выполненной работы
timeTracker.workKind.workType.id int идентификатор выполненной работы
task задача, в рамках которой выполняется это действие
task.id int идентификатор задачи
notifiedList этим действием необходимо уведомить следующих пользователей
notifiedList.user список пользователей которые получат уведомление
notifiedList.user.id int идентификатор пользователя
reminder необязательный параметр
reminder.date DateTime дата когда необходимо уведомить

Помните, можно обновлять действия с типом ACTION и COMMENT. Остальные попытки будут вызывать ошибку.


Результат удачного выполнения запроса:

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

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

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>
Значение code Расшифровка
0000 неизвестная ошибка


Перейти