Aggiornare - Creare grafici ed impostare data sources

Una data source è una fonte che raccoglie dati organizzati nel tempo, come sensori fisici, virtuali, siti web o altre fonti esterne.

Durante la creazione o la modifica di una classe oggetto puoi aggiungere una o più data source e definire i grafici che le utilizzano. Ogni grafico necessita di almeno una data source, ma puoi utilizzare la stessa data source su più grafici o configurare un grafico che confronta dati da più data source diverse.

Disponibile solo con modulo-dataflow e con sensori configurati in precedenza.

Requisiti

Permesso backoffice per accedere alla sezione Classi Oggetto.
Modulo dataflow attivo nel progetto.
Sensori o fonti dati configurati in precedenza nella piattaforma.

Passaggi

Per creare grafici e impostare data source:

Per accedere alla sezione Classi Oggetto, apri l'app Backoffice e clicca su Classi Oggetto nella Nav rail a sinistra.
Per accedere alla pagina di configurazione, clicca sul bottone Aggiungi Classe Oggetto se stai creando una nuova classe, oppure seleziona una classe esistente dalla lista.
Spostati nella sezione Data Sources.
Per aggiungere una data source, clicca sul bottone blu + in basso a destra e seleziona l'opzione Data Source.
Nella card che appare, seleziona il tipo di data source tra quelli disponibili e imposta il nome identificativo.
Esempio: Type Thermometer, Name Termometro 1.
Per aggiungere un grafico, clicca sul bottone + in basso a destra e seleziona l'opzione Chart (identificata dall'icona a barre).
Questa opzione è visibile solo se hai aggiunto almeno una data source.
Nella card del grafico, imposta il nome identificativo e seleziona il tipo di grafico tra quelli disponibili: Line Chart, Counter, Bar Chart, Counter Chart.
Dopo aver definito nome e tipo, la card si espande mostrando il configuratore con tre sezioni: Data, Customization e Style.

Configurare la sezione Data

Nella sezione Data definisci i parametri fondamentali del grafico:

Data compression: seleziona il metodo di compressione predefinito scegliendo tra Average over Time (media nel tempo) o Subsampling (sottocampionamento). Gli utenti non possono applicare altri metodi durante l'utilizzo del grafico.
Master Data source: seleziona quale data source alimenta il grafico tra quelle configurate in precedenza.
Asse X: seleziona il parametro monitorato e l'unità di misura per l'asse orizzontale.
Asse Y: seleziona il parametro monitorato e l'unità di misura per l'asse verticale.
Per aggiungere ulteriori serie di dati al grafico, clicca su Add serie.
Questa sezione determina quali dati vengono visualizzati e come vengono processati dal grafico.

Configurare la sezione Customization

La sezione Customization diventa disponibile dopo aver completato la configurazione della sezione Data.
Qui puoi personalizzare la visualizzazione del grafico attraverso quattro sottosezioni:

Labels
Definisci gli elementi testuali del grafico:

Title: inserisci il titolo principale del grafico.
Sub-title: aggiungi un sottotitolo descrittivo.
Asse X e Asse Y: imposta le etichette per ciascun asse, scegliendo se includere o meno l'unità di misura.

Thresholds
Imposta soglie di riferimento per evidenziare valori critici:

Name: assegna un nome identificativo alla soglia.
Asse: seleziona se applicare la soglia all'asse X o Y.
Date Time: imposta il valore di riferimento della soglia.
Per aggiungere ulteriori soglie, clicca su Add threshold.

Axes
Definisci come i valori vengono scalati su ciascun asse, scegliendo tra tre metodi:

Auto-scale: la scala si adatta automaticamente ai valori presenti.
Fixed: imposta un range fisso (esempio: da 1 g a 10 g).
Relative: definisci una percentuale di margine per l'area visualizzata.

Default values
Configura i valori iniziali visualizzati all'apertura del grafico:

When: seleziona il periodo temporale di riferimento (esempio: Today, Last hour, Last 24 hours).
Aggregation: scegli l'intervallo di aggregazione dei dati (esempio: Minute, 10 seconds, Hour).
Queste impostazioni migliorano la leggibilità del grafico e permettono di adattarlo alle esigenze specifiche di analisi.

Configurare la sezione Style

Nella sezione Style puoi impostare uno stile condizionale che modifica automaticamente l'aspetto del grafico al verificarsi di una condizione specifica.
Questa sezione è disponibile solo se hai configurato esattamente un valore monitorato nella sezione Data. Se non hai aggiunto alcun valore o ne hai aggiunti più di uno, la sezione Style non sarà accessibile.
Per configurare uno stile condizionale:

~~Name:~~Nome: assegna un nome identificativo allo stile condizionale.
If (~~Dimension)~~Parametro): seleziona il parametro di riferimento su cui applicare la condizione (esempio: Temperature).
Is (~~Criteria)~~Criterio): scegli il tipo di condizione tra quelle disponibili (esempio: maggiore di, minore di, uguale a).
~~Type~~Type:: scegli se ~~applicare~~ la condizione insi ~~base~~basa asu un ~~valore diretto~~Valore o asu una ~~soglia configurata.~~Threshold. Se non sono ~~presenti~~state ~~soglie,~~impostate ~~l’opzione~~threshold ~~resta~~per ~~impostata di default sul~~il valore ~~diretto.~~selezionato, verrà automaticamente selezionata l'opzione Valore.
~~Value:~~Valore / Threshold: definisci il valore dio ~~soglia~~selezione la threshold che attiva lo stile condizionale.
~~Color:~~Colore: seleziona il colore da applicare quando la condizione si verifica.

Per aggiungere ulteriori condizioni, clicca su Add condition, per ripristinare le impostazioni predefinite dello stile, clicca su Reset.

Salvare e modificare i grafici

Per salvare il grafico, clicca sul bottone Salva in alto a destra della pagina di configurazione della classe oggetto.
Una volta salvato, il grafico appare come card nella sezione Attributi della pagina di configurazione e può essere riordinato insieme agli altri attributi della classe.
Per modificare successivamente la configurazione di un grafico, clicca sulla rispettiva card nella sezione Data Sources e accedi nuovamente al configuratore.

Suggerimenti utili

💡 Pianifica le data source prima dei grafici
Prima di creare i grafici, aggiungi tutte le data source necessarie. Questo ti permette di configurare grafici comparativi senza dover tornare indietro nella configurazione.

💡 Usa nomi descrittivi
Assegna nomi chiari e identificativi a data source e grafici (esempio: "Termometro Piano 1", "Grafico Temperature Giornaliere"). Facilita la gestione quando lavori con molti sensori.

💡 Threshold per monitoraggio visivo
Imposta threshold nella sezione Customization per evidenziare automaticamente valori fuori norma con linee di riferimento sul grafico. Utile per identificare rapidamente situazioni critiche.

💡 Combina threshold e stili condizionali
Configura prima le threshold in Customization, poi usa la sezione Style per applicare colori specifici quando i valori superano quelle soglie. Questo crea un sistema di allerta visivo completo.

💡 Configura i Default values secondo l'uso
Imposta periodo e aggregazione predefiniti in base alla frequenza di consultazione: dati in tempo reale richiedono aggregazioni brevi (secondi, minuti), analisi storiche aggregazioni più ampie (ore, giorni).

💡 Scala Fixed per confronti coerenti
Usa la scala Fixed negli Axes quando confronti più grafici dello stesso parametro. Mantenere lo stesso range facilita il confronto visivo tra periodi o sensori diversi.

💡 Riordina i grafici strategicamente
Posiziona i grafici più importanti in alto nella sezione Attributi per facilitarne l'accesso rapido dal menu Dettaglio attributi degli oggetti.

Collegamenti

Creare una nuova classe oggetto
Assegnare una data source a un oggetto
Visualizzare i dettagli di un oggetto
Nozioni di base su grafici e data source

Problemi comuni

Problema	Soluzione
L'opzione Chart non è visibile	Verifica di aver aggiunto almeno una data source nella sezione. L'opzione Chart appare solo dopo l'inserimento di una data source
La sezione Customization è disabilitata	Completa prima la configurazione della sezione Data con tutti i campi obbligatori (Data compression, Master Data source, Asse X e Asse Y)
La sezione Style non è disponibile	Verifica di aver configurato esattamente un valore monitorato nella sezione Data. Con zero valori o più di uno, la sezione Style non è accessibile
Il campo Type nella sezione Style è disabilitato	Il campo Type è disponibile solo se hai configurato una threshold per il parametro selezionato nella sezione Customization. Senza threshold, rimane su Value di default
Il grafico non mostra dati	Controlla che la data source selezionata sia attiva e stia raccogliendo dati. Verifica anche che il sensore sia correttamente associato agli oggetti nei progetti
Non vedo il grafico nella sezione Attributi	Assicurati di aver salvato la configurazione della classe oggetto dopo aver creato il grafico
Le threshold non appaiono sul grafico	Verifica di aver impostato correttamente Name, Asse e Date Time per ogni soglia nella sezione Customization. Controlla anche che il valore sia compreso nel range visualizzato
Lo stile condizionale non si applica	Controlla che la condizione sia configurata correttamente e che i dati effettivi soddisfino i criteri impostati (If, Is, Type, Value). Verifica di aver salvato la classe oggetto
Non riesco a modificare un grafico esistente	Clicca sulla card del grafico nella sezione Data Sources (non nella sezione Attributi) per accedere al configuratore

Ultimo aggiornamento: 8 ottobre 2025