ПланФикс 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>
