Flusso di onboarding del segnale esterno
Suggerimento
Le linee guida per l’onboarding sono pensate per le nuove integrazioni che utilizzano il protocollo MQTT Eniris.
Uno svantaggio del protocollo MQTT è che non viene inviata alcuna notifica né trasferito alcun dato quando viene aggiunta una nuova installazione. Pertanto, si consiglia di includere i seguenti passaggi prima di completare l'integrazione con SmartgridOne Controller.
Configurazione
Per configurare un flusso di onboarding saranno necessari i seguenti elementi
-
API esterna
- È richiesta un'API pubblica
-
Almeno due endpoint
- Endpoint di onboarding L'endpoint di onboarding può essere utilizzato da SmartgridOne Controller per inviare un segnale che indica che l'installazione è pronta per essere controllata. Ulteriori informazioni possono includere i numeri di contratto inseriti dagli utenti, l'indirizzo dell'installazione e le informazioni sui dispositivi
- Endpoint di offboarding L'endpoint di offboarding può essere utilizzato per indicare che il segnale di controllo esterno è stato rimosso da SmartgridOne Controller e che il controllo non è più possibile.
- Endpoint di stato/healthcheck L'endpoint di healthcheck può essere interrogato regolarmente da SmartgridOne Controller per fornire un aggiornamento sullo stato dei dispositivi o dell'intero sistema.
Esempio
-
Un nuovo utente aggiunge il segnale esterno in SmartgridOne Controller. L'endpoint di onboarding verrà chiamato per indicare che SmartgridOne Controller è pronto per ascoltare i comandi.
-
SmartgridOne Controller ha perso la connessione con la batteria. L'endpoint di healthcheck conterrà un messaggio di errore.
-
È richiesto un numero di contratto per collegare il numero di serie di SmartgridOne Controller a un cliente. Un numero di contratto può essere incluso nel flusso di onboarding, riducendo le comunicazioni ripetute tra i segnali esterni e i clienti finali.