Expressions
Expressions
Le funzionalità di espressione di ProcessMind permettono di generare testi dinamici e contenuti avanzati nei dashboard. Con le expressions puoi creare visualizzazioni coinvolgenti e informative che si adattano ai tuoi dati. Poiché i contenuti possono cambiare in base alle interazioni degli utenti o agli aggiornamenti del data, le expressions sono uno strumento potente per mantenere i tuoi dashboard sempre rilevanti e utili. In questa guida troverai esempi e notazioni per utilizzare al meglio le expressions.
Basi
Per un utilizzo base, puoi usare le expressions per richiamare metriche e attributi direttamente all’interno dei tuoi testi. Questo ti permette di avere contenuti dinamici che si aggiornano in automatico quando i dati cambiano.
Esempio 1: Nr di casi vs Numero totale di casi
Voglio visualizzare il numero di casi attivi rispetto al numero totale. L’espressione sarà:
Nr di casi in vista: ${metric} / Totale casi: ${total}
Dove ${metric} è il valore attuale e ${total} rappresenta il totale dei casi.
Esempio 2: Nr di casi non inclusi
Voglio visualizzare il numero di casi esclusi sottraendo dal totale:
Nr di casi non inclusi: ${total - metric}
Dove ${metric} è il valore attuale della metrica e ${total} è il totale dei casi.
Esempio 3: Percentuale dei casi con una funzione
Voglio mostrare la percentuale dei casi in vista rispetto al totale:
Percentuale casi in vista: ${formatPercentage(metric)}
Dove ${metric} è la metrica corrente impostata su casi.
Funzioni disponibili
ProcessMind offre una serie di funzioni utilizzabili nelle expressions per calcoli, formattazioni e lookup dinamici. Puoi combinare queste funzioni con metriche e attributi per generare testi più potenti e mirati.
| Function | Descrizione | Esempio |
|---|---|---|
round(value, decimals?) | Arrotonda un numero all’intero più vicino o a un numero specifico di decimali. | ${round(metric, 2)} → 123.46 |
power(base, exponent) | Eleva un numero a potenza (come pow). | ${power(2, 3)} → 8 |
pow(base, exponent) | Alias di power. | ${pow(metric, 2)} |
sqrt(value) | Restituisce la radice quadrata. | ${sqrt(metric)} |
abs(value) | Restituisce il valore assoluto (senza segno meno). | ${abs(metric)} |
ceil(value) | Arrotonda per eccesso all’intero superiore. | ${ceil(3.2)} → 4 |
floor(value) | Arrotonda per difetto all’intero inferiore. | ${floor(3.8)} → 3 |
exp(value) | Restituisce il numero di Eulero e elevato alla potenza del valore. | ${exp(1)} → 2.718... |
log(value) | Restituisce il logaritmo naturale (base e). | ${log(metric)} |
mod(dividend, divisor) | Restituisce il resto della divisione. | ${mod(10, 3)} → 1 |
formatDate(date, format?) | Converte una data in formato leggibile. Accetta pattern opzionali. | ${formatDate(created_at, "YYYY-MM-DD")} |
formatDuration(ms) | Converte una durata in millisecondi in formato leggibile. | ${formatDuration(metric)} → 3d 4h 5m |
formatPercentage(value) | Trasforma un valore decimale in percentuale. | ${formatPercentage(metric)} → 75% |
getVariable(name) | Recupera il valore di una variabile definita dall’utente. | ${getVariable("Case Id")} |
Tip: Le funzioni possono essere annidate o combinate con operazioni matematiche.
Esempio:
${formatPercentage(round(metric / total, 2))}
Questo calcola un rapporto, lo arrotonda a 2 decimali e lo formatta come percentuale.
Conclusioni
La possibilità di combinare metriche, attributi, operatori e funzioni ti permette di creare dashboard che vanno oltre la semplice visualizzazione di numeri: raccontano una storia. Grazie alle expressions, puoi costruire testi dinamici e insight calcolati che si aggiornano mentre gli utenti filtrano o esplorano i dati.
Che si tratti di mostrare percentuali, evidenziare KPI o formattare valori per una facile lettura, le expressions rendono i tuoi dashboard informativi, operativi e visivamente efficaci – tutto senza scrivere codice personalizzato.
Usa questi strumenti per guidare gli utenti verso insight di valore, individuare i trend e rendere i dati più comprensibili. Con un po’ di creatività, i tuoi dashboard possono diventare narrazioni interattive per supportare decisioni migliori.