# Status-KPI Widget type: `opendash-widget-hc-status-kpi` · Plugin: `@opendash/plugin-highcharts` ![Status KPI preview](../../../../../_attachments/opendash/widgets/assets/widget-previews/hc-status-kpi.png) ### Beschreibung Das Widget **Status-KPI** visualisiert aktuelle Betriebs- und Telemetriedaten in direkter Abhängigkeit von vordefinierten Grenzwerten oder Statusbedingungen. Durch den dynamischen Farbwechsel signalisiert es IoT-Anwendern auf den ersten Blick, ob sich eine Anlage im Normalbetrieb, im kritischen Bereich oder im Stillstand befindet. ### Voraussetzungen * Mindestens ein numerischer Datenpunkt oder Status-Event-Datenstrom (z. B. Verbrauch, Auslastung, Fehlermeldungen) im IoT-System. * Vordefinierte Schwellenwerte oder logische Bedingungen zur farblichen Kennzeichnung des Status. --- ## 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 (oder klicke direkt auf die Schaltfläche **Einstellungen** auf der Kachel). 2. Klicke im Reiter **Daten** in das Such- und Auswahlfeld unter **Wähle Datenquellen aus, die du Visualisieren möchtest.** und wähle die gewünschten Datenpunkte (z. B. `Status` und `Verbrauch` einer Maschine) aus. 3. Wechsle im oberen Menü in den Reiter **Einstellungen**. 4. Scrolle zum Bereich **Bedingungen** herunter und klappe die gewünschte Datenquelle auf, um Schwellenwerte zuzuweisen. 5. Klicke auf eine bestehende Bedingung (z. B. **Bedingung 1**) oder auf **+ Bedingung hinzufügen**, um ein logisches Regelwerk aufzubauen (z. B. „Wenn der Verbrauch kleiner als 23 kWh ist, leuchtet die Anzeige grün“). 6. Bestätige deine Eingaben im Regel-Fenster mit **Fertig** und klicke anschließend unten rechts im Einstellungsmenü auf **Speichern**. --- ## 2. Erweiterte Einstellungen & Formatierung | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Wähle Datenquellen aus...** | Haupt-Auswahlfeld im Reiter *Daten* | Legt fest, welche Datenquellen in die Statusüberwachung einbezogen werden. | | **Lade Live-Daten** | Kontrollkästchen im Reiter *Daten* | Aktiviert die Echtzeit-Visualisierung der eintreffenden Datenströme ohne zeitliche Verzögerung. | | **Sonstige Einstellungen** | Ausklappbares Zusatzmenü im Reiter *Daten* | Bietet Optionen wie „Automatisch Aktualisieren“, um die Anzeige fortlaufend neu zu laden. | | **Anzeigeoptionen** | Klappmenü im Reiter *Einstellungen* | Ermöglicht allgemeine Darstellungsanpassungen (z. B. Ein-/Ausblenden von Titeln oder Symbolen). | | **Formatierung** | Farbauswahl im Reiter *Einstellungen* | Bestimmt die neutrale Standardfarbe des Widgets, falls aktuell keine der definierten Bedingungen zutrifft. | | **Nachkommastellen** | Numerisches Eingabefeld | Legt fest, auf wie viele Nachkommastellen die angezeigten Messwerte gerundet werden. | | **Bedingungen** | Regel-Editor je Datenquelle | Erlaubt die Erstellung logischer Verknüpfungen (UND/ODER-Gruppen, Vergleiche wie „Nummer kleiner als“) und die Zuweisung von Statusfarben für jeden Zustand. | --- ## 3. Das fertige Dashboard-Ergebnis Sobald alle Einstellungen gespeichert sind, zeigt das Widget die konfigurierten Datenquellen als übersichtliche Status-Kacheln auf dem Dashboard an. Jede Kachel nimmt dynamisch die Farbe an, die durch die aktuellen Live-Messwerte und die hinterlegten Bedingungen vorgegeben wird (z. B. ein auffälliges Rot bei einer vorliegenden Störung oder ein beruhigendes Grün bei normalem Energieverbrauch). Neben dem Namen der Datenquelle wird der aktuelle Messwert inklusive Einheit und ein präziser Zeitstempel der letzten Übertragung dargestellt.