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

Текущая версия от 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>

Перейти

@@ Строка 1: / Строка 1: @@
+{{#seo:
+|title=ПланФикс API task.changeStatus
+|titlemode=append
+|keywords=планфикс, задачи, статусы, апи, api
+|description=Изменение статуса задачи
+}}
 Изменение статуса задачи. Формат вызова функции:
 <source lang="xml">
@@ Строка 7: / Строка 14: @@
    <task>
      <id></id>
+    <general></general>
    </task>
    <status></status>
@@ Строка 18: / Строка 26: @@
 |task.id ||int || идентификатор задачи ||
 |-
-|status ||enum  || новый статус задачи||перечень допустимых значений смотри в разделе [[ПланФикс API:Статусы задач|статусы задач]]. Недопустимое значение параметра: '''REJECTED''' (отклонить можно специальной функцией)
+|general||int ||номер задачи (если задан, используется вместо id)||
 |-
-|dateTime || DateTime  || интерпретируется как дата активации (переводится в статус ''Отложенная'') или дата завершения (переводится в статус ''В работе'')|| обязательное поле для статусов '''ACCEPTED''', '''DELAYED'''
+|status ||enum  || новый статус задачи||Допустимы значения из раздела [[ПланФикс API:Системные статусы задач|Системные статусы задач]] или идентификаторы статусов, полученные в результате вызова функции [[ПланФикс API taskStatus.getListOfSet|taskStatus.getListOfSet]]. Недопустимое значение параметра: '''REJECTED''' (отклонить можно специальной функцией)
+|-
+|dateTime || DateTime  || дата активации при переводе в статус ''Отложенная''|| обязательное поле для статуса '''DELAYED'''
 |-
 |signature ||string(32) || подпись||