Consultar tareas pendientes

get

https://app.fracttal.com/api/tasks_todo/

Mediante esta API se consulta el listado de tareas pendientes. Se puede realizar filtro por fecha programada, por defecto muestra las tareas pendientes en un rango de 1 mes.

GET https://app.fracttal.com/api/tasks_todo

Parámetros de entrada

Se puede filtrar la información mediante el siguiente query_params. Todos son opcionales.

Parámetro	Tipo	Requerido	Descripción
`until`	texto	Opcional	Fecha final de la consulta. Formato: `YYYY-MM-DDTHH:MM:SS-UTC`. Ejemplo: `2016-07-12T20:00:00-03`. (Por defecto un mes).
`code_location`	texto	Opcional	Código de la ubicación del activo. Se puede consultar aquí. (campo `code`)
`start`	entero	Opcional	Número de registro donde iniciará la consulta. Por defecto 0. Todas las consultas están limitadas a 100 registros; usar este parámetro para paginar.
`limit`	entero	Opcional	Cantidad de registros que mostrará la petición. Por defecto 100.
`since`	texto	Opcional	Fecha inicial de la consulta. Formato: `YYYY-MM-DDTHH:MM:SS-UTC`. Ejemplo: `2016-07-12T20:00:00-03`.
`include_out_of_service`	booleano	Opcional	Nuevo. Filtra las tareas según si el activo asociado tiene un período "Fuera de Servicio" activo (registrado en Disponibilidad de Activos). `true`: solo tareas con período activo. `false`: solo tareas sin período activo. Si se omite o se envía vacío, retorna todas las tareas sin filtrar por este criterio. Acepta `true`/`false`/`1`/`0` (sin distinción de mayúsculas).

Alias de include_out_of_service
También se aceptan como alias id_items_availability, out_of_service y asset_out_of_service — se usa el primer valor no vacío recibido, en ese orden de prioridad.

Parámetros de salida

Parámetro	Tipo	Descripción
`id_task`	entero	Id de la tarea
`id_item`	entero	Id del activo
`item_description`	texto	Descripción del activo
`code`	texto	Código del activo
`group_task_description`	texto	Plan de tareas
`is_active`	booleano	Indica si el activo se encuentra activo o no
`visible_to_all`	texto	Activo visible para todos
`parent_description`	texto	Ubicación del activo
`date_maintenance`	texto	Fecha calculada
`trigger_description`	texto	Evento que ejecutó la tarea
`delay`	texto	Tiempo de atraso
`description`	texto	Descripción de la tarea
`duration`	texto	Duración estimada en segundos
`tasks_types_main_description`	texto	Tipo de tarea
`priorities_description`	texto	Prioridad de la tarea
`tasks_types_description`	texto	Clasificación 1 de la tarea
`tasks_types_2_description`	texto	Clasificación 2 de la tarea
`num_resources`	texto	Cantidad de recursos en la tarea
`last_date_maintenance`	texto	Última fecha de programación
`task_note`	texto	Nota de la tarea
`requested_by`	texto	Solicitado por (si la tarea fue ejecutada desde una solicitud)
`id_request`	texto	Id de la solicitud (si la tarea fue ejecutada desde una solicitud)
`event_date`	texto	Fecha del evento
`cal_date_maintenance`	texto	Fecha programada
`replay_counter`	entero	Número de ejecuciones de la tarea
`replay_counter_cycles`	entero	Número de ejecuciones en el ciclo
`num_iterations`	entero	Última iteración ejecutada
`out_of_service`	booleano	Nuevo. Indica si el activo de la tarea tiene un período "Fuera de Servicio" activo en el momento de la consulta (sin fecha de fin, o con fecha de fin futura). Se retorna siempre, se envíe o no el filtro.
`asset_out_of_service`	booleano	Nuevo. Mismo valor que `out_of_service` (mismo cálculo, campo duplicado).

Errores

Código	Causa
`400`	El parámetro de filtro (`include_out_of_service` o cualquiera de sus alias) recibió un valor no boolean. Mensaje real: `Parameter id_items_availability (or out_of_service, include_out_of_service, asset_out_of_service) must be a boolean (true, false, 1 or 0). Received: "<valor_enviado>"`

Ejemplo

Response `200`

{
  "success": true,
  "message": "200",
  "data": [
    {
      "id": 1163,
      "id_task": 986,
      "id_item": 49210,
      "item_description": "MAQUINA 1      { AMCO-01 }",
      "code": "AMCO-01",
      "group_task_description": "Mantenimiento Línea de Producción",
      "is_active": true,
      "visible_to_all": false,
      "parent_description": "// AMCO/ ",
      "date_maintenance": "2021-08-26T05:00:00+00:00",
      "trigger_description": "DATE$EVERY$5$MONTHS",
      "delay": 77,
      "description": "Manto vehículo",
      "duration": 600,
      "tasks_types_main_description": "Mantenimiento",
      "num_resources": 0,
      "last_date_maintenance": "2021-03-26T05:00:00+00:00",
      "cal_date_maintenance": "2021-08-26T05:00:00+00:00",
      "replay_counter": 0,
      "out_of_service": false,
      "asset_out_of_service": false
    }
  ],
  "total": 1
}

Response — filtrando por activos fuera de servicio (`200`)

Request: GET /api/tasks_todo/?include_out_of_service=true

{
  "success": true,
  "message": "200",
  "data": [
    {
      "id": 1163,
      "id_task": 986,
      "id_item": 49210,
      "code": "AMCO-01",
      "out_of_service": true,
      "asset_out_of_service": true
    }
  ],
  "total": 1
}

Response — error, valor no boolean (`400`)

Request: GET /api/tasks_todo/?include_out_of_service=quizas

{
  "success": false,
  "message": "400",
  "data": [
    { "ERROR": "Parameter id_items_availability (or out_of_service, include_out_of_service, asset_out_of_service) must be a boolean (true, false, 1 or 0). Received: \"quizas\"" }
  ],
  "total": 0
}

Language

Loading…