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 nuovamente sul bottone + in basso a destra e seleziona l'opzione Chart (identificata dall'icona di un grafico 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 Chart, Bar Chart, Scatter Chart.
Dopo aver definito nome e tipo, la card si espande mostrando il configuratore con tre sezioni: Data, Customization e Style. Le opzioni di configurazione disponibili variano in base al tipo di grafico selezionato.

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.
Data source: seleziona quale data source alimenta il grafico tra quelle configurate in precedenza.
Asse X e Asse Y: seleziona il parametro monitorato per ciascun asse. Nel Counter Chart questo campo è sostituito da Monitored Value.

Per aggiungere ulteriori serie di dati al grafico, clicca su Aggiungi serie. Nel Counter Chart, clicca su Aggiungi valore.

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: definisci se applicare la soglia all'asse X o Y.
Trigger value: 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:

Nome: assegna un nome identificativo allo stile condizionale.
If (Parametro): seleziona il parametro di riferimento su cui applicare la condizione (esempio: Temperature).
Is (Criterio): scegli il tipo di condizione tra quelle disponibili (esempio: maggiore di, minore di, uguale a).
Type: scegli se la condizione si basa su un Valore o su una Threshold. Se non sono state impostate threshold per il valore selezionato, verrà automaticamente selezionata l'opzione Valore.
Valore / Threshold: definisci il valore o selezione la threshold che attiva lo stile condizionale.
Colore: seleziona il colore da applicare quando la condizione si verifica.

Per aggiungere ulteriori condizioni, clicca su Aggiungi condizione, 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

💡 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.

💡 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).

Collegamenti

Problemi comuni

Problema	Soluzione
L'opzione per aggiungere un Chart non è visibile	Assicurati di aver aggiunto almeno una data source nella sezione. L'opzione Chart diventa disponibile solo dopo l'inserimento di almeno una data source.
La sezione Customization è disabilitata	Completa prima la configurazione della sezione Data.
La sezione Style non è disponibile	Verifica di aver configurato esattamente un valore monitorato nella sezione Data. Se non ci sono valori o ce ne sono più di uno, la sezione Style non sarà accessibile.
Il campo Type nella sezione Style è disabilitato	Il campo Type si attiva solo se hai configurato una threshold per il parametro selezionato. In assenza di threshold, resta impostato su Value.
Il grafico non mostra dati	Controlla che la data source selezionata sia attiva e stia raccogliendo dati. Assicurati inoltre che il sensore sia correttamente associato agli oggetti nel progetto.

Ultimo aggiornamento: 9 ottobre 2025