# Kennzahl (KPI) Widget type: `opendash-widget-hc-kpi` · Plugin: `@opendash/plugin-highcharts` ![Key Figure (KPI) preview](../../../../../_attachments/opendash/widgets/assets/widget-previews/hc-kpi.png) ### Beschreibung Das Widget **Kennzahl (KPI)** stellt einen einzelnen, hochrelevanten Messwert deines IoT-Systems als prägnanten und unübersehbaren Zahlenwert dar. Es dient dazu, kritische Live-Daten oder kumulierte Schlüsselwerte in Echtzeit zu überwachen, damit Abweichungen sofort ins Auge springen. ### Voraussetzungen * Mindestens ein numerischer Datenpunkt oder eine Zeitreihe (z. B. Wirkleistung, Temperatur, Druck oder Effizienzfaktoren) im IoT-System. --- ## 1. Konfiguration und Einrichtung 1. Bewege den Mauszeiger über das noch unkonfigurierte Widget, klicke oben rechts auf das Drei-Punkte-Menü und wähle **Einstellungen** aus. 2. Klicke im Reiter **Daten** in das Eingabefeld unter „Wähle Datenquellen aus, die du Visualisieren möchtest.“ mit der Beschriftung **Auswahl von einem Daten Item**. 3. Wähle aus der Liste der verfügbaren Gerätestrukturen den gewünschten Messwert aus (z. B. `Cos-Phi (Gesamt)`). 4. Wechsel bei Bedarf in den oberen Reiter **Einstellungen**, um die visuelle Formatierung an deine Bedürfnisse anzupassen. 5. Klicke unten rechts auf die Schaltfläche **Speichern**, um die Kennzahl auf deinem Dashboard zu aktivieren. --- ## 2. Erweiterte Einstellungen & Formatierung | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Auswahl von einem Daten Item** | Haupt-Datenfeld im Reiter *Daten* | Legt fest, welcher spezifische Sensorwert oder welche Telemetriekennzahl visualisiert wird. | | **Sonstige Einstellungen** | Ausklappbares Zusatzmenü | Ermöglicht ergänzende Zeitbereichsanpassungen oder Aggregationsregeln für den ausgewählten Wert. | | **Icon anzeigen** | Kontrollkästchen im Reiter *Einstellungen* | Blendet ein passendes Symbol neben dem Zahlenwert ein, um die Art der Kennzahl visuell zu verdeutlichen. | | **Verlaufsgrafik im Hintergrund anzeigen** | Kontrollkästchen im Reiter *Einstellungen* | Hinterlegt den aktuellen Zahlenwert mit einer dezenten Trendkurve (Sparkline) des historischen Verlaufs. | | **Zeitstempel verstecken** | Kontrollkästchen im Reiter *Einstellungen* | Blendet die Datums- und Uhrzeitangabe der letzten Aktualisierung unter dem Wert aus. | | **Titel verstecken** | Kontrollkästchen im Reiter *Einstellungen* | Verbirgt die standardmäßige Beschriftung bzw. den Namen der Datenquelle über der Kennzahl. | | **Nachkommastellen** | Numerisches Eingabefeld | Bestimmt, mit wie vielen Dezimalstellen (z. B. `2`) der Messwert auf dem Dashboard dargestellt wird. | --- ## 3. Das fertige Dashboard-Ergebnis Nach dem Speichern präsentiert das Widget den ausgewählten Messwert in einer großen, gut lesbaren Schriftart auf dem Dashboard. Direkt darunter signalisiert ein präziser Zeitstempel (z. B. `02.07.2026 @ 15:45:00`), wann der Wert zuletzt aktualisiert wurde. Je nach gewählten Formatierungsoptionen sorgt eine im Hintergrund liegende, sanfte Verlaufskurve für ein direktes Verständnis darüber, ob sich der Trend der Kennzahl aktuell nach oben oder unten bewegt. > 💡 **Praxis-Tipp:** Nutze die Option **Verlaufsgrafik im Hintergrund anzeigen** bei schwankungsanfälligen Werten wie der Wirkleistung oder dem Leistungsfaktor (Cos-Phi). So siehst du nicht nur den aktuellen Momentanzustand, sondern erkennst sofort, ob dem aktuellen Wert ein plötzlicher Peak oder ein kontinuierlicher Abfall vorausgegangen ist.