Leer recorridos
Renderizar puntuaciones con rangos de mapa de calor
Cada respuesta de recorrido incrusta la encuesta de sitio hidratada contra la que se ejecutó, bajositeSurvey. La encuesta de sitio lleva un campo opcional walkthroughHeatMapRanges: un array de bandas de color usadas para renderizar las puntuaciones del recorrido como un mapa de calor.
color: el color a renderizar para la banda, normalmente un código hexadecimal.lowerRange: la puntuación más baja que cae en la banda. Una banda va desde sulowerRangehasta ellowerRangede la siguiente banda.
scores del recorrido, elige la banda con el lowerRange más alto que sea menor o igual a la puntuación.
Configuras los rangos en la encuesta de sitio o en su plantilla. Si una encuesta no tiene rangos propios, OpenWrench rellena los rangos de la plantilla en el momento de la lectura, por lo que el siteSurvey.walkthroughHeatMapRanges incrustado ya viene resuelto. Nunca necesitas consultar la plantilla para encontrar las bandas. El campo es null cuando ni la encuesta ni su plantilla definen rangos; omite el renderizado del mapa de calor en ese caso.
Crear órdenes de trabajo de seguimiento
Cuando un hallazgo de encuesta requiere remediación, crea la orden de trabajo con los campos de enlace establecidos:walkThroughId: el recorrido del que proviene el hallazgo.siteSurveyTaskTitleId: la tarea específica dentro de él.includeWalkthroughTaskList: opcionalmente copia la lista de tareas del recorrido en la orden de trabajo.
walkThroughId y siteSurveyTaskTitleId deben suministrarse juntos o no suministrarse; en caso contrario, la creación se rechaza. Consulta Crear una orden de trabajo para el resto del payload.
El enlace es visible en ambos sentidos: la orden de trabajo lleva walkThroughId, y las respuestas de tareas del recorrido referencian las órdenes de trabajo generadas a partir de ellas. Eso hace que “todos los hallazgos abiertos de las encuestas del último trimestre, con estado de remediación” sea un informe de dos consultas.