Skip to main content

Visites d’inspection de site dans l’API Acheteur

Lisez les visites d’inspection de site et générez des bons de travail de suivi à partir des constats d’inspection avec l’API Acheteur OpenWrench.
Une visite d’inspection est une inspection de site complétée : un inspecteur parcourt un emplacement à partir d’une liste de tâches et enregistre des réponses, des photos et des problèmes. L’API Acheteur expose les visites en lecture seule et vous permet d’émettre des bons de travail de suivi qui restent liés au constat d’inspection dont ils proviennent. Tous les exemples supposent :

Lire les visites d’inspection

La pagination et les filtres par champ standards s’appliquent, en plus des restrictions par emplacement et par marque de votre rôle. Les bons de travail référencés à partir des réponses aux tâches d’une visite d’inspection sont filtrés selon votre permission de lecture, alors des clés différentes peuvent voir des bons de travail liés différents pour la même visite.

Afficher les scores avec les plages de carte thermique

Chaque réponse de visite d’inspection incorpore le sondage de site hydraté sur lequel elle a été exécutée, sous siteSurvey. Le sondage de site porte un champ optionnel walkthroughHeatMapRanges : un tableau de bandes de couleur utilisées pour afficher les scores de visite sous forme de carte thermique.
Chaque entrée comporte deux champs :
  • color : la couleur à afficher pour la bande, généralement un code hexadécimal.
  • lowerRange : le score le plus bas qui entre dans la bande. Une bande s’étend de son lowerRange jusqu’au lowerRange de la bande suivante.
Pour colorer un score du tableau scores de la visite, choisissez la bande dont le lowerRange est le plus élevé tout en restant inférieur ou égal au score. Vous configurez les plages sur le sondage de site ou sur son modèle. Si un sondage n’a pas de plages à lui, OpenWrench remplit les plages du modèle au moment de la lecture, alors le siteSurvey.walkthroughHeatMapRanges incorporé est déjà résolu. Vous n’avez jamais besoin d’aller chercher le modèle pour trouver les bandes. Le champ vaut null quand ni le sondage ni son modèle ne définissent de plages ; dans ce cas, n’affichez pas de carte thermique.

Créer des bons de travail de suivi

Lorsqu’un constat d’inspection nécessite une correction, créez le bon de travail avec les champs de liaison définis :
  • walkThroughId : la visite d’inspection d’où provient le constat.
  • siteSurveyTaskTitleId : la tâche précise à l’intérieur de celle-ci.
  • includeWalkthroughTaskList : copie optionnellement la liste de tâches de la visite d’inspection sur le bon de travail.
walkThroughId et siteSurveyTaskTitleId doivent être fournis ensemble ou pas du tout; sinon la création est rejetée. Voir Créer un bon de travail pour le reste de la charge utile. Le lien est visible dans les deux sens : le bon de travail porte walkThroughId, et les réponses aux tâches de la visite d’inspection référencent les bons de travail qui en sont issus. Cela fait de « tous les constats ouverts des inspections du trimestre dernier, avec leur état de correction » un rapport à deux requêtes.