Gruppi e gerarchia
Un gruppo è l’unità organizzativa principale della piattaforma. Può rappresentare un’azienda, un sito, un condominio o qualsiasi altra entità che raggruppa più impianti.
Nota tecnica: nella documentazione delle API e nel codice questa entità è chiamata tenant — i due termini indicano la stessa cosa. Questa guida usa “gruppo”, coerentemente con l’interfaccia del portale.
I gruppi sono organizzati in una gerarchia: un gruppo può contenere sottogruppi, permettendo di modellare strutture complesse come gruppi aziendali o reti di edifici gestiti da un’unica organizzazione. Le impostazioni e gli accessi definiti su un gruppo si propagano automaticamente ai sottogruppi e agli impianti sotto di esso.
Creare un gruppo
Per creare un sottogruppo è necessario avere accesso in scrittura sul gruppo padre:
- Nella lista dei gruppi, aprire il menu + (visibile solo se si dispone del permesso necessario) e selezionare Crea gruppo
- Il Codice viene proposto automaticamente a partire dal Nome inserito; entrambi sono modificabili
- Aggiungere facoltativamente una Descrizione
- Fuso orario e Lingua sono preimpostati su “Predefinito” — in questo caso il sottogruppo eredita il valore del gruppo padre; è possibile specificare un valore diverso per sovrascriverlo
- Confermare con Aggiungi
Il nuovo gruppo compare nella gerarchia con un percorso costruito a partire da quello del padre (es. un gruppo europa sotto acme avrà percorso /acme/europa/). La profondità della gerarchia non ha un limite fisso: è comune modellare strutture come rivenditore → manutentore → cliente → area → impianto su più livelli annidati.
Navigare la gerarchia
Spostandosi tra i gruppi, il portale mostra un percorso di navigazione (breadcrumb) con tutti gli antenati del gruppo corrente, costruito a partire dai dati restituiti dal server: compaiono solo i gruppi che l’utente può effettivamente vedere in base ai propri accessi, non l’intera struttura dell’organizzazione. Ogni gruppo nel percorso è selezionabile per risalire rapidamente ai livelli superiori.
Gli accessi di un utente (chi può vedere/gestire cosa) seguono la stessa gerarchia dei gruppi ma con regole proprie di ereditarietà ed espansione dei ruoli — vedi Ruoli e permessi.
Modificare un gruppo
Aprire il gruppo e selezionare l’icona di modifica in alto: si apre Modifica gruppo. Richiede il ruolo Responsabile gruppo sul gruppo. Il contenuto della finestra dipende da dove si ha quel ruolo:
- Anche sul gruppo padre — si possono modificare Nome, Descrizione, Fuso orario e Lingua, ed eliminare il gruppo
- Solo sul gruppo stesso — si possono modificare solo Fuso orario e Lingua: nome e descrizione di un gruppo li decide chi gestisce il livello superiore
Le impostazioni del gruppo sono:
- Fuso orario — il fuso orario degli impianti del gruppo: i dispositivi seguono la programmazione oraria in questo fuso, e il portale e le email degli allarmi mostrano gli orari di quegli impianti in questo fuso, qualunque sia il fuso di chi li guarda
- Lingua — lingua predefinita del portale per gli utenti del gruppo
- Nome e Descrizione — visibili nella gerarchia e nelle schede dei gruppi
Con Predefinito, fuso orario e lingua si ereditano dal gruppo padre. Le modifiche si confermano con Salva.
Sotto le impostazioni, la stessa finestra contiene due sezioni:
- Canali di notifica — i canali del gruppo, che si possono scegliere per le sottoscrizioni agli allarmi degli impianti del gruppo e dei suoi sottogruppi (vedi Canali di notifica)
- Accesso — gli utenti con un accesso al gruppo (vedi Ruoli e permessi)
Eliminare un gruppo
Nella finestra Modifica gruppo, il pulsante Elimina elimina il gruppo dopo una conferma. È disponibile solo a chi ha il ruolo Responsabile gruppo anche sul gruppo padre.
Si può eliminare solo un gruppo vuoto: se contiene ancora sottogruppi, impianti o dispositivi, l’eliminazione non riesce. Prima occorre eliminare o spostare quello che contiene — gli impianti (vedi Impianti), i sottogruppi e i dispositivi (vedi Dispositivi). Insieme al gruppo vengono eliminati i suoi canali di notifica e gli accessi concessi su di esso.