Flusso di Onboarding del Segnale Esterno
Suggerimento
La guida di Onboarding è pensata per nuove integrazioni che utilizzano il Protocollo MQTT Eniris.
Un limite del protocollo MQTT è che non viene inviata alcuna notifica o trasferimento dati quando viene aggiunta una nuova installazione. Pertanto, si consiglia di includere i passaggi seguenti prima di integrare completamente con SmartgridOne Controller.
Configurazione
Per configurare un flusso di onboarding saranno necessari i seguenti elementi:
-
API esterna
- È necessaria un’API pubblica
-
Almeno due endpoint
- Endpoint di onboarding L'endpoint di onboarding può essere usato da SmartgridOne Controller per inviare un segnale che indichi che l’installazione è pronta per essere controllata. Informazioni aggiuntive possono includere numeri di contratto inseriti dagli utenti, indirizzo dell’installazione, informazioni sul dispositivo
- Endpoint di offboarding L'endpoint di offboarding può essere usato per indicare che il segnale di controllo esterno è stato rimosso da SmartgridOne Controller, e il controllo non è più possibile.
- Endpoint di status/healthcheck L'endpoint di healthcheck può essere interrogato regolarmente da SmartgridOne Controller per fornire un aggiornamento sullo stato dei dispositivi o del sistema nel suo insieme.
Esempio
-
Un nuovo utente aggiunge il segnale esterno in SmartgridOne Controller. Verrà chiamato l’endpoint di onboarding per indicare che SmartgridOne Controller è pronto a ricevere comandi.
-
SmartgridOne Controller ha perso la connessione con la batteria. L’endpoint di healthcheck conterrà un messaggio di errore.
-
È necessario un numero di contratto per collegare un numero di serie SmartgridOne Controller a un cliente. Un numero di contratto può essere incluso nel flusso di onboarding, riducendo la comunicazione di andata e ritorno tra segnali esterni e clienti finali.