Widget Builder: creare widget su misura
Il Widget Builder è il catalogo ufficiale dei widget di ServiceBoard: da qui crei, cloni e configuri i widget (numeri chiave, grafici e tabelle) che poi usi in Le mie dashboard e nei Report. Ti serve quando i widget di sistema non bastano e vuoi una vista su misura, senza scrivere codice o SQL.
Come si fa
- Vai in Impostazioni (menu a sinistra, solo per amministratori) e apri Widget Builder (gruppo dedicato alla personalizzazione).
- Premi Nuovo widget in alto. Si apre il costruttore a sinistra e l'anteprima a destra.
- Tipo widget (passo 1): scegli come rappresentare il dato — tabella, grafico a barre, ciambella, KPI, tabella di analisi, serie temporale, gauge SLA e altri. Sotto trovi le Visualizzazioni speciali (gauge, blocchi di stato, ciambella con totale, numero grande, andamento con obiettivo, riquadro di testo).
- Campo sorgente: indica il campo da misurare (
da cui aggregare). Puoi scegliere un campo standard (stato, priorità, tipologia, categoria…) o un campo personalizzato con la sintassicustomFields.NomeCampo. - Aggregazione (per i KPI): scegli tra Count totale (quante righe passano i filtri), Count distinct (valori unici del campo), Somma valori numerici o Media valori numerici. Per grafici e tabelle imposti invece il Top N (
0 = tutti). - Filtri: con Aggiungi filtro limiti i dati (per esempio escludi uno stato o una categoria). Valgono solo per questo widget.
- Visualizzazione (passo 3): imposti colonne e intestazioni (per tabelle), metriche extra, colori della palette e per categoria, e le eventuali soglie di salute.
- Destinazioni: scegli dove renderlo disponibile — Dashboard (compare nel picker di "Le mie dashboard"), Report (compare come sezione in Report) o entrambe. Ne serve almeno una.
- Dai un nome al widget, controlla l'anteprima e premi Crea widget (o Salva modifiche se lo stai modificando). Premi Annulla per uscire senza salvare.
L'anteprima su dati di esempio
Mentre configuri, il pannello di destra mostra il widget in funzione. Puoi passare tra la resa dashboard (sfondo scuro) e la resa report (sfondo chiaro).
Attenzione: le card del catalogo (l'elenco dei widget già pronti) usano un dataset di esempio, sintetico e anonimo, non i dati reali del tuo tenant. È una scelta di privacy e leggibilità: nell'elenco non compaiono mai nomi reali di clienti o tecnici. Solo l'anteprima live del widget che stai costruendo lavora sui dati reali del tuo ambito.
Nota: le card del catalogo usano un dataset di esempio anonimo, non i tuoi dati reali. Per verificare un widget sui dati veri del tuo ambito guarda l'anteprima live del pannello di destra mentre lo costruisci.
I tipi di visualizzazione
Oltre a tabelle e grafici classici puoi mostrare un valore come:
- numero grande (KPI) per un singolo dato in evidenza;
- indicatore / gauge per un valore su una scala;
- ciambella con il totale al centro;
- blocchi di stato colorati (ok / attenzione / critico);
- andamento (trend) con linea di riferimento (media o obiettivo);
- riquadro di testo per intestare o annotare.
Le famiglie connettore pronte
Nel catalogo, oltre ai widget su ticket e SLA, trovi voci già pronte per le famiglie connettore: Microsoft 365, NinjaOne Backup, Offerte / Pipeline, Licenze & Scadenze, Salute Monitor e Oggetti. Le riconosci nella colonna di sinistra sotto il gruppo INTEGRAZIONI (i widget su ticket/SLA stanno sotto OPERATIVITÀ).
Sono voci "pronte all'uso": premi Configura e salva per aprire l'editor già precompilato: scegli la connessione, la metrica e — se vuoi — il cliente nella sezione Visualizzazione, quindi salvi. Per queste voci l'anteprima nel catalogo mostra un segnaposto (non i dati reali del connettore).
L'assistente AI di configurazione
In cima al costruttore trovi il pannello Assistente AI configurazione. Aprilo, descrivi a parole il widget che vuoi (per esempio "KPI dei ticket aperti con tabella filtrabile per categoria, target dashboard e report") e premi Compila con AI.
L'assistente compila i campi al posto tuo, ma produce solo una configurazione validata sui campi che puoi usare: non scrive codice né SQL. Dopo, controlli sempre le sezioni, verifichi l'anteprima e salvi tu.
Nota: l'assistente AI produce solo una configurazione validata sui campi consentiti: mai codice o SQL. Rivedi comunque le sezioni e l'anteprima prima di salvare, perché il salvataggio resta un'azione tua.
Esempio pratico
Vuoi un widget che mostri quante offerte sono aperte per Cliente Beta, da mettere in dashboard e nei report:
- Impostazioni → Widget Builder → Nuovo widget.
- In INTEGRAZIONI scegli la voce pronta Offerte / Pipeline e premi Configura e salva.
- Nella sezione Visualizzazione scegli la metrica (offerte aperte) e, se vuoi limitarlo, il cliente Cliente Beta.
- In Destinazioni lasci attive Dashboard e Report.
- Dai un nome (per esempio "Offerte aperte") e premi Crea widget.
Ora il widget è nel catalogo e lo puoi aggiungere a una vista di Le mie dashboard o includere in un report.
Domande frequenti
- L'anteprima mostra dati reali? No. Le card del catalogo usano un dataset di esempio anonimo, per privacy e leggibilità. Solo l'anteprima del widget che stai costruendo (pannello a destra) usa i tuoi dati reali, sempre nel tuo ambito.
- Devo scrivere codice o SQL? No, mai. Configuri tutto con menu e campi. Anche l'assistente AI produce solo configurazioni validate, non codice.
- Dove ritrovo il widget salvato? Nel catalogo del Widget Builder e, in base alle Destinazioni scelte, nel picker widget di Le mie dashboard e/o tra le sezioni disponibili in Report.
- Perché una voce del catalogo non ha i pulsanti Duplica/Elimina? Perché è una voce "pronta" della famiglia connettore (non ancora salvata): diventa un widget vero solo dopo che premi Configura e salva.