Le matériel attendu d'une borne

Une borne remonte l'état de chacun de ses équipements. Un appareil débranché, lui, ne remonte plus rien: il disparaît de la liste sans jamais passer en panne, et la borne peut rester au vert alors qu'il lui manque une imprimante.

Le matériel attendu corrige cela. Vous décrivez une fois ce que la borne doit avoir, par exemple deux imprimantes, 24 casiers ou un terminal de paiement sans contact. Wogeez compare cette liste au matériel remonté chaque fois que la borne envoie son état, et la borne passe en panne ou en avertissement tant que le compte n'y est pas.

Chaque ligne du matériel attendu est une règle. Elle décrit un appareil et le nombre de fois où il doit être présent. Une borne accepte jusqu'à 20 règles.

Au moins repère un appareil qui manque. C'est le cas le plus courant: au moins 1 terminal de paiement, au moins 24 casiers.

Au plus repère un appareil en trop, comme un deuxième lecteur de codes qui capterait les scans à la place du premier. Au plus 0 interdit un appareil sur la borne.

Exactement surveille les deux à la fois. Une borne de jeu concours qui imprime les tickets de participation sur une imprimante et les bons de lot sur une autre attend exactement 2 imprimantes.

Un appareil présent compte même s'il est en panne. Son propre état met déjà la borne en panne ou en avertissement: la règle ne porte que sur sa présence.

Il faut le droit Modifier les ressources, compris dans les rôles Propriétaire et Gestionnaire des ressources. Les rôles et la matrice des droits

Pour chaque règle, la fiche indique le nombre d'appareils trouvés et son état. Présent quand la quantité est respectée, Manquant quand il en manque, En trop quand il y en a trop.

Une règle ne peut pas être vérifiée quand la borne est hors ligne, pendant son démarrage ou tant qu'elle n'a jamais remonté son matériel. Elle est alors inconnue et ne change pas l'état de la borne.

L'état de la borne est le plus grave entre celui de ses équipements et celui des règles non respectées. Une borne dont tout le matériel fonctionne, mais à qui il manque un casier attendu en panne, est donc en panne. Savoir si tout va bien

Dans la liste « Bornes et écrans », une borne à qui il manque du matériel l'affiche sous son nom, par exemple « Module IoT - Détection d'occupation absent », en rouge ou en orange selon la gravité de la règle.

Le filtre État de la borne retrouve les bornes en panne ou en avertissement, quelle qu'en soit la raison. Le filtre Matériel attendu ne garde que celles dont une règle n'est pas respectée. Comme les autres filtres de la liste, ils restent dans l'adresse de la page et se partagent avec un collègue.

L'application Android lit les mêmes règles. L'onglet Matériel d'une borne affiche en tête le matériel attendu qui pose problème, avec un lien En savoir plus. La page Matériel attendu, dans le menu Plus, liste chaque règle avec ce qui a été trouvé. Le bouton Configurer permet de les modifier depuis le téléphone, avec le même droit que dans le manager web.

Le tableau de bord de l'application tient compte du matériel manquant pour classer les bornes qui demandent une intervention. L'application mobile

La fiche d'une borne renvoyée par l'API contient ses règles dans constraints, avec pour chacune le nombre d'appareils trouvés (found) et son état: SATISFIED, UNSATISFIED ou UNKNOWN. L'état global de la borne, health.state, tient déjà compte des règles.

Les règles se remplacent en une fois. La liste envoyée prend la place de l'ancienne, une liste vide les supprime toutes, et une règle qui garde son id reste la même.

PUT /companies/{id}/resources/devices/{device}/constraints

{
  "constraints": [
    {
      "capabilityType": "PRINTER",
      "modes": ["PRINTER_PRINT"],
      "comparison": "EXACTLY",
      "count": 2,
      "severity": "DOWN"
    }
  ]
}

La comparaison prend les valeurs AT_LEAST, AT_MOST ou EXACTLY, la gravité DOWN ou WARNING. La recherche des bornes se filtre sur constraints.state et health.state.