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
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, soussiteSurvey. 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.
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 sonlowerRangejusqu’aulowerRangede la bande suivante.
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.