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

Версия 07:58, 5 июля 2013

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

<?xml version="1.0" encoding="UTF-8"?>
<request method="task.changeStatus">
  <account></account>
  <sid></sid>
  <task>
    <id></id>
  </task>
  <status></status>
  <dateTime></dateTime>
  <signature></signature>
</request>

Название	Тип	Значение	Примечание
task.id	int	идентификатор задачи
status	enum	новый статус задачи	Допустимы значения из раздела Системные статусы задач или идентификаторы статусов, полученные в результате вызова функции taskStatus.getListOfSet. Недопустимое значение параметра: REJECTED (отклонить можно специальной функцией)
dateTime	DateTime	интерпретируется как дата активации (переводится в статус Отложенная) или дата завершения (переводится в статус В работе)	обязательное поле для статусов ACCEPTED, 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>

Перейти

@@ Строка 18: / Строка 18: @@
 |task.id ||int || идентификатор задачи ||
 |-
-|status ||enum  || новый статус задачи||перечень допустимых значений смотри в разделе [[ПланФикс API:Статусы задач|статусы задач]]. Недопустимое значение параметра: '''REJECTED''' (отклонить можно специальной функцией)
+|status ||enum  || новый статус задачи||Допустимы значения из раздела [[ПланФикс API:Системные статусы задач|Системные статусы задач]] или идентификаторы статусов, полученные в результате вызова функции [[ПланФикс API taskStatus.getListOfSet|taskStatus.getListOfSet]]. Недопустимое значение параметра: '''REJECTED''' (отклонить можно специальной функцией)
 |-
 |dateTime || DateTime  || интерпретируется как дата активации (переводится в статус ''Отложенная'') или дата завершения (переводится в статус ''В работе'')|| обязательное поле для статусов '''ACCEPTED''', '''DELAYED'''