update_task

La solicitud unit/update_task permite modificar asuntos. Para crear un asunto nuevo, utilice unit/create_task. Para obtener información sobre cómo funcionan los asuntos en el sistema de rastreo, consulte Asuntos.

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

Ejemplo de solicitud:

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

La solicitud debe contener los siguientes parámetros:

Para trabajar con los asuntos de una unidad, se requieren los siguientes derechos de acceso a ella:

El array task_comments debe contener todos los comentarios que tiene el asunto después de la actualización. Pase los comentarios existentes con su id y el comentario nuevo sin él:

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

Si un comentario se añadió anteriormente al asunto, pero su id no se incluye en el array, el comentario se elimina.

Para un comentario nuevo, el sistema asigna el siguiente id (los comentarios de un asunto se numeran a partir de 1) y establece como autor al usuario actual. También puede pasar el campo timestamp con la hora del comentario en formato de hora Unix. Por defecto, el sistema utiliza la hora actual del servidor.

En un comentario existente solo se puede cambiar el texto. Si lo cambia, el sistema registra quién editó el comentario y cuándo.

Para realizar las mismas acciones en el sistema de rastreo, consulte Comentarios.

Para añadir un comentario, pase un objeto con el siguiente formato en el array task_comments:

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

Para editar un comentario, indique su ID en el array task_comments e incluya el texto nuevo del comentario:

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

Para eliminar un comentario, quítelo del array task_comments.

Para añadir o editar parámetros adicionales del asunto, incluya el objeto task_params en el parámetro props con los pares clave-valor deseados:

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

Indique los valores de filled y mileage en el sistema de medida actual de la unidad (SI, US, imperial o métrico con galones). El sistema de medida se establece en la propiedad mu de la unidad. Para obtener más detalles, consulte Propiedades básicas. Los valores de charged, cost y engine_hours se guardan tal como se pasan.

La solicitud unit/update_task actualiza un solo asunto. Para actualizar varios asuntos a la vez (por ejemplo, para asignarlos al mismo usuario o para cambiar su estado o prioridad), combine solicitudes unit/update_task en una solicitud core/batch.

Cada elemento del array params es una solicitud unit/update_task independiente con su propio itemId y 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
}

Tenga en cuenta lo siguiente:

Para conocer la descripción del parámetro flags, consulte core/batch.

Si la solicitud se completa correctamente, se devuelve una respuesta vacía.

{}

De lo contrario, se devuelve un código de error. Ejemplo:

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

Para conocer los códigos de error generales, consulte Códigos de error.