Flusso di Onboarding del Segnale Esterno

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 Sofar EMS.

Configurazione

Per configurare un flusso di onboarding saranno necessari i seguenti elementi:

1. API esterna

   • È necessaria un’API pubblica

2. Almeno due endpoint

   • Endpoint di onboarding L'endpoint di onboarding può essere usato da Sofar EMS 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 Sofar EMS, e il controllo non è più possibile.
   • Endpoint di status/healthcheck L'endpoint di healthcheck può essere interrogato regolarmente da Sofar EMS per fornire un aggiornamento sullo stato dei dispositivi o del sistema nel suo insieme.

Esempio

1. Un nuovo utente aggiunge il segnale esterno in Sofar EMS. Verrà chiamato l’endpoint di onboarding per indicare che Sofar EMS è pronto a ricevere comandi.

2. Sofar EMS ha perso la connessione con la batteria. L’endpoint di healthcheck conterrà un messaggio di errore.

3. È necessario un numero di contratto per collegare un numero di serie Sofar EMS 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.