Concetti chiave

Questa pagina definisce i termini usati in tutta la documentazione. Torna qui ogni volta che un termine non ti è chiaro.

Space (tenant)

Un Space è l'ambiente isolato di un singolo cliente, raggiungibile tramite un proprio sottodominio (es. acme.trackle.space). Tutto ciò che segue (template, asset, dashboard, utenti) vive dentro uno Space specifico.

Template

Un Template (Asset Template) è lo stampo da cui nascono gli asset: definisce metadati statici, la Connettività IoT verso i device fisici (Trackle, MQTT con profili, HTTP), le variabili di telemetria, quali regole di allarme monitorano quei campi e quali dashboard sono disponibili per visualizzarli.

Approfondisci nel capitolo Template.

Asset

Un Asset è un'istanza reale creata a partire da un template: un impianto specifico, una macchina specifica, un sensore specifico. Ogni asset:

• appartiene a un template (che ne definisce la struttura);
• può essere collegato a un device fisico tramite il suo ID esterno;
• può appartenere a una o più organizzazioni/gruppi;
• ha una propria pagina di dettaglio con parametri, storico e allarmi.

Approfondisci nel capitolo Asset.

Device (collegamento fisico)

Con "device" ci si riferisce al dispositivo fisico collegato a un asset (un modulo Trackle, un client MQTT — anche Seneca, Siemens LOGO o Teltonika — o un dispositivo che chiama le API HTTP). Il collegamento avviene tramite un identificativo che nell'interfaccia è sempre chiamato ID esterno.

Organizzazioni e gruppi

Le organizzazioni e i gruppi permettono di segmentare gli asset (ad esempio per cliente finale, sede, area geografica) e di assegnare permessi di visibilità agli utenti.

Dashboard

Una dashboard è una composizione di widget (grafici, valori live, mappe, ecc.) che visualizza i dati di uno o più asset. Le dashboard possono essere:

• di template: condivise da tutti gli asset di un template;
• personali: create da un singolo utente per il proprio uso.

Approfondisci nel capitolo Dashboard.

Regole di allarme e storico allarmi

Le regole di allarme definiscono una o più condizioni (in AND) sulle variabili di un template (es. "temperatura > 80°" e "porta aperta") e sono condivise da tutti gli asset di quel template. Quando le condizioni si verificano su un asset specifico, viene generato un allarme che appare nello storico allarmi di quell'asset; puoi anche configurare notifiche email (anche verso chi vede l'asset). Approfondisci in Allarmi e Alert.

Ruoli utente

Gli utenti di uno Space hanno uno dei seguenti ruoli:

Ruolo	Descrizione
Admin	Accesso completo: gestione template, regole di allarme, dashboard, utenti, billing e impostazioni.
Support	Può consultare template, asset e regole di allarme per assistere i clienti, senza poterli modificare.
Customer	Utente finale che gestisce i propri asset (parametri, dashboard personali). Nelle Impostazioni vede solo le preferenze notifiche personali.

Assistente AI

L'assistente AI è un pannello disponibile in ogni pagina (e come vista dedicata Home) che risponde a domande sul tuo Space e può proporre azioni (creare un asset, una dashboard, una regola di allarme...) che vengono sempre mostrate per conferma prima di essere eseguite. Approfondisci in Assistente AI.