Mediante esta API puedes consultar el listado de tareas que tienes creadas en tu compañía. Se listarán tanto las tareas que pertenecen a un plan de tareas, como las tareas no planificadas
Parámetros de entrada
Los siguientes parámetros de entrada son opcionales, los cuales sirven para realizar la paginación de la consulta.
Por defecto Fracttal API retorna sólo 100 registros.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
id_group_task | Entero | Opcional | Número de del plan de tareas |
start | Entero | Opcional | Número de registro inicial que mostrará la consulta. |
limit | Entero | Opcional | Número de registro final que retornará la consulta . |
Esta API admite filtros dinámicosAdemás de
id_group_task,startylimit, puedes filtrar por cualquier campo de la tarea usando la notacióncampo[operador]=valor(por ejemplodescription[like]=mantenimientoois_active[eq]=true). El parámetroid_group_tasksigue funcionando igual que antes y se puede combinar con los nuevos filtros. Consulta los operadores disponibles y ejemplos de uso en Filtros dinámicos.
Parámetros de salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id_group_task | Entero | Id del plan de tareas al que pertenece. Null, en caso de que sea una tarea no planificada |
duration | Entero | Duración de la tarea en segundos |
description | Texto | Descripción de la tarea |
is_active | Booleano | Indica si la tarea existe. Siempre responde true. No refleja si la tarea está pausada dentro de su plan; para eso consulta is_plan_active. |
is_plan_active | Booleano | Indica si la tarea está activa o pausada dentro de su plan. true = la tarea está activa. false = la tarea fue pausada dentro del plan. |
stop_assets | Booleano | True, si el activo está detenido, false en caso contrario |
stop_assets_sec | Entero | Tiempo de paro del activo en segundos |
priorities_description | Texto | Descripción de la prioridad |
groups_tasks_description | Texto | Descripción del plan de tareas |
tasks_types_description | Texto | Clasificación 1 de la tarea |
tasks_types_main_description | Texto | Tipo de tarea |
note | Texto | Nota de la tarea |
requested_by | Texto | Solicitado por |
id_request | Entero | Id de la solicitud |
num_iterations | Entero | Número de iteraciones |
is_cyclical | Booleano | Si es una tarea ciclica |
name_iterations | JSON | Contenido de las iteraciones de las tareas cíclicas |
Cómo saber si una tarea está pausadaPara saber si una tarea está pausada, consulta
is_plan_active.is_activeno cambia al pausar o reanudar una tarea.
Ejemplo:
Petición: (GET)https://app.fracttal.com/api/tasks/
{
"success": true,
"message": "200",
"data": [
{
"id": 255,
"id_company": 914,
"id_group_task": 2,
"id_priorities": 3,
"id_task_type_main": 14,
"id_task_type": null,
"id_task_type_2": null,
"duration": 600,
"description": "60 PUNTOS",
"is_active": true,
"is_plan_active": true,
"stop_assets": false,
"stop_assets_sec": null,
"tasks_types_2_description": null,
"priorities_description": "MEDIUM",
"groups_tasks_description": "PLAN DE MANTENIMIENTO CAMIÓN FREIGHTLINER M102",
"tasks_types_description": null,
"tasks_types_main_description": "INSPECCIÓN",
"tasks_types_main_color": null,
"note": null,
"requested_by": null,
"id_request": null,
"is_configured": true,
"event_date": null,
"num_iterations": null,
"is_cyclical": null,
"name_iterations": {}
},
{
"id": 1676537,
"id_company": 914,
"id_group_task": 45623,
"id_priorities": 3,
"id_task_type_main": 14,
"id_task_type": null,
"id_task_type_2": null,
"duration": 600,
"description": "60 PUNTOS",
"is_active": true,
"is_plan_active": true,
"stop_assets": false,
"stop_assets_sec": null,
"tasks_types_2_description": null,
"priorities_description": "MEDIUM",
"groups_tasks_description": "PLAN DE MANTENIMIENTO CAMIÓN MIXER",
"tasks_types_description": null,
"tasks_types_main_description": "INSPECCIÓN",
"tasks_types_main_color": null,
"note": null,
"requested_by": null,
"id_request": null,
"is_configured": true,
"event_date": null,
"num_iterations": null,
"is_cyclical": null,
"name_iterations": {}
},
{
"id": 1424185,
"id_company": 914,
"id_group_task": 39840,
"id_priorities": 3,
"id_task_type_main": 14,
"id_task_type": null,
"id_task_type_2": null,
"duration": 600,
"description": "60 PUNTOS",
"is_active": true,
"is_plan_active": false,
"stop_assets": false,
"stop_assets_sec": null,
"tasks_types_2_description": null,
"priorities_description": "MEDIUM",
"groups_tasks_description": "PLAN DE MANTENIMIENTO CAMIÓN MIXER",
"tasks_types_description": null,
"tasks_types_main_description": "INSPECCIÓN",
"tasks_types_main_color": null,
"note": null,
"requested_by": null,
"id_request": null,
"is_configured": true,
"event_date": null,
"num_iterations": null,
"is_cyclical": null,
"name_iterations": {}
},
{
"id": 3363315,
"id_company": 914,
"id_group_task": 87029,
"id_priorities": 3,
"id_task_type_main": 14,
"id_task_type": null,
"id_task_type_2": null,
"duration": 600,
"description": "60 PUNTOS",
"is_active": true,
"is_plan_active": true,
"stop_assets": false,
"stop_assets_sec": null,
"tasks_types_2_description": null,
"priorities_description": "MEDIUM",
"groups_tasks_description": "PLAN DE MANTENIMIENTO BUS",
"tasks_types_description": null,
"tasks_types_main_description": "INSPECCIÓN",
"tasks_types_main_color": null,
"note": null,
"requested_by": null,
"id_request": null,
"is_configured": true,
"event_date": null,
"num_iterations": null,
"is_cyclical": null,
"name_iterations": {}
},
{
"id": 336,
"id_company": 914,
"id_group_task": null,
"id_priorities": 3,
"id_task_type_main": 14,
"id_task_type": 24,
"id_task_type_2": null,
"duration": 600,
"description": "60 PUNTOS ( Tarea No Planificada )",
"is_active": true,
"is_plan_active": true,
"stop_assets": false,
"stop_assets_sec": null,
"tasks_types_2_description": null,
"priorities_description": "MEDIUM",
"groups_tasks_description": null,
"tasks_types_description": "PROYECTO 02",
"tasks_types_main_description": "INSPECCIÓN",
"tasks_types_main_color": null,
"note": "",
"requested_by": "miguel",
"id_request": null,
"is_configured": true,
"event_date": "2020-07-20T20:30:00+00:00",
"num_iterations": null,
"is_cyclical": null,
"name_iterations": null
}
],
"total": 5
}OpenAPI definition
{
"openapi": "3.1.0",
"info": {
"title": "consultar-tareas",
"version": "1-Es"
},
"servers": [
{
"url": "https://app.fracttal.com/api/tasks/"
}
],
"security": [
{}
],
"paths": {
"/": {
"get": {
"summary": "Consultar tareas",
"description": "",
"operationId": "consultar-tareas",
"security": []
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}