Stati e Modi di Entity e System

⚠️ Stai visualizzando la documentazione per la versione API 2024-10-31. La versione più recente è 2026-05-04. Le modifiche principali includono una terminologia aggiornata (Asset → Organization, Entity → Taxpayer/Location).

Questa sezione fornisce una panoramica dello state e del mode che definiscono il ciclo di vita e il comportamento operativo delle risorse Entities e Systems. Il diagramma seguente illustra le transizioni tra questi stati e modi, descrivendo in dettaglio come la risorsa si evolve dalla creazione alla dismissione e come i suoi modi operativi si adattano in base a eventi interni o chiamate API esterne.

Comprendere queste transizioni è essenziale per gestire le risorse in modo efficace, garantire operazioni fluide e risolvere problemi come credenziali non valide o pause temporanee.

Stati

• Acquired: Stato iniziale della risorsa al momento della creazione. Non è possibile eseguire operazioni in questo stato.
• Commissioned: La risorsa è pronta e completamente operativa (a condizione che il modo sia operativo).
• Decommissioned: La risorsa non è più operativa e non può eseguire alcun compito. Questo stato è irreversibile.

Modi

• Inactive: La risorsa è inattiva e non operativa.
• Operative: La risorsa è completamente funzionale e opera come previsto.
• Suspended: Temporaneamente in pausa, che può essere avviata tramite una chiamata API, ad es. quando le credenziali devono essere aggiornate.
• Degraded (non ancora implementato): La risorsa è operativa ma temporaneamente non disponibile, ad es. a causa di credenziali non valide o errori.

📘Note

Ogni transizione viene attivata da una chiamata API esterna oppure avviene automaticamente in base alla logica interna del sistema. PATCH indica che è necessaria una chiamata API esterna per avviare la transizione. INTERNAL indica che la transizione viene attivata automaticamente all’interno del sistema. Le frecce bidirezionali indicano che la transizione può avvenire in entrambe le direzioni.

Transizioni di Stato

• Acquired → Commissioned: Richiede una chiamata API (PATCH) per aggiornare la risorsa.
• Commissioned → Decommissioned: Gestita tramite una chiamata API (PATCH) per contrassegnare la risorsa come non più in uso. Questo cambio di stato è irreversibile.

Transizioni di Modo

• Inactive → Operative: Passa automaticamente se lo stato viene aggiornato a Commissioned tramite chiamata API.
• Operative → Suspended: Può essere eseguita attivamente tramite l’API, ad es. per sospendere temporaneamente le operazioni durante l’aggiornamento delle credenziali.
• Operative → Degraded (non ancora implementato): Passa automaticamente se le credenziali non sono valide o si verifica un errore.
• Degraded → Suspended (non ancora implementato): Deve essere aggiornato attivamente tramite l’API per risolvere problemi come credenziali non valide.
• Suspended → Operative: Può essere aggiornato tramite l’API dopo aver risolto i problemi, ad es. aggiornando le credenziali.
• Degraded → Operative (non ancora implementato): Può passare automaticamente quando i problemi con la risorsa vengono risolti internamente.