États et Modes d'Entity et System

⚠️ Vous consultez la documentation de la version API 2024-10-31. La version la plus récente est 2026-05-04. Les principaux changements incluent une terminologie mise à jour (Asset → Organization, Entity → Taxpayer/Location).

Cette section fournit un aperçu du state et du mode qui définissent le cycle de vie et le comportement opérationnel des ressources Entities et Systems. Le diagramme ci-dessous illustre les transitions entre ces états et modes, détaillant comment la ressource évolue de la création à la mise hors service et comment ses modes opérationnels s’adaptent en fonction des événements internes ou des appels API externes.

Comprendre ces transitions est essentiel pour gérer efficacement les ressources, assurer des opérations fluides et résoudre des problèmes tels que des identifiants non valides ou des pauses temporaires.

États

• Acquired : État initial de la ressource lors de sa création. Aucune opération ne peut être effectuée dans cet état.
• Commissioned : La ressource est prête et entièrement opérationnelle (à condition que le mode soit opératif).
• Decommissioned : La ressource n’est plus opérationnelle et ne peut effectuer aucune tâche. Cet état est irréversible.

Modes

• Inactive : La ressource est inactive et non opérationnelle.
• Operative : La ressource est entièrement fonctionnelle et fonctionne comme prévu.
• Suspended : Temporairement mis en pause, ce qui peut être initié via un appel API, p. ex. lorsque les identifiants doivent être mis à jour.
• Degraded (pas encore implémenté) : La ressource est opérationnelle mais temporairement indisponible, p. ex. en raison d’identifiants non valides ou d’erreurs.

📘Note

Chaque transition est déclenchée soit par un appel API externe, soit automatiquement sur la base de la logique interne du système. PATCH indique qu’un appel API externe est nécessaire pour initier la transition. INTERNAL indique que la transition est déclenchée automatiquement dans le système. Les flèches bidirectionnelles indiquent que la transition peut se produire dans les deux sens.

Transitions d’État

• Acquired → Commissioned : Nécessite un appel API (PATCH) pour mettre à jour la ressource.
• Commissioned → Decommissioned : Géré via un appel API (PATCH) pour marquer la ressource comme n’étant plus utilisée. Ce changement d’état est irréversible.

Transitions de Mode

• Inactive → Operative : Passe automatiquement si l’état est mis à jour à Commissioned via un appel API.
• Operative → Suspended : Peut être effectué activement via l’API, p. ex. pour suspendre temporairement les opérations lors de la mise à jour des identifiants.
• Operative → Degraded (pas encore implémenté) : Passe automatiquement si les identifiants sont invalides ou si une erreur se produit.
• Degraded → Suspended (pas encore implémenté) : Doit être mis à jour activement via l’API pour résoudre des problèmes tels que des identifiants non valides.
• Suspended → Operative : Peut être mis à jour via l’API après résolution des problèmes, p. ex. mise à jour des identifiants.
• Degraded → Operative (pas encore implémenté) : Peut passer automatiquement lorsque les problèmes avec la ressource sont résolus en interne.