Expressions

Die Expression-Funktionen von ProcessMind ermöglichen die Erstellung von aussagekräftigem Text und dynamischem Content direkt in Ihren Dashboards. Mit Expressions können Sie ansprechende und informative Visualisierungen generieren, die sich flexibel an Ihre Daten anpassen. Da sich der Inhalt je nach Benutzereingaben und Datenänderungen anpasst, bieten Expressions einen effektiven Weg, Ihre Dashboards stets aktuell und relevant zu halten. In diesem Guide zeigen wir Beispiele und Notationen für den optimalen Einsatz von Expressions.

Grundlagen

Für die einfache Nutzung können Sie Expressions verwenden, um Metriken und Attribute direkt in den Text einzubinden. So entsteht dynamischer Content, der sich bei Änderungen automatisch aktualisiert.

Beispiel 1: Anzahl der aktiven Cases vs. Gesamtanzahl

Ich möchte die Anzahl der aktiven Cases im Vergleich zur Gesamtanzahl darstellen. Der Ausdruck sieht so aus:

Nr of cases in view: ${metric} / Total Cases: ${total}

Hier steht ${metric} für den aktuellen Wert und ${total} für alle Cases insgesamt.

Beispiel 2: Anzahl der nicht enthaltenen Cases

Ich möchte die Anzahl der vom Gesamtwert abgezogenen Cases anzeigen:

Nr of cases not included: ${total - metric}

Wobei ${metric} der aktuelle Metrik-Wert ist und ${total} die Gesamtzahl aller Cases.

Beispiel 3: Prozentsatz der Cases mit Funktion anzeigen

Ich möchte den Prozentsatz der angezeigten Cases im Verhältnis zum Gesamtwert darstellen:

Percentage of cases in view: ${formatPercentage(metric)}

Hier ist ${metric} die aktuelle Metrik für Cases.

Verfügbare Funktionen

ProcessMind unterstützt eine Vielzahl an Funktionen, die Sie innerhalb von Expressions zum Berechnen, Formatieren und für dynamische Abfragen nutzen können. Kombinieren Sie diese Funktionen mit Ihren Metriken und Attributen für leistungsstarke Text-Ausgaben.

Function	Beschreibung	Beispiel
`round(value, decimals?)`	Rundet eine Zahl auf die nächste Ganzzahl oder auf die festgelegte Dezimalstelle.	`${round(metric, 2)}` → `123.46`
`power(base, exponent)`	Potenziert eine Zahl (wie `pow`).	`${power(2, 3)}` → `8`
`pow(base, exponent)`	Alias für `power`.	`${pow(metric, 2)}`
`sqrt(value)`	Gibt die Quadratwurzel einer Zahl zurück.	`${sqrt(metric)}`
`abs(value)`	Gibt den Absolutwert zurück (ohne Vorzeichen).	`${abs(metric)}`
`ceil(value)`	Rundet eine Zahl auf zur nächsten Ganzzahl auf.	`${ceil(3.2)}` → `4`
`floor(value)`	Rundet eine Zahl ab zur nächsten Ganzzahl ab.	`${floor(3.8)}` → `3`
`exp(value)`	Gibt Eulers Zahl e hoch den Wert zurück.	`${exp(1)}` → `2.718...`
`log(value)`	Gibt den natürlichen Logarithmus (Basis e) zurück.	`${log(metric)}`
`mod(dividend, divisor)`	Gibt den Rest nach einer Division zurück.	`${mod(10, 3)}` → `1`
`formatDate(date, format?)`	Formatiert ein Datum als lesbaren String. Optional Formatierungsmuster möglich.	`${formatDate(created_at, "YYYY-MM-DD")}`
`formatDuration(ms)`	Wandelt eine Dauer in Millisekunden in eine lesbare Zeitangabe um.	`${formatDuration(metric)}` → `3d 4h 5m`
`formatPercentage(value)`	Wandelt eine Dezimalzahl als Prozentwert um.	`${formatPercentage(metric)}` → `75%`
`getVariable(name)`	Ruft den Wert einer benutzerdefinierten Variable ab.	`${getVariable("Case Id")}`

Tipp: Funktionen können verschachtelt oder mit Operatoren kombiniert werden.
Beispiel:

${formatPercentage(round(metric / total, 2))}

Dies berechnet ein Verhältnis, rundet es auf 2 Dezimalstellen und formatiert es als Prozentwert.

Abschließende Hinweise

Die Kombination aus Metriken, Attributen, Operatoren und Funktionen ermöglicht es, Dashboards zu erstellen, die mehr als nur Zahlen anzeigen – sie erzählen Ihre Prozess-Story. Mit Expressions können Sie dynamischen Text und berechnete Insights generieren, die sich automatisch an Nutzerfilter und Datenexploration anpassen.

Ob prozentuale Anteile, KPI-Highlighting oder lesbare Formatierungen: Mit Expressions bleiben Ihre Dashboards informativ, interaktiv und verständlich – ganz ohne eigenen Code.

Nutzen Sie diese Tools, um Nutzer gezielt zu Insights zu führen, Trends sichtbar zu machen und Daten verständlich aufzubereiten. Mit etwas Kreativität werden Ihre Dashboards zu interaktiven Narrativen, die bessere Entscheidungen unterstützen.