Manuale utente


1. Panoramica

Nethix offre un portale basato su cloud del tipo Software-as-a-Service (SaaS) che permette di:

  • Monitorare, controllare e configurare i dispositivi
  • Stabilire una connessione VPN tra il dispositivo e il PC/laptop del cliente
  • Monitorare e controllare i dispositivi tramite un’app per smartphone/tablet
  • Visualizzare i dati inviati dai dispositivi in grafici e tabelle
  • Segnalazione all’utente dello stato del dispositivo in caso di problemi legati alla connettività
  • Permette l’accesso sicuro al database contenente i dati dei dispositivi da parte di piattaforme di terze parti

L’app per smartphone/tablet permette il monitoraggio del dispositivo e il settaggio del valore di alcuni parametri. La configurazione del dispositivo non è permessa.

Le piattaforme di terze parti possono essere ERP o sistemi simili che utilizzano i dati per operazioni post-processing come ad esempio la prevenzione di guasti o la fatturazione.

Il portale è disegnato per essere portabile. Può essere installato, configurato a gestito in qualsiasi server virtuale o fisico con un set di requisiti minimi.

Alcuni dei benefici che il cliente riscontrerà nell’utilizzo del portale sono:

  • Minor tempo per il monitoraggio di tutti i dispositivi
  • Configurazione e controllo di più dispositivi allo stesso tempo
  • Comunicazione sicura attraverso protocolli di criptazione standard
  • La possibilità di utilizzare il servizio sui server Nethix o su un cloud privato dell’utente

Il flusso base di un portale completamente funzionale è il seguente:

  • Configurazione del dispositivo

    Il dispositivo da monitorare deve essere configurato definendo i parametri che gli consentiranno di comunicare con il portale.

  • Registrazione del dispositivo nel portale

    Il dispositivo da monitorare deve essere registrato nel portale. Questo è necessario per l’autenticazione del dispositivo e per evitare accessi non autorizzati.

  • Invio dei dati al portale

    Configurati correttamente il portale ed il dispositivo, quest’ultimo potrà iniziare ad inviare dati ed eventi. Il portale, a sua volta, potrà inviare comandi di controllo ed accedere ai dati in tempo reale.

    Le credenziali del dispositivo ed i permessi del dispositivo vengono controllati dal portale ad ogni tentativo di connessione.

  • Monitoraggio dei dati

    L’utente potrà accedere ai dati inviati dai dispositivi o a quelli letti in tempo reale (real-time data). Potrà inoltre generare grafici ed esportare i dati in diversi formati come XLS e CVS.

Le operazioni sopra descritte avvengono attraverso un’interfaccia web sicura e user-friendly, senza la necessità di alcun software aggiuntivo.

L’architettura del portale si basa su quattro elementi chiave:

  • Clienti: l’azienda/organizzazione proprietaria dell’account. Solitamente corrisponde al cliente che si interfaccia direttamente con Nethix.
  • Domini: per dominio si intende un insieme di dispositivi completamente autonomi e separati dagli altri. Ciascuno Cliente ha la possibilità di gestire più domini, potendo così dividere i dispositivi per zona, tipologia o cliente finale. Da notare inoltre che tutti i dispositivi inseriti all’interno dello stesso dominio appartengo alla stessa rete VPN (se presente) e possono quindi comunicare in maniera sicura tra loro.
  • Dispositivi: tutti i dispositivi compatibili con il Portale. Per ciascun dispositivi è possibile definire il tipo di accesso al Portale (invio dati e/o VPN).
  • Utenti: dopo aver creato un utente esso potrà effettuare l’accesso al Portale inserendo le proprie credenziali. Un utente può essere abilitato a tutti o solo ad alcuni Domini del Cliente cui fa riferimento. Esistono inoltre diversi tipi di Utente, ciascuno con i propri privilegi.
../_images/system_hierarchy1.png

Le sezioni seguenti descrivono come gestire ognuno di questi elementi e la loro correlazione.


2. Interfaccia utente

Iniziamo a familiarizzare con l’interfaccia web e le sue diverse aree e componenti.

Ogni pagina dell’interfaccia è divisa in quattro aree visive come mostrato nell’immagine sottostante: header, footer, main menu e content.

../_images/main_areas.png

2.4. Content

L’area centrale che cambia dinamicamente in base alla navigazione dell’utente e dalla quale potranno essere gestiti tutti gli elementi del portale.


3. Utenti

I diversi tipi di utente differiscono per i privilegi ad essi assegnati:

3.1. Utente monitoring

L’utente di livello più basso che può solamente monitorare i dispositivi senza poter eseguire nessuna operazione di configurazione.

L’utente di tipo monitoring può essere associato ad uno o più domini del cliente a cui fa riferimento e potrà quindi visualizzare solo i dispositivi contenuti all’interno di quei domini.

Gli sarà consentito generare/stampare grafici dei dati inviati dai dispositivi di sua competenza ed esportare/stampare i dati sotto forma di tabella.

3.2 Utente monitoring and control

Gli utenti di questo tipo hanno gli stessi privilegi degli utenti monitoring, con in più la possibilità di intervenire in tempo reale sullo stato delle variabili inviate dai dispositivi (set point, soglie di allarme, comando di un macchinario ecc…).

Per consentire la modifica in tempo reale dello stato delle variabili, sono necessari due requisiti: i dispositivi devono essere abilitati al collegamento via VPN con il portale e le variabili devono essere scrivibili.

Anche questa tipologia di utente è strettamente legata al cliente cui fa riferimento: potrà accedere a più domini del proprio cliente, ma a nessun dominio di clienti diversi.

3.3. Utente administrator

Questo utente ha gli stessi privilegi dell’utente monitoring and control e in più può:

  • Creare/Editare/Cancellare gli utenti monitoring e monitoring and control
  • Creare/Editare/Cancellare i domini
  • Registrare i dispositivi

Un amministratore appartiene ad uno ed un solo cliente e all’interno dei domini del cliente può eseguire ogni tipo di operazione.

Un amministratore non può appartenere a clienti diversi.

3.4. Utente system

Questo è l’utente di più alto livello. Ha permessi di amministratore e in più può:

  • Creare/Editare/Cancellare clienti
  • Creare/Editare/Cancellare ogni dominio, dispositivo e utente all’interno del portale
  • Creare/Editare/Cancellare utenti di tipo amministratore.

L’utente System è il proprietario del portale.

L’interfaccia grafica per la gestione degli utenti è la stessa sia per system che per gli amministratori, ma le opzioni nel menù e i tab che permettono certe operazioni possono essere differenti in base ai privilegi.

3.5. Gestione degli utenti

La Lista degli Utenti mostra una tabella con gli utenti e le loro proprietà principali. Gli utenti e le proprietà sono mostrate in base ai privilegi dell’utente.

Un utente di tipo amministratore potrà vedere tutti gli utenti che appartengono al cliente cui fa riferimento.

L’utente system vedrà invece la lista di tutti gli utenti di tutti i clienti.

L’utente monitoring e quello monitoring and control non hanno l’accesso a questa area.

../_images/users_list.png

Gli utenti system e administrator possono creare nuovi utenti cliccando sul pulsante Aggiungi mentre per editarlo potranno cliccare sull’icona Modifica che si trova alla fine della riga dell’utente.

Entrambe le opzioni, crea e modifica utenti, permettono di impostare le seguenti opzioni:

  • Username - Un nome univoco usato per effettuare il login nel portale.
  • Password - La password per il login nel portale. Deve essere di almeno 6 caratteri e può contenere lettere maiuscole, minuscole, numeri e simboli di punteggiatura.
  • Nome completo - Nome completo dell’utente usato solamente come riferimento.
  • Privilegi - I privilegi dell’utente: system, administrator, (monitoring and control) user and monitoring. Questa opzione è presente solo per gli amministratori e per system.
  • Cliente - Il cliente a cui appartiene l’utente. Questa opzione è presente solo per l’utente system.
  • Email - L’indirizzo email dell’utente che può essere usata per effettuare il login. Viene inoltre usata per inviare gli eventi e per il recupero della password.
  • Numero telefonico - Numero telefonico dell’utente usato solo come riferimento. Questo è un campo opzionale.
  • Expire data - È possibile specificare una data dopo la quale l’utente verrà disabilitato. Non verrà cancellato dal portale ma non potrà più effettuare il login. Questo è un campo opzionale.
  • Domini - La lista dei domini a cui l’utente che sta per essere creato avrà accesso.
../_images/user_create.png

Ogni utente indipendentemente dai suoi privilegi può editare i propri dati cliccando sullo username nella parte sinistra dell’header e selezionando la voce Account.

In aggiunta alle opzioni sopra elencate, l’utente può impostare la lingua e la timezone.


4. Clienti

Solamente l’utente system (normalmente il proprietario del portale) ha accesso a tutti i clienti. Un cliente può quindi accedere solo ai domini ad esso associati. Solo l’utente di tipo system può inoltre creare, modificare o cancellare i vari clienti.

La Lista dei Clienti mostra tutti i clienti con le loro principali caratteristiche. Cliccando il nome di un cliente verrà mostrata la lista dei suoi domini. Se è presente solamente un dominio, verrà direttamente visualizzata la lista dei dispositivi.

../_images/customers_list.png

Dopo aver cliccato il pulsante Aggiungi ed aver creato un cliente, verrà creato un dominio di default a cui apparterranno automaticamente tutti i dispositivi di questo cliente.

In fase di creazione o modifica di un cliente verranno mostrate tre sezioni che definiscono le caratteristiche ed il suo comportamento:

Nella prima sezione, Generale, si possono impostare il nome del cliente, il tipo di account, e l’expire date. Se l’expire date è impostata, al raggiungimento di tale data a tutti gli utenti di questo cliente verrà negato l’accesso al portale, ma i dispositivi potranno continuare ad inviare dati.

La seconda sezione, Servizi e caratteristiche, permette di abilitare l’accesso del cliente alle varie funzionalità:

  • Abilita l’accesso web per gli amministratori/utenti - Permette agli utenti del cliente di accedere all’interfaccia web del portale.
  • Permetti al cliente di abilitare l’invio dati al portale - Permette agli amministratori del cliente di abilitare i dispositivi all’invio dei dati al portale.
  • Connessione tra PC e dispositivo - Permette di creare una VPN tra i dispositivi e i PC/laptop del cliente.
  • Connessione tra portale e dispositivo - Permette al portale di connettersi ai dispositivi del cliente per leggere/modificare in tempo reale lo stato delle variabili.
  • Permettere agli amministratori di gestire gli eventi - Permette agli amministratori di create/editare/cancellare gli eventi relativi alla connettività dei dispositivi.
  • Permettere agli amministratori di gestire i sinottici - Permette agli amministratori di creare/editare/cancellare sinottici personalizzati per ogni dispositivo.

L’ultima sezione ovvero le restrizioni è usata per definire quanti PC, dispositivi, utenti, amministratori e domini possono essere associati al cliente.

../_images/customer_create.png

La cancellazione di un cliente è una semplice azione che può essere eseguita direttamente dalla Lista dei Clienti selezionando il check box del cliente desiderato e cliccando successivamente sul pulsante Elimina.


5. Domini

Un dominio può essere visto come un contenitore di dispositivi. Un cliente può avere uno o più domini. Il dominio di default esiste sempre e non può essere cancellato.

La suddivisione dei dispositivi permette al cliente di suddividerli per impianto, tipologia o per cliente finale.

La Lista dei Domini mostra tutti i domini del cliente con le loro caratteristiche principali. Cliccando un dominio verrà mostrata la lista dei dispositivi in esso contenuti.

../_images/domains_list.png

Gli utenti system ed admin possono creare un nuovo dominio cliccando sul pulsante Aggiungi o editarne uno esistente cliccando l’icona Modifica.

Sia la creazione che la modifica di un dominio permettono di impostare le seguenti opzioni:

  • Nome - Un nome univoco che identifica il dominio.
  • Dominio predefinito - Imposta questo dominio come dominio di default.
  • VPN - Abilita la creazione di una VPN tra i dispositivi e i PC/laptop del cliente.
  • Accesso remoto - Permette al portale di accedere al dispositivo per le operazioni di lettura/modifica dello stato delle variabili in tempo reale.
  • Invio dati - Permette al dispositivo di inviare dati al portale.
  • Cliente - Seleziona il cliente al quale apparterrà questo dominio. Opzione visibile solamente per gli utenti system.
  • Utenti - Seleziona gli utenti che possono accedere a questo dominio.
../_images/domain_create.png

La cancellazione di un dominio può essere eseguita dalla Lista dei Domini selezionando il dominio desiderato tramite il check box e cliccando sul pulsante Cancella.


6. Dispositivi

Di seguito verranno descritti i differenti aspetti riguardanti la gestione dei dispositivi che dovranno interfacciarsi con il Portale.

6.1. Registrazione

Tutti i dispositivi prima di poter essere aggiunti nel Portale devono essere registrati tramite il loro serial number ovvero un codice alfa numerico di 14 caratteri univoco che li contraddistingue (vedere 13.3. Informazioni di sistema).

Tutti i serial number registrati sono visibili dalla Lista Dispositivi accessibile solamente agli utenti di tipo system e amministratore. Ogni riga di questa lista fa riferimento ad un dispositivo e mostra il suo serial number, il nome del dispositivo (se già configurato), il nome del cliente a cui è associato ed la tipologia del dispositivo.

../_images/registered_device_list.png

In quest’area è possibile registrare o editare un dispositivo cliccando rispettivamente sul pulsante Aggiungi o sull’icona Edit. Ciascuna di queste operazioni permette di configurare le seguenti opzioni:

  • Numero di serie - Il numero di serie che identifica il dispositivo (in modalità edit non è possibile modificarlo)
  • Modello - Il modello del dispositivo (in modalità edit non è possibile modificarlo)
  • Versione software - Indica la versione attuale del software installato nel dispositivo
  • Cliente - Indica a quale cliente appartiene il dispositivo
  • Caratteristiche - Una lista di caratteristiche selezionabili in base alle capacità del dispositivo.

Solamente l’utente di tipo system può registrare/editare/eliminare i serial number.

../_images/registered_devices_create.png

Dopo aver registrato il serial number, il portale sarà predisposto per accogliere la configurazione del dispositivo.

6.2. Gestione dei dispositivi

Questa sezione spiega come monitorare e controllare i dispositivi, come gestire i PC/laptop per la connessione ai dispositivi e come mostrare i dati monitorati in un formato user-friendly.

6.2.1. Dispositivi

La Lista dei Dispositivi mostra tutti i dispositivi raggruppati per tipo di dati monitorati. Cliccando il nome di un dispositivo verrà mostrata la sezione specifica dedicata al monitoraggio.

L’utente system potrà vedere tutti i dispositivi raggruppati per tipo e per cliente.

La lista dei dispositivi può essere visualizzata in due modalità: sotto forma di tabella nella quale verranno riportati i dati più rilevanti o sotto forma di mappa nella quale verrà indicata la posizione geografica dei dispositivi.

La seguente immagine mostra la visualizzazione in tabella:

../_images/devices_list_system_table.png

La seguente immagine mostra invece la visualizzazione della mappa:

../_images/devices_list_system_map.png

Nella visualizzazione in tabella ogni dispositivo è mostrato come nella seguente immagine e può mostrare fino a due icone prima del nome:

../_images/device_row_green_icons.png

La prima icona indica se il dispositivo è:

Icona Significato
../_images/device_link_online.png On-line
../_images/device_link_offline.png Off-line
../_images/device_link_not_set.png Non configurato per la VPN o l’accesso remoto

La seconda icona indica che:

Icona Significato
../_images/events_green.png C’è almeno un evento di connettività associato e non è attivo
../_images/events_red.png C’è almeno un evento di connettività attivo

Non è necessario configurare le variabili dal Portale, in quanto verranno automaticamente create non appena il dispositivo andrà ad inviarle.

Gli utenti system ed administrator possono configurare o editare un dispositivo cliccando rispettivamente sul pulsante Aggiungi o sull’icona Modifica presente sulla riga del dispositivo.

Entrambe le opzioni permettono di impostare i seguenti campi:

  • Numero di serie - Il numero seriale univoco del dispositivo usato dallo stesso per autenticarsi nel Portale.
  • Nome - Un nome univoco che identifica il dispositivo.
  • Dominio - Il dominio di cui fa parte il dispositivo.
  • Invio dati - Permette al dispositivo di inviare dati al portale.
  • Accesso remoto - Permette al portale di accedere al dispositivo per eseguire operazioni in real time (sia in lettura che in scrittura).
  • Visualizzazione dei dati - Il tipo di visualizzazione usata per mostrare i dati del dispositivo. La visualizzazione dei dati è spiegata nella rispettiva sezione.
  • Posizione - Imposta la posizione geografica del dispositivo (opzionale).
../_images/device_create.png

Per cancellare un dispositivo dalla Lista dei Dispositivi è sufficiente selezionare il dispositivo cliccando sul corrispondente select box e poi cliccando sul pulsante Elimina.

6.2.2. PC/Laptop

Un utente può registrare nel portale dei PC e dei laptop che avranno accesso alla rete VPN, tramite la quale potranno comunicare direttamente con i dispositivi facenti parte dello stesso dominio.

La Lista dei PC mostra tutti i computer ed i loro permessi.

../_images/pcs_list.png

Cliccando una singola riga vengono mostrate alcune informazioni base del PC assieme ai link per il download e alle istruzioni per installare il client VPN sul proprio PC.

L’installazione e la configurazione del client VPN è descritta in un documento separato.

../_images/pc_info_download.png

Un utente system o administrator può aggiungere ed editare un PC cliccando rispettivamente il pulsante Aggiungi o l’icona Edit posta a fianco al nome del PC.

Entrambe le operazioni permettono di impostare le seguenti opzioni:

  • Nome - Un nome univoco che identifica il PC.
  • Dominio - Il dominio di cui fa parte.
  • VPN - Abilita l’uso della VPN.
../_images/pc_create.png

La cancellazione dei PC può essere effettuata dalla Lista dei PC selezionando i PC da rimuovere tramite gli appositi check box e cliccando successivamente il pulsante Cancella.

6.3 Monitoraggio e controllo dei dispositivi

Cliccando su un dispositivo dalla Lista dei Dispositivi verranno mostrate alcune pagine specifiche dalla quali potranno essere visualizzati i dati inviati, gli eventi ed altre informazioni utili.

../_images/devices_list_admin.png

6.3.1 Generale

Il tab Generale in Dispositivi → Monitoraggio contiene tre aree.

La prima area nella parte superiore sinistra contiene una tabella con le informazioni base del dispositivo. Le informazioni sono mostrate in accordo con il modello e le caratteristiche del dispositivo.

../_images/device_monitoring_general.png

I parametri mostrati sono:

  • Nome - Nome del dispositivo.
  • Dominio - Dominio di cui fa parte.
  • Modello - Modello. Es. WE500.
  • Numero di serie - Numero di serie.
  • invio dati - Mostra se il dispositivo ha il permesso di inviare dati al portale.
  • Accesso remoto/VPN - Mostra se il portale ha il permesso di accedere in real time usando il canale dato dalla rete VPN.
  • Pulsante sync - Questo pulsante appare solamente se il dispositivo è online. È usato dal portale per ottenere il permesso di controllare il dispositivo e per ottenere varie informazioni riguardanti il dispositivo stesso.

Di fianco al titolo Informazioni del dispositivo ci possono essere fino a tre icone:

Icona Significato
../_images/edit_icon.png Modifica il dispositivo. La sua funzione è la stessa dell’icona Modifica presente nella Lista dei Dispositivi
../_images/events_green.png ../_images/events_red.png Se il dispositivo ha almeno un evento di connettività, l’icona sarà verde se nessun evento è attivo o rossa se almeno un evento è attivo. Se non vi sono eventi associati non verrà mostrata nessuna icona
../_images/link_icon.png Consente di connettersi direttamente all’interfaccia web del dispositivo. L’icona è presente solo se la VPN è abilitata e se il dispositivo è online

La seconda area contiene una mappa in cui è indicata la posizione geografica del dispositivo (se specificata nel momento in cui il dispositivo è stato creato).

Se la VPN è attiva la terza area nella parte bassa mostra i dati in real-time del dispositivo. In caso contrario verranno mostrati gli ultimi dati ricevuti dal Portale.

Le variabili che sono visualizzate in questa area possono essere definite nella Visualizzazione dei dati che verrà spiegata successivamente.

6.3.2 Real-time

Il tab Real-time in Dispositivi → Monitoraggio mostra l’elenco delle variabili del dispositivo in real-time. In questo elenco verranno visualizzate tutte le variabili inviate almeno una volta dal dispositivo.

../_images/device_monitoring_real_time.png

Nella parte superiore destra è possibile selezionare la frequenza di aggiornamento (in secondi) ovvero ogni quanto il Portale contatterà il dispositivo per ottenere il valore delle variabili.

Cliccando su una variabile apparirà un pop-up che permetterà di impostare il valore della variabile sul dispositivo in tempo reale. L’operazione è permessa solo se la variabile è di tipo scrivibile e se l’utente ha i privilegi necessari.

Verranno inoltre evidenziate in rosso quelle variabili su cui è attiva una condizione di allarme.

La pagina Real-time è utilizzabile solo se il dispositivo in questione ha la VPN attiva. Non serve invece che la VPN sia attiva nel PC dell’utente che vi sta accedendo.

6.3.3 Logs

Il tab di Logs in Dispositivi → Monitoraggio mostra tutti i log dei dati che il dispositivo ha inviato al portale, secondo la frequenza di invio configurata nel dispositivo stesso.

Di default i dati sono visualizzati in ordine cronologico partendo da quello più recente. In ogni caso utilizzando le opzioni di filtraggio delle tabelle i dati possono essere ordinati in ordine crescente/decrescente, possono essere filtrati in base ad un valore specifico ed in base ad una data o ad un periodo di tempo.

Le variabili che sono mostrate in questa area, il loro aspetto, l’ordinamento e come sono mostrati viene definito nella Visualizzazione dei dati.

I dati possono inoltre essere stampati o esportati nei formati CSV, XLS e PDF.

../_images/device_monitoring_data.png

6.3.4 Eventi

Il tab Eventi in Dispositivi → Monitoraggio mostra se ci sono degli eventi di connettività configurati per questo dispositivo ed il loro stato.

La tabella mostra le seguenti colonne:

  • Nome - Nome dell’evento.
  • Tipo - Tipo di evento. Ci sono due tipi di eventi:
    • Quando il dispositivo non invia dati al portale
    • Quando il dispositivo è off-line
  • Azione - Azione da eseguire quando l’evento si verifica.
  • Attivato - Indica, tramite un’icona, se l’evento è attivato o disattivato per questo specifico dispositivo.
  • Scattato - Indica, tramite un’icona, se l’evento è attivo.
  • Modifica/Cancella - Modifica o cancella l’evento.

Come in ogni tabella nel portale, possono essere filtrati gli eventi tramite qualsiasi parola di ricerca.

La lista degli eventi può inoltre essere stampata o esportata in formato CSV, XLS e PDF.

../_images/device_monitoring_events.png

La gestione degli eventi è spiegata nella sezione Eventi.

Al di sotto di questa tabella si trovano tutti gli eventi inviati dal dispositivo al portale.

La tabella è caratterizzata dalle seguenti colonne:

  • Data - Data in cui è scattato l’evento.
  • Nome - Nome dell’evento.
  • Descrizione - Descrizione dell’evento.

Questi eventi sono configurati nel dispositivo e non possono essere cancellati una volta ricevuti.

6.3.5 Grafici

Il tab Grafico in Dispositivi → Monitoraggio da la possibilità di visualizzare un grafico (anche multi traccia) con un numero illimitato e selezionabile di variabili, prendendo in esame i dati riferiti ad una determinata data o periodo di tempo. Il grafico può inoltre essere stampato.

Il grafico mostra i valori delle variabili selezionate (asse Y) nel periodo di tempo selezionato (asse X). La barra posta al di sotto del grafico permette di effettuare uno zoom dei dati visualizzati cliccando e tenendo premuto uno dei due pulsanti laterali. Ponendo il cursore del mouse sopra ad un punto qualsiasi della traccia del grafico, verranno riportati data, ora e valore della variabile in quel momento.

Facendo un doppio click tra i due pulsanti si potrà resettare lo zoom in modo da far tornare il grafico alle sue dimensioni originali.

../_images/device_monitoring_trend.png

6.3.6 Controllo

Il tab Controllo in Dispositivi → Monitoraggio permette di impostare il valore delle variabili in lette in real-time

La modifica del valore avviene in tempo reale sfruttando il canale dato dalla VPN, che deve per tanto essere attiva nel dispositivo. Non è invece necessario che il PC dell’utente che sta visualizzando la pagina Controllo sia collegato alla stessa rete VPN (vedere Gestione dei dispositivi).

../_images/device_monitoring_control.png

6.3.7 Sinottico

Il tab Sinottico in Dispositivo → Monitoraggio permette all’utente di caricare un’immagine sulla quale potranno poi essere posizionate delle etichette e delle icone collegate alle variabili inviate dal dispositivo.

L’immagine può avere una dimensione massima di 500 x 718 pixel e può essere facilmente caricata trascinandola sull’area e cliccando sul pulsante Salva.

../_images/device_monitoring_synoptic_empty.png

Una volta caricata l’immagine, potranno essere aggiunte le variabili cliccando sul pulsante Modifica che mostrerà un menù con le seguenti opzioni:

  • Variabile - Permette di selezionare una variabile tra quelle disponibili.
  • Visualizzazione -
    • Default - Il valore grezzo assunto dalla variabile.
    • Icona -
      • Icone - Permette di selezionare un’icona da associare al valore della variabile.
      • Condizione - Un operatore di comparazione (ad esempio Maggiore a).
      • Valore - Il valore raggiunto il quale (ed in base alla condizione definita in precedenza) l’icona apparirà di colore rosso (mente apparirà di colore verde se la condizione non verrà soddisfatta).

Altre variabili potranno essere aggiunte cliccando sul pulsante Aggiungi variabile. Se la variabile è mostrata con la visualizzazione default verrà mostrata all’interno di un riquadro rosso ridimensionabile cliccando e trascinando uno dei quattro angoli.

Per rimuovere la variabile basterà eseguire un doppio clic sulla variabile stessa.

Dopo aver aggiunto e posizionato le variabili, sarà sufficiente cliccare il pulsante Salva per salvare e rendere effettive le modifiche.

../_images/device_monitoring_synoptic_full.png

6.4 Eventi

Nel portale gli eventi sono relativi allo stato della connettività del dispositivo.

Al momento ci sono due tipi di eventi di connettività:

  • Quando il dispositivo non invia dati al portale entro un certo limite di tempo
  • Quando il dispositivo non si collega alla VPN entro un certo limite di tempo

Per ogni evento nel sistema è associata un’azione. Le azioni possono essere l’invio di una email ad uno o più indirizzi, o l’invio di un SMS ad uno o più numeri di telefono (funzione al momento non disponibile).

La Lista degli Eventi in Dispositivi → Eventi mostra tutti gli eventi definiti per il cliente corrente con le loro caratteristiche principali.

../_images/events_list.png

Gli utenti system ed administrator possono creare o modificare un evento cliccando rispettivamente il pulsante Aggiungi o l’icona Modifica.

Entrambe le operazioni permettono di impostare le seguenti opzioni:

  • Nome - Il nome dell’evento.
  • Tipo - La condizione che verrà utilizzata per far scattare l’evento.
  • Azione - Tipo di azione da eseguire quando l’evento si verifica.
  • Timeout - Quando la condizione specificata nel campo Tipo è verificata, il sistema aspetta il periodo di tempo selezionato prima di considerare attivo l’evento ed eseguire quindi l’azione associata.
  • Abilita - Abilita/Disabilita l’evento.
  • Messaggio - Il testo del messaggio da inviare.
  • Dispositivi - I dispositivi su cui verrà attivato l’evento.
  • Utenti - Gli utenti registrati che riceveranno gli SMS o le email.
  • Telefono/Email aggiuntivo - Numeri telefonici ed indirizzi email aggiuntivi, anche se non associati ad alcun utente.

6.5 Visualizzazione dei dati

È possibile configurare una maschera di visualizzazione dei dati ricevuti dal Portale. Ad esempio in una variabile che può assumere i valori 0 o 1 si può decidere di visualizzare la stringa OFF quando il valore è 0 e la stringa ON quando il valore è 1. È possibile inoltre decidere di visualizzare il valore di una variabile come un’icona o di nasconderla.

Una maschera di visualizzazione non è altro che un’insieme di regole che definiscono come si verranno visualizzati i valori delle variabili ricevute dal Portale.

Recandosi in Dispositivi → Visualizzazione dei dati viene mostrata la Lista delle visualizzazioni dei dati ovvero tutte le visualizzazioni definite per il cliente in questione. Per crearne una o per modificarla è sufficiente cliccare il pulsante Aggiungi o l’icona Modifica.

../_images/data_visualization_list.png

Ad ogni maschera di visualizzazione va assegnato un nome che la contraddistingua. Se la visualizzazione è già stata creata al di sotto del campo Nome verrà mostrata una tabella, inizialmente vuota, che conterrà tutte le regole di visualizzazione per ogni variabile.

../_images/data_visualization_create.png

Per aggiungere una regola o per modificarla si devono cliccare rispettivamente il pulsante Aggiungi o l’icona Modifica.

Entrambe le operazioni permettono di impostare le seguenti opzioni:

  • Nome della variabile - Il nome della variabile a cui si vuole applicare la regola di visualizzazione.
  • Nome della colonna - Il nome della colonna. Cambiando questo parametro, la variabile verrà visualizzata con il nome indicato.
  • Posizione della colonna - È possibile riordinare la disposizione delle variabili indicando un valore numerico progressivo (la colonna con il valore più bassa verrà posizionata a sinistra, quella con il valore più alto a destra.
  • Tipo - Indica il tipo di visualizzazione da applicare alla variabile:
    • Default - Il valore della variabile verrà visualizzato come viene inviato dal dispositivo. È possibile impostare:
      • Decimali - Indica il numero di decimali da visualizzare.
    • Hidden - Nasconde la variabile.
    • Boolean - Associa una stringa o un’icona quando la variabile assume un determinato valore. È possibile impostare:
      • Quando il valore è - Il primo valore che deve avere la variabile per applicare la regola.
      • Mostra - La stringa o l’icona da visualizzare quando la variabile assume il primo valore impostato.
      • Quando il valore è - Il secondo valore che deve avere la variabile per applicare la regola.
      • Mostra - La stringa o l’icona da visualizzare quando la variabile assume il secondo valore impostato.
../_images/data_visualization_variable_create.png

Non esiste un limite al numero di regole che possono essere definite. Solamente gli utenti di tipo system ed administrator possono creare delle maschere di visualizzazione.

Dopo aver creato la maschera di visualizzazione la si potrà associare ad uno o più dispositivi. Questa operazione può essere fatta in Dispositivi, cliccando sull’icona Modifica e selezionando nel campo Visualizzazione dei dati la maschera desiderata.

Le aree in cui vengono applicate le maschere di visualizzazione sono:
  • La pagina Dispositivi → Elenco dei dispositivi
  • Il sommario in real-time presente in Dispositivi → Elenco dei dispositivi → Monitoraggio nel tab Generale
  • La tabella dei log del dispositivo presente in Dispositivi → Elenco dei dispositivi → Monitoraggio nel tab Logs