update_task

Метод unit/update_task позволяет редактировать задачи. Чтобы создать новую задачу, используйте unit/create_task. Информация о том, как работают задачи в системе мониторинга, приведена в разделе Задачи.

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

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

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

Запрос должен содержать следующие параметры:

Для работы с задачами объекта необходимы следующие права доступа на него:

Массив task_comments должен содержать все комментарии, которые будут у задачи после обновления. Передавайте существующие комментарии с их id, а новый комментарий — без него:

[
    { "id": 1, "comment": "Unit delivered to the service station." },
    { "id": 2, "comment": "Oil and filters replaced." },
    { "comment": "Spare parts ordered, waiting for delivery." }
]

Если комментарий был ранее добавлен к задаче, но его id не указан в массиве, комментарий удаляется.

Для нового комментария система присваивает следующий id (комментарии задачи нумеруются начиная с 1) и указывает в качестве автора текущего пользователя. Вы также можете передать поле timestamp со временем комментария в формате UNIX timestamp. По умолчанию система использует текущее время сервера.

У существующего комментария можно изменить только текст. Если вы измените его, система запишет, кто и когда отредактировал комментарий.

О тех же действиях в системе мониторинга — в разделе Комментарии.

Чтобы добавить комментарий, передайте в массиве task_comments объект следующего формата:

{ "comment": "Spare parts ordered, waiting for delivery." }

Чтобы отредактировать комментарий, укажите его идентификатор в массиве task_comments и передайте новый текст комментария:

{ "id": 2, "comment": "Oil and filters replaced. Next service due at 140000 km." }

Чтобы удалить комментарий, уберите его из массива task_comments.

Чтобы добавить или отредактировать дополнительные параметры задачи, укажите в параметре props объект task_params с необходимыми парами «ключ — значение»:

{
    "itemId": 1514,
    "taskId": "6f6aeeebad9ebe64bda86924f8d379d8e6b06bd690c53da4aab526c5e221bdb266b52a50",
    "props": {
        "task_params": {
            "filled": 50.5,
            "mileage": 125.8,
            "cost": 150
        }
    }
}

Значения filled и mileage указывайте в текущей системе измерения объекта (СИ, американской, имперской или метрической с галлонами). Система измерения задается в свойстве mu объекта. Подробнее — в разделе Основные свойства. Значения charged, cost и engine_hours сохраняются в том виде, в котором переданы.

Метод unit/update_task обновляет одну задачу. Чтобы обновить несколько задач одновременно (например, назначить их на одного пользователя или изменить их статус или приоритет), объедините запросы unit/update_task в запрос core/batch.

Каждый элемент массива params — это отдельный запрос unit/update_task со своими itemId и taskId.

svc=core/batch&params={
  "params": [
    {
      "svc": "unit/update_task",
      "params": {
        "itemId": 1514,
        "taskId": "6f6aeeebad9ebe64bda86924f8d379d8e6b06bd690c53da4aab526c5e221bdb266b52a50",
        "props": {
          "task_status": 6,
          "task_comments": [
            { "comment": "Checked by the operator." }
          ]
        }
      }
    },
    {
      "svc": "unit/update_task",
      "params": {
        "itemId": 1515,
        "taskId": "8a21bcb0ad9ebe64bda86924f8d379d8e6b06bd690c53da4aab526c5e221ff416a8d46d0",
        "props": {
          "task_status": 6,
          "task_comments": [
            { "comment": "Checked by the operator." }
          ]
        }
      }
    }
  ],
  "flags": 0
}

Обратите внимание на следующее:

Описание параметра flags приведено в разделе core/batch.

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

{}

В противном случае возвращается код ошибки. Пример:

{
    "error": 5,
    "reason": "TASK_NOT_FOUND"
}

Общие коды ошибок приведены в разделе Коды ошибок.