ПланФикс API task.changeStatus — различия между версиями
Материал из ПланФикс
SliZzzZ (обсуждение | вклад) (→Перейти) |
Seva (обсуждение | вклад) |
||
(не показано 6 промежуточных версий 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. | + | <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> | ||
+ | <dateTime></dateTime> | ||
<signature></signature> | <signature></signature> | ||
</request> | </request> | ||
Строка 17: | Строка 26: | ||
|task.id ||int || идентификатор задачи || | |task.id ||int || идентификатор задачи || | ||
|- | |- | ||
− | |status ||enum || новый статус задачи|| | + | |general||int ||номер задачи (если задан, используется вместо id)|| |
+ | |- | ||
+ | |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>