ПланФикс API task.changeStatus — различия между версиями
Материал из ПланФикс
Seva (обсуждение | вклад) |
Seva (обсуждение | вклад) |
||
(не показана 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>