ПланФикс API: Задачи: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
 
(не показано 38 промежуточных версий 4 участников)
Строка 1: Строка 1:
Список функций для управления задачами
{{#seo:
|title=ПланФикс API: Задачи
|titlemode=append
|keywords=планфикс, ПланФикс API: Задачи,API
|description=ПланФикс API: Задачи
}}
Список функций для управления задачами:
#[[ПланФикс API task.add|task.add / Добавление задачи]]
#[[ПланФикс API task.update|task.update / Обновление задачи]]
#[[ПланФикс API task.updateCustomData|task.updateCustomData / Обновление пользовательских полей задачи]]
#[[ПланФикс API task.get|task.get / Получение карточки задачи]]
#[[ПланФикс API task.getMulti|task.getMulti / Получение множества карточек задач]]
#[[ПланФикс API task.getList|task.getList / Список задач]]
#[[ПланФикс API task.accept|task.accept / Принять задачу]]
#[[ПланФикс API task.reject|task.reject / Отклонить задачу]]
#[[ПланФикс API task.changeExpectDate|task.changeExpectDate / Изменить дату выполнения задачи]]
#[[ПланФикс API task.changeStatus|task.changeStatus / Изменить статус задачи]]
#[[ПланФикс API task.getPossibleStatusToChange|task.getPossibleStatusToChange / Получить список возможных статусов для изменения]]
#[[ПланФикс API task.changeWorkers|task.changeWorkers / Изменить (добавить/удалить) исполнителей]]
#[[ПланФикс API task.getFilterList|task.getFilterList/ Получить список доступных фильтров задач]]


== task.add Добавление задачи==
Добавление:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request method="task.add">
  <account><!-- имя аккаунта --></account>
  <sid><!-- ключ сессии, полученный после аутентификации --></sid>
  <task>
    <title><!-- Название задачи --></title>
    <description><!-- О чем эта задача --></description>
    <importance><!-- Срочность  --></importance>
    <status><!-- Статус --></status>
    <checkResult>{true|false}</checkResult><!-- Является ли задача задачей с обязательной проверкой результата -->
<!-- Создатель задачи -->
    <owner>
      <id></id>
    </owner>
<!-- Над задача -->
    <parent>
      <id></id>
    </parent>
<!-- В рамках какого проекта поставлена задача -->
    <project>
      <id></id>
    </project>
<!-- Контрагент -->
    <client>
      <id></id>
    </client>
    <startTime><!-- Время начала (приступить к работе) --></startTime>
    <endTime><!-- Время окончания (закончить работу До) --></endTime>
  </task>
</request>
</source>


Ответ при удачном выполнении операции:
== Перейти ==
<source lang="xml">
[[Список функций]]
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<task>
<id></id>
</task>
</response>
</source>
 
== task.update Обновление задачи ==
 
== task.get Получение карточки задачи ==
Запрос на получение:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<request method="task.get">
<account><!-- имя аккаунта --></account>
<sid><!-- ключ сессии, полученный после аутентификации --></sid>
<id></id>
</request>
</source>
 
 
Ответ:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<task>
<id></id>
<title><!-- Название задачи --></title>
<description><!-- О чем эта задача --></description>
<importance><!-- Срочность  --></importance>
<status><!-- Статус --></status>
<checkResult>{true|false}</checkResult><!-- Является ли задача задачей с обязательной проверкой результата -->
<!-- Создатель задачи -->
<owner>
<id></id>
<name></name>
</owner>
<!-- Над задача -->
<parent>
<id></id>
</parent>
<!-- В рамках какого проекта поставлена задача -->
<project>
<id></id>
<title></title>
</project>
<!-- Контрагент -->
<client>
<id></id>
<name></name>
</client>
<beginDateTime><!-- Время создания задачи --></beginDateTime>
<startTime><!-- Время начала (приступить к работе) --></startTime>
<endTime><!-- Время окончания (закончить работу До) --></endTime>
<!-- Сквозной номер -->
<general></general>
 
<isOverdued><!-- Задача не выполнена в срок --></isOverdued>
<isCloseToDeadline><!-- Задача близка к дедлайну --></isCloseToDeadline>
<isNotAcceptedInTime><!-- Задача не принята вовремя --></isNotAcceptedInTime>
<!-- Помещена в избранные -->
<starred>{true|false}</starred>
</task>
</response>
</source>
 
== task.getList Список задач ==
 
== task.attachFile Прикрепить файл (скорее всего перенесем эту функцию) ==
 
== Константы ==
=== Срочность ===
*'''LOW''' - Не срочная
*'''AVERAGE''' - Обычная
*'''HIGH''' - Срочная
=== Статус ===
*'''DRAFT''' - Черновик
*'''ACTIVE''' - Активный но еще не принятый
*'''ACCEPTED''' - Принятый
*'''COMPLETED''' - Завершенный
*'''DELAYED''' - Отложенный
*'''REJECTED''' - Отклоненный
*'''DONE''' - Выполненный
*'''CANCELED''' - Отмененный

Текущая версия от 08:20, 12 июля 2022

Список функций для управления задачами:

  1. task.add / Добавление задачи
  2. task.update / Обновление задачи
  3. task.updateCustomData / Обновление пользовательских полей задачи
  4. task.get / Получение карточки задачи
  5. task.getMulti / Получение множества карточек задач
  6. task.getList / Список задач
  7. task.accept / Принять задачу
  8. task.reject / Отклонить задачу
  9. task.changeExpectDate / Изменить дату выполнения задачи
  10. task.changeStatus / Изменить статус задачи
  11. task.getPossibleStatusToChange / Получить список возможных статусов для изменения
  12. task.changeWorkers / Изменить (добавить/удалить) исполнителей
  13. task.getFilterList/ Получить список доступных фильтров задач


Перейти

Список функций

Источник — http://planfix.com/ru/help/index.php?title=ПланФикс_API:Задачи&oldid=40024