ПланФикс API task.getList

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

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

<?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>


Перейти