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

Версия 07:45, 28 марта 2013

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

<?xml version="1.0" encoding="UTF-8"?>
<request method="task.getList">
  <account></account>
  <sid></sid>
  <user>
    <id></id>
  </user>
  <target></target>
  <project>
    <id></id>
  </project>
  <sort></sort>
  <status></status>
  <pageCurrent></pageCurrent>
  <pageSize></pageSize>
  <filter></filter>
  <signature></signature>
</request>

Название	Тип	Значение	Примечание
user		если указан этот параметр, то результатом будет список задач для указанного пользователя	допустим только для пользователей с правами администратора
user.id	int	идентификатор пользователя
target	enum	входящие, исходящие или все	допустимые значения смотри ниже
project		фильтр по проекту	необязательный параметр
project.id	int	идентификатор проекта
sort	enum	тип сортировка	список допустимых значений смотри в разделе типы сортировок задач
status	enum	статус	перечень допустимых значений смотри в разделе статусы задач
pageCurrent	int	текущая страница	0 - используется для получения количества задач
pageSize	int	размер возвращаемого списка	0 - используется значение по умолчанию
filter	set	дополнительный фильтр, допустимые значения смотри ниже

Допустимые значения параметра target

Значение	Описание	Примечание
all	все
in	входящие	значение по умолчанию
out	исходящие

Допустимые значения для параметра filter

Значение	Описание	Примечание
ACTIVE	активные задачи
OVERDUE	просроченные задачи
MY	мои задачи

Значение параметра может представлять комбинацию допустимых значений, например:

  <filter>ACTIVE MY</filter>

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

В случае удачного выполнения функции будет получен ответ следующего вида:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <tasks count="count" totalCount="totalCount">
    <task>
      <id></id>
      <!-- ... -->
    </task>
    <!-- ... -->
  </tasks>
</response>

Название	Тип	Значение	Примечание
tasks		корневой элемент, содержит список задач
tasks count	int	количество задач возвращенных в результате выполнения функции
tasks totalCount	int	количество задач удовлетворяющих условиям запроса
task		задача	описание данного параметра смотрите в секции ответ на получении карточки задачи

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

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

Перейти

@@ Строка 37: / Строка 37: @@
 |status ||enum || статус||перечень допустимых значений смотри в разделе [[ПланФикс API:Статусы задач|статусы задач]]
 |-
-|pageCurrent ||int || текущая страница || 0 - используется для получения количества проектов
+|pageCurrent ||int || текущая страница || 0 - используется для получения количества задач
 |-
 |pageSize ||int || размер возвращаемого списка || 0 - используется значение по умолчанию