Expressions
Expressions
Le expressions di ProcessMind permettono di generare testi avanzati e contenuti dinamici nei tuoi dashboard. Le expressions rendono i dashboard più interattivi e si adattano automaticamente ai dati. Questa guida include esempi pratici e notazioni utili per utilizzare le expressions in modo efficace.
Nozioni di base
Puoi usare le expressions per richiamare metriche e attributi direttamente nel testo. Questo consente di creare contenuti dinamici che si aggiornano automaticamente al variare dei dati.
Esempio 1: Numero di Case vs Totale Case
Per visualizzare il numero di case attivi rispetto al totale, usa:
Nr di case in vista: ${metric} / Totale case: ${total}
Qui ${metric} indica il valore attuale della metrica e ${total} il totale dei case.
Esempio 2: Case non inclusi
Per mostrare il numero di case non inclusi (totale meno attuali):
Nr di case non inclusi: ${total - metric}
Anche qui ${metric} è il valore corrente e ${total} il totale dei case.
Esempio 3: Percentuale di Case tramite Funzione
Per mostrare la percentuale di case in vista rispetto al totale:
Percentuale di case in vista: ${formatPercentage(metric)}
Qui ${metric} si riferisce alla metrica impostata sui case.
Funzioni disponibili
ProcessMind supporta diverse funzioni nelle expressions per calcoli, formattazione e lookup dinamici. Puoi combinarle con metriche e attributi per ottenere risultati potenti e flessibili.
| Funzione | Descrizione | Esempio |
|---|---|---|
round(value, decimals?) | Arrotonda un valore all’intero più vicino o a un numero di decimali specifico. | ${round(metric, 2)} → 123.46 |
power(base, exponent) | Eleva un numero a potenza (uguale a pow). | ${power(2, 3)} → 8 |
pow(base, exponent) | Alias di power. | ${pow(metric, 2)} |
sqrt(value) | Restituisce la radice quadrata di un numero. | ${sqrt(metric)} |
abs(value) | Restituisce il valore assoluto (senza segno negativo). | ${abs(metric)} |
ceil(value) | Arrotonda in eccesso all’intero successivo. | ${ceil(3.2)} → 4 |
floor(value) | Arrotonda in difetto all’intero precedente. | ${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?) | Format di una data in stringa leggibile. Accetta pattern opzionali. | ${formatDate(created_at, "YYYY-MM-DD")} |
formatDuration(ms) | Converte una durata in millisecondi in un formato leggibile. | ${formatDuration(metric)} → 3d 4h 5m |
formatPercentage(value) | Format di un decimale come percentuale. | ${formatPercentage(metric)} → 75% |
getVariable(name) | Recupera il valore di una variabile definita dall’utente. | ${getVariable("Case Id")} |
Suggerimento: Puoi annidare funzioni o combinarle con operatori matematici. Ad esempio:
${formatPercentage(round(metric / total, 2))}
Calcola un rapporto, arrotonda a due decimali e lo visualizza come percentuale.
Sfrutta al massimo le Expressions
Combinando metriche, attributi, operatori e funzioni, puoi creare dashboard che vanno oltre la semplice visualizzazione dei numeri: raccontano una storia. Le expressions permettono di costruire testi dinamici e insight calcolati che si aggiornano automaticamente quando si filtra o si esplora il dato.
Che tu debba mostrare percentuali, evidenziare KPI o formattare valori in modo chiaro, le expressions aiutano a mantenere i dashboard informativi, azionabili e visivamente efficaci—senza scrivere codice custom.
Usa queste funzioni per guidare l’utente verso insight rilevanti, evidenziare trend e semplificare la comprensione dei dati. Con un po’ di creatività, i tuoi dashboard diventano vere narrazioni interattive che supportano decisioni più consapevoli.