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	Доступ запрещен. Необходимы следующие права доступа: Право Просмотр элемента и его основных свойств на объект, Право Действовать от имени этого пользователя на пользователя, на которого назначена задача. Эта ошибка также возникает, если не найден указанный идентификатор пользователя, на которого назначена задача.

update_task

Параметры

Флаги

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

Коды ошибок

Ваше сообщение отправлено. Спасибо!

Сообщить об ошибке

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