Cos'è un Template e da cosa è composto
Un Template (Asset Template) è lo stampo da cui vengono creati tutti gli asset di un certo tipo. Se produci o gestisci più unità dello stesso prodotto (es. un modello di frigorifero industriale, una linea di sensori, un impianto standard), definisci una sola volta il template e poi crei un asset per ogni unità reale.
Nella UI del template le impostazioni principali sono separate in sezioni distinte. Un template è composto da:
1. Informazioni
Nella sezione Informazioni (o Informazioni template) configuri l'identità del tipo di prodotto:
| Campo | Obbligatorio | Effetto |
|---|---|---|
| Nome | Sì | Nome del template (es. "Frigorifero industriale"), usato in elenchi e nella scelta del tipo quando crei un asset |
| Descrizione | No | Testo libero che spiega a cosa serve il template |
| URL immagine | No | Immagine di anteprima del prodotto (URL pubblico); compare negli elenchi template e come riferimento visivo |
2. Connettività IoT
La Connettività IoT definisce come i device fisici comunicano con Trackle Spaces. Sono supportati tre tipi:
| Tipo | Quando usarlo |
|---|---|
| Trackle | Device che usano il modulo/SDK Trackle nativo. |
| MQTT | Device che pubblicano/sottoscrivono topic MQTT. Sotto MQTT scegli un profilo: Generico, Seneca, Siemens Logo o Teltonika RutOS. Il profilo cambia downlink e opzioni sui campi di telemetria. |
| HTTP | Device che chiamano periodicamente le API HTTP di Trackle Spaces (utile per configurare anche un timeout di "offline"). |
Il tipo di connettività è una proprietà del template: tutti gli asset creati da quel template comunicano nello stesso modo. Approfondisci in Connettività IoT.
3. Metadati
I metadati sono informazioni statiche definite a livello di template e valorizzate su ogni asset (es. matricola, sede, data installazione). Non arrivano dal device: li compili tu. Approfondisci in Metadati.
4. Variabili di telemetria
Le variabili di telemetria (tab Telemetria) definiscono quali dati un asset di questo template esporrà: ogni variabile ha una chiave (key), un tipo di dato, un'eventuale unità di misura e un flag che indica se è scrivibile (cioè se puoi inviare comandi al device, non solo leggere valori).
Esempio: un template "Frigorifero industriale" potrebbe avere le variabili temperatura (numerica, °C, sola lettura), compressore_attivo (booleana, sola lettura) e setpoint (numerica, °C, scrivibile).
Approfondisci in Variabili di telemetria.
5. Regole di allarme
Le regole di allarme sono una o più condizioni in AND sulle variabili di telemetria del template (es. "temperatura > 8°C" e "umidità < 40%", per più di 10 minuti) che, quando si verificano su un asset, generano un allarme nello storico di quell'asset specifico. Le regole si configurano a livello di template e si applicano automaticamente a tutti gli asset che lo usano. Approfondisci in Regole di allarme.
6. Dashboard di template
Ogni template può avere una o più dashboard condivise, visibili su tutti gli asset che usano quel template. Puoi anche impostare una dashboard come "dashboard home": sarà quella mostrata per prima quando apri il dettaglio di un asset. Approfondisci in Dashboard.