JHAjeedom2ha
Documentation officielle synchronisée depuis main (40e1421).
Sommaire

Les états et les compteurs

Retour à la documentation.

Chaque équipement porte un seul état. Le même mot, avec la même teinte, se lit dans l'arbre de la pièce, dans le badge à droite du nom de l'équipement affiché, dans la ligne de ce détail et dans les compteurs sous le titre de la pièce. Il n'y a plus de chiffres à rapprocher : si le badge dit « Publié », l'équipement est compté « publié » dans la pièce.

Compteurs du détail de pièce

Comment lire un état

État (teinte) Ce que cela veut dire Que faire
Publié (vert) L'équipement est présent dans Home Assistant, d'après l'état réel du démon. Rien. Si des commandes sont bloquées, une mention orange l'indique (« 2 bloquées »).
À appliquer (bleu) Le plan courant et ce qui est dans Home Assistant ne concordent pas encore : un réglage a été posé mais pas appliqué, ou l'équipement doit être publié et ne l'est pas encore. Cliquer sur « Appliquer » (ou lancer « Relire Jeedom »).
Bloqué (orange) Rien n'est dans Home Assistant et au moins une commande est bloquée par une cause que vous pouvez corriger. Lire la fiche de cause de l'équipement : elle dit pourquoi et propose le geste qui corrige.
Exclu (gris) L'équipement est volontairement écarté : réglage « Jamais », configuration du plugin (plugins, pièces) ou réglage propre à l'équipement dans Jeedom. Rien, c'est un choix.
Désactivé (gris, en italique) L'équipement est désactivé dans Jeedom. Réactivez-le dans Jeedom si vous le souhaitez.
Rien à publier (gris) Aucune commande n'est publiable ni bloquée : les commandes sont toutes ignorées, ou l'équipement n'a pas de commande. Rien.

Le mot est toujours écrit, avec une icône : la couleur ne remplace jamais le texte.

Les priorités entre les états

Les règles s'appliquent dans cet ordre, la première qui convient l'emporte (« P » = l'équipement est présent dans Home Assistant) :

Ordre Condition État
R1 Un réglage est en attente (sauf pour un équipement jamais synchronisé : le démon marque alors tout en attente faute de décision appliquée) À appliquer
R2 P Publié
R3 L'équipement est désactivé dans Jeedom Désactivé
R4 L'équipement est exclu (décision d'équipement, ou toutes ses commandes exclues) Exclu
R5 Pas de P, au moins une commande publiable et le plan courant demande la publication À appliquer
R6 Présence inconnue (démon plus ancien), au moins une commande publiable, le plan ne refuse pas la publication À appliquer (jamais « Publié »)
R7 Au moins une commande bloquée Bloqué
R8 Sinon Rien à publier

Conséquences à retenir :

  • « Désactivé » l'emporte sur « Exclu » : un équipement à la fois désactivé et exclu s'affiche « Désactivé », et il est compté « désactivé », jamais « exclu ».
  • La cause d'exclusion n'est pas un état de plus. « Par le plugin X », « par la pièce » et « individuelle » sont des mentions à côté du mot « Exclu » ; les six états et leurs effectifs ne changent pas. La ventilation des exclus d'une pièce (ligne « Exclus : » du détail de pièce, repère « N exclus » de la carte) ne compte que les équipements dont la cause est connue : sa somme peut être inférieure au compte « exclu », l'écart étant dit « autre ». Un équipement « Désactivé » n'a jamais de cause d'exclusion.
  • Une pièce exclue n'est pas un état de plus. « Pièce exclue » remplace seulement le « n / t publiés » de la carte et de la ligne de la pièce ; les équipements de la pièce passent à l'état « Exclu » (cause « par la pièce ») à la relecture qui suit l'exclusion, et le repère « N pas encore retirés » compte ceux qui ne le sont pas encore. Un équipement « Désactivé » reste « Désactivé » dans une pièce exclue.
  • Il n'existe pas d'état « partiel » : un équipement dont une partie des commandes est dans Home Assistant est « Publié », avec la mention orange du nombre de commandes bloquées.
  • Un équipement hors du périmètre de publication (le plan ne demande pas sa publication) n'est jamais « À appliquer » : « Appliquer » ne pourrait pas le publier.

Les quatre catégories de commande

Catégorie Définition Compte comme défaut ?
Publiée (vert) La commande est portée par au moins une entité présente dans Home Assistant. Non
Bloquée (orange) Absente de Home Assistant, avec une cause que vous pouvez corriger. Oui
Ignorée (gris) Absente de Home Assistant et sans équivalent dans Home Assistant : rien à faire. Non
Exclue (gris) Écartée par un réglage. Non

Les commandes ignorées ne sont jamais comptées comme un défaut et ne sont pas des lignes du tableau : elles sont repliées sous le tableau. Une cause inconnue du plugin (démon plus récent) classe la commande « Bloquée » : elle n'est jamais masquée. Voir Les causes de blocage.

La jauge de la maison

Sur la page du plugin, le bloc de la maison reprend les mêmes états, équipement par équipement, pour toutes les pièces : « N / M publiés » où M est le nombre d'équipements Jeedom de toutes les tuiles (la tuile « Sans pièce » comprise) et N ceux à l'état Publié. La jauge (le liseré) est découpée, dans cet ordre, en publiés (vert), à appliquer (bleu), bloqués (orange), exclus ou inactifs (gris : exclus, désactivés et rien à publier) et non lus (hachuré). Chaque segment donne son compte en info-bulle. La somme des segments est toujours M, et celle des tuiles de pièce est toujours celle de la maison.

  • Non lu n'est pas un septième état : c'est un équipement de Jeedom dont les chiffres n'ont pas pu être lus (le démon ne le connaît pas encore, ou sa lecture a échoué). Il n'est jamais compté publié, bloqué, exclu ni désactivé, et la jauge ne devient jamais « pleine de non lus » quand la lecture n'a pas eu lieu : elle reste neutre avec un message.
  • Ce qui n'est pas un état : la mention « N bloquées » d'un équipement publié n'est pas un équipement bloqué ; elle apparaît dans l'arbre de la pièce et dans le détail de l'équipement, jamais dans la jauge. Une maison à zéro bloqué peut donc contenir des commandes bloquées dans des équipements publiés. De même, la puce « conseils » (affichée seulement si leur nombre est connu sans lire chaque fiche) compte des équipements publiés qui pourraient faire mieux : un conseil n'est pas un état, ces équipements restent comptés dans leur état (« publié » ou « à appliquer »).
  • Les chiffres sont relus à l'ouverture de la page, après chaque action, au retour sur l'onglet après plus d'une minute et par ↻ (« Actualiser les chiffres »), dont l'info-bulle donne l'heure de la dernière lecture par la page.

Les repères d'une carte de pièce

La tuile d'une pièce affiche « n/t » (n publiés, t = équipements de la pièce), un liseré de 4 px construit comme celui de la maison, puis, seulement s'ils sont non nuls, des repères faits d'une icône et d'un nombre, le mot dans l'info-bulle : bloqués (orange), à appliquer (bleu), désactivés, rien à publier, non lus et exclus (gris). Sous un filtre de la maison, la tuile ne compte plus que l'état filtré. Ces chiffres sont les mêmes que ceux de l'arbre de la pièce (repères d'une pièce) et des compteurs du détail de pièce : tous sont calculés à partir de la même lecture, sans rien relire.

La ligne des états (sous le titre de la pièce)

Elle comporte un chiffre et un mot court pour chaque état non nul, toujours dans cet ordre : publié, à appliquer, bloqué, exclu, désactivé, rien à publier. Un état à zéro n'est pas affiché. Le mot est au singulier pour 1, au pluriel au-delà (« 1 publié », « 9 publiés », « 2 à appliquer »). La somme des chiffres est le nombre d'équipements lus : chaque équipement est compté une fois, dans son seul état. Chaque compteur est un filtre de l'arbre (un clic le pose, un second le retire), le même que celui de la page du plugin.

Il n'y a pas de compteur de commandes au niveau de la pièce : l'unité de décision est l'équipement.

Ces chiffres viennent de la lecture des états de la page du plugin : ils ne demandent aucune lecture de plus et sont présents dès l'ouverture de la vue. Tant que cette lecture n'a pas eu lieu ou a échoué, les compteurs ne sont pas affichés et la mention de la page du plugin (« Aucune synchronisation n'a encore eu lieu », « Mise à jour en cours… » ou « Chiffres indisponibles ») s'affiche aussi dans la vue ; jamais de « NaN » ni de faux « non lus ».

Quand certains équipements de la pièce ne sont pas lus — le démon ne les connaît pas encore, ou leur lecture a échoué — la ligne se termine par « 1 équipement non lu » ou « 2 équipements non lus » : ils ne sont pas comptés. Si le démon est une version plus ancienne qui n'indique pas la présence dans Home Assistant, la ligne le dit (« … dont la présence dans Home Assistant est inconnue (démon plus ancien) ») et ces équipements ne sont jamais comptés « publiés ».

La liste « À traiter dans cette pièce »

Sous les compteurs, la vue liste les équipements bloqués et à appliquer de la pièce, et seulement eux : état, nom, nombre de commandes concernées et cause dite une seule fois. Elle est produite avec les mêmes règles d'état et de cause que le détail d'un équipement, à partir de la même lecture que les compteurs : elle ne demande aucune lecture de la configuration des équipements.

La ligne d'un équipement affiché

Quand vous choisissez un équipement, son état est le badge de la ligne 1 de sa fiche (le même mot que partout), et la ligne 2 donne le plugin, le nombre de commandes puis le détail de ses commandes, par exemple :

Virtuel · 9 commandes · 3 publiées · 1 bloquée · 5 ignorées

Les zéros sont masqués, les pluriels accordés (« 1 publiée », « 3 publiées »). Les catégories apparaissent dans cet ordre : publiées, à appliquer (publiables mais pas encore dans Home Assistant), bloquées, ignorées, exclues. Seules les commandes bloquées comptent comme défaut : dans l'exemple, le défaut de l'équipement vaut 1, et les 5 commandes ignorées n'y comptent pas.

Équipement bloqué déplié : pourquoi et quoi faire

Captures du plugin avec des données fictives de démonstration. Ce site est construit et géré par des agents IA sur NanoCorp.

À lire ensuite : le guide complet.