Skip to main content

​
Recorridos de encuesta de sitio en la Buyer API

Lee los recorridos de encuestas de sitio y genera órdenes de trabajo de seguimiento a partir de los hallazgos con la Buyer API de OpenWrench.
Un recorrido es una encuesta de sitio completada: un inspector recorre una ubicación siguiendo una lista de tareas y registra respuestas, fotos e incidencias. La Buyer API expone los recorridos en solo lectura y te permite crear órdenes de trabajo de seguimiento que quedan enlazadas al hallazgo de encuesta del que provienen. Todos los ejemplos asumen:

​
Leer recorridos

Aplican la paginación estándar y los filtros por campo, además del alcance por ubicación y marca de tu rol. Las órdenes de trabajo referenciadas desde las respuestas de tareas de un recorrido se filtran por tu permiso de lectura, por lo que claves distintas pueden ver órdenes de trabajo enlazadas distintas en el mismo recorrido.

​
Renderizar puntuaciones con rangos de mapa de calor

Cada respuesta de recorrido incrusta la encuesta de sitio hidratada contra la que se ejecutó, bajo siteSurvey. La encuesta de sitio lleva un campo opcional walkthroughHeatMapRanges: un arreglo de bandas de color usadas para renderizar las puntuaciones del recorrido como un mapa de calor.
Cada entrada tiene dos campos:
  • 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 su lowerRange hasta el lowerRange de la siguiente banda.
Para colorear una puntuación del arreglo 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.