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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показана 1 промежуточная версия 1 участника)
Строка 1: Строка 1:
{{#seo:
|title=ПланФикс API task.changeStatus
|titlemode=append
|keywords=планфикс, задачи, статусы, апи, api
|description=Изменение статуса задачи
}}
Изменение статуса задачи. Формат вызова функции:
Изменение статуса задачи. Формат вызова функции:
<source lang="xml">
<source lang="xml">
Строка 7: Строка 14:
   <task>
   <task>
     <id></id>
     <id></id>
    <general></general>
   </task>
   </task>
   <status></status>
   <status></status>
Строка 17: Строка 25:
|-
|-
|task.id ||int || идентификатор задачи ||
|task.id ||int || идентификатор задачи ||
|-
|general||int ||номер задачи (если задан, используется вместо id)||
|-
|-
|status ||enum  || новый статус задачи||Допустимы значения из раздела [[ПланФикс API:Системные статусы задач|Системные статусы задач]] или идентификаторы статусов, полученные в результате вызова функции [[ПланФикс API taskStatus.getListOfSet|taskStatus.getListOfSet]]. Недопустимое значение параметра: '''REJECTED''' (отклонить можно специальной функцией)
|status ||enum  || новый статус задачи||Допустимы значения из раздела [[ПланФикс API:Системные статусы задач|Системные статусы задач]] или идентификаторы статусов, полученные в результате вызова функции [[ПланФикс API taskStatus.getListOfSet|taskStatus.getListOfSet]]. Недопустимое значение параметра: '''REJECTED''' (отклонить можно специальной функцией)

Текущая версия от 06:30, 2 ноября 2018

Изменение статуса задачи. Формат вызова функции:

<?xml version="1.0" encoding="UTF-8"?>
<request method="task.changeStatus">
  <account></account>
  <sid></sid>
  <task>
    <id></id>
    <general></general>
  </task>
  <status></status>
  <dateTime></dateTime>
  <signature></signature>
</request>
Название Тип Значение Примечание
task.id int идентификатор задачи
general int номер задачи (если задан, используется вместо id)
status enum новый статус задачи Допустимы значения из раздела Системные статусы задач или идентификаторы статусов, полученные в результате вызова функции taskStatus.getListOfSet. Недопустимое значение параметра: REJECTED (отклонить можно специальной функцией)
dateTime DateTime дата активации при переводе в статус Отложенная обязательное поле для статуса DELAYED
signature string(32) подпись


Ответ:

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


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

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


Перейти