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

Материал из ПланФикс
Перейти к: навигация, поиск
 
(не показаны 4 промежуточные версии 2 участников)
Строка 1: Строка 1:
 +
{{#seo:
 +
|title=ПланФикс API task.changeStatus
 +
|titlemode=append
 +
|keywords=планфикс, задачи, статусы, апи, api
 +
|description=Изменение статуса задачи
 +
}}
 +
 
Изменение статуса задачи. Формат вызова функции:
 
Изменение статуса задачи. Формат вызова функции:
 
<source lang="xml">
 
<source lang="xml">
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
−
<request method="task.changeExpectDate">
+
<request method="task.changeStatus">
 
   <account></account>
 
   <account></account>
 
   <sid></sid>
 
   <sid></sid>
 
   <task>
 
   <task>
 
     <id></id>
 
     <id></id>
 +
    <general></general>
 
   </task>
 
   </task>
 
   <status></status>
 
   <status></status>
Строка 18: Строка 26:
 
|task.id ||int || идентификатор задачи ||
 
|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) || подпись||
 
|signature ||string(32) || подпись||

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


Перейти

Источник — «http://planfix.ru/wiki/index.php?title=ПланФикс_API_task.changeStatus&oldid=16421»