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

Версия 11:33, 23 августа 2010

Добавление действия. Можно добавить комментарий или тайм треккинг:

<?xml version="1.0" encoding="UTF-8"?>
<request method="action.add">
  <account></account>
  <sid></sid>
  <action>
    <description></description>
    <timeTracker>
      <workDate></workDate>
      <beginTime></beginTime>
      <endTime></endTime>
      <workKind>
        <id></id>
        <name></name>
        <workType>
          <id></id>
          <name></name>
        </workType>
      </workKind>
    </timeTracker>
    <task>
      <id></id>
      <title></title>
    </task>
    <notifiedList>
      <user>
        <id></id>
        <id></id>
        <!-- ... -->
      </user>
    </notifiedList>
    <reminder>
      <date></date>
    </reminder>
  </action>
  <sirnature></sirnature>
</request>

Название	Тип	Значение	Примечание
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	дата когда необходимо уведомить

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

<?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	неизвестная ошибка

Перейти

@@ Строка 41: / Строка 41: @@
 !width="150"|Название !!width="200"| Тип !!width="50%"| Значение !! Примечание
 |-
-|description ||string || ||
+|description ||string ||текст с описанием действия, комментарий ||
 |-
-|timeTracker || || ||
+|timeTracker || ||таймтрекер || не обязательный параметр. если отсутствует, то это обычный комментарий
 |-
-|timeTracker.workDate||DateTime || ||
+|timeTracker.workDate||DateTime ||дата действия ||
 |-
-|timeTracker.beginTime||Time || ||
+|timeTracker.beginTime||Time ||час начала ||
 |-
-|timeTracker.endTime||Time || ||
+|timeTracker.endTime||Time ||час окончания ||
 |-
-|timeTracker.workKind|| || ||
+|timeTracker.workKind|| ||тип работы ||
 |-
-|timeTracker.workKind.id ||int || ||
+|timeTracker.workKind.id ||int ||идентификатор типа работы ||
 |-
-|timeTracker.workKind.workType || || ||
+|timeTracker.workKind.workType || ||вид выполненной работы ||
 |-
-|timeTracker.workKind.workType.id ||int || ||
+|timeTracker.workKind.workType.id ||int ||идентификатор выполненной работы ||
 |-
-|task || || ||
+|task || ||задача, в рамках которой выполняется это действие ||
 |-
-|task.id  ||int || ||
+|task.id  ||int ||идентификатор задачи ||
 |-
-|notifiedList || || ||
+|notifiedList || ||этим действием необходимо уведомить следующих пользователей ||необязательный параметрполе
 |-
-|notifiedList.user || || ||
+|notifiedList.user || || список пользователей которые получат уведомление ||
 |-
-|notifiedList.user.id ||int || ||
+|notifiedList.user.id ||int || идентификатор пользователя ||
 |-
-|reminder || || ||
+|reminder || ||  ||необязательный параметр
 |-
-|reminder.date ||DateTime || ||
+|reminder.date ||DateTime || дата когда необходимо уведомить ||
 |-
 |}