update_task

Метод unit/update_task позволяет редактировать задачи.

Copied!
svc=unit/update_task&params={
	"itemId": <long>,
	"taskId": <text>,
	"props": {
		"key1": <long>,
		"key2": <text>,
		.....
	}
}

Пример запроса:

Copied!
https://hst-api.wialon.com/wialon/ajax.html?sid=5e860dbe24e3d704ffb196d0733ec714&svc=unit/update_task&params={
"itemId": 1514,
"taskId": "6f6aeeebad9ebe64bda86924f8d379d8e6b06bd690c53da4aab526c5e221bdb266b52a50",
"props": {
"task_status": 2,
"task_priority": 3
}
}

Параметры

Требуются следующие параметры:

Параметр

Описание

itemIdИдентификатор объекта.

taskId

Идентификатор задачи (хэш строки).

props

Объект свойств, которые необходимо обновить (пары ключ — значение). Указывайте только те свойства, которые вы хотите отредактировать, поскольку каждое новое свойство полностью заменяет соответствующее ему существующее свойство. Ниже приведен список флагов, которые можно использовать в этом параметре для изменения свойств задачи.

Флаги

Флаг

Описание

task_status

Статус задачи. Допустимые значения:

  • 1 (Новая),
  • 2 (К выполнению),
  • 3 (В процессе),
  • 4 (Приостановлено),
  • 5 (Отклонено),
  • 6 (Выполнено).

task_priority

Приоритет задачи. Допустимые значения: 

  • 1 (Низкий),
  • 2 (Средний),
  • 3 (Высокий).

task_assignee

Идентификатор пользователя, на которого назначена задача. 

task_commentsКомментарий к задаче. Поле комментария не должно быть пустым или содержать более 500 символов.

Флаг task_comment должен иметь следующую структуру:

Copied!
[
    {
        timestamp: 13243,
        assignee: 1564,
        comment: "Hello world"
    }, 
    {
        timestamp: 13244,
        assignee: 1564,
        comment: "Hello world 2"
    }
]

Возвращаемый результат

При успешном выполнении запроса возвращается пустая строка.

Copied!
{ }

Если запрос не выполнен, возвращается код ошибки. Пример:

Copied!
{
    "error": 5
}

Коды ошибок

КодОписание
4Невалидные входные параметры.
5

Ошибка выполнения запроса. 

Не удалось найти задачу с указанным индикатором. 

6Неизвестная ошибка.
2008

Доступ запрещен. Необходимы следующие права доступа:

  • Право Просмотр элемента и его основных свойств на объект,
  • Право Действовать от имени этого пользователя на пользователя, на которого назначена задача.

Эта ошибка также возникает, если не найден указанный идентификатор пользователя, на которого назначена задача.

Скачать файл PDF
Скачать документ Word

Смотрите также