API de listas de verificación

La API /checklists/ se creó para permitir a los usuarios descargar y analizar las respuestas a las preguntas de las listas de verificación en DISPATCH de L2L. Cada registro devuelto en esta API representa una lista de verificación que se ha creado desde un Despacho, el Portal del Operador o manualmente.

Filtrado de listas de verificación

La API /checklists/ se puede filtrar y ordenar por cualquiera de las propiedades principales, como: sitio, nombre del documento, despacho, producto, línea, máquina, etc.

Preguntas y respuestas

Las preguntas y respuestas se encuentran en las propiedades tasks y answers, respectivamente.  

La lista tasks contiene todas las preguntas que se encontraban en la versión publicada de la lista de verificación en el momento en que se creó la lista de verificación. Si se publica una nueva versión de una lista de verificación y un usuario elige actualizar las preguntas de la lista de verificación, la lista tasks también se actualizará en la API.

La lista answers contiene todas las respuestas introducidas en la lista de verificación. Cada respuesta tiene una propiedad task_number, que es el índice de la pregunta en la lista tasks a la que corresponde la respuesta. Por ejemplo, si una respuesta tiene un task_number de 3, la pregunta relacionada es el tercer elemento de la lista tasks.

La API de respuestas también incluye los criterios de aprobado, fallido y advertencia si utiliza la puntuación de listas de verificación. La API le proporcionará un número: 0 = Aprobado, 1 = Advertencia, 2 = Fallido

 

Tablas

Las preguntas y respuestas de las listas de verificación que se encuentran dentro de tablas también se incluyen en la API /checklists/. El objeto task define la tabla, incluidos los encabezados de columna, la información de filas y columnas, y las definiciones de las preguntas. Las respuestas se incluyen en la lista answers, y la pregunta asociada se puede encontrar en la lista tasks utilizando las propiedades task_number, table_row_number y table_column_number.

Consideraciones de desarrollo

• La propiedad task_hash del objeto de tarea y del objeto de respuesta existe por razones heredadas. Esta propiedad no debe utilizarse para vincular preguntas de tareas y respuestas.
• La API /checklistsanswers/ se desarrolló y publicó antes de que las respuestas se incluyeran en la carga útil de la API /checklists/, y seguirá proporcionando respuestas en el futuro. Sin embargo, el objeto de respuestas en la carga útil de /checklists/ es más completo y es el método preferido para recopilar respuestas de listas de verificación.