# Status-Ampel (mehrfach) Widget type: `opendash-widget-hc-mapped-kpi` · Plugin: `@opendash/plugin-highcharts`  ### Beschreibung Das **Status-Ampel (mehrfach) Widget** ermöglicht es, den aktuellen Zustand mehrerer logisch verknüpfter Bedingungen gleichzeitig in einer kompakten Listenansicht darzustellen. IoT-Anwender profitieren davon, verschiedene Alarmstufen, Event-Zustände oder Schwellenwertüberschreitungen (wie z. B. parallel laufende Produktionsmodi und kritische Verbrauchswerte) gebündelt in einem einzigen Widget im Blick zu behalten. ### Voraussetzungen * Mindestens ein konfiguriertes IoT-Datenfeld, ein numerischer Schwellenwert oder ein Event-Zustand im System (z. B. Maschinenzustände, Fehlermeldungen oder Leistungsdaten). * Berechtigungen zum Bearbeiten und Konfigurieren von Dashboards und Widgets. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf die Schaltfläche **Einstellungen** auf dem noch nicht konfigurierten Widget-Block, um das Konfigurationsfenster zu öffnen. 2. Definiere bei Bedarf ganz oben im Dropdown-Menü die Ausrichtung (z. B. **Vertikal**), um festzulegen, wie die einzelnen Statusmeldungen angeordnet werden sollen. 3. Klicke im Bereich **Bedingungen** auf die Schaltfläche **+ Bedingung hinzufügen**, um eine neue Auswertungsregel (Bedingung 1) zu erstellen. 4. Klicke im sich öffnenden Seitenmenü auf **Bedingung hinzufügen**, um das Auswahlmenü für die Datenquellen anzuzeigen. 5. Wähle unter **Daten Item auswählen** das gewünschte Datenfeld aus der Liste aus (z. B. `Demo Halle B - Event Zustand`). 6. Definiere unter **Wähle einen Auslöser** die logische Regel, indem du den passenden Operator auswählst (z. B. **Zeichenkette entspricht**). 7. Trage im Feld **Gib den Vergleichs-Zeichenkette ein** den genauen Statuswert ein, bei dem die Bedingung greifen soll (z. B. `Produktion`). 8. Bestimme im Bereich **Darstellung** das visuelle Erscheinungsbild für diesen Zustand: * Wähle die gewünschte Signalfarbe über den Farbregler oder die Farbmatrix aus (z. B. ein helles Grün). * Klicke optional auf das Icon-Feld (standardmäßig `facircle`), um ein passendes Symbol aus der Icon-Bibliothek zuzuweisen. * Lege im Dropdown-Menü **Icon-Ausrichtung** fest, wo das Symbol positioniert werden soll (z. B. **Links**). * Trage im Feld **(Optional) Angezeigter Text** die genaue Beschriftung ein, die auf dem Dashboard erscheinen soll (z. B. `Produktion`). 9. Klicke unten rechts im Seitenmenü auf **Fertig**, um die Bedingung zu sichern. 10. Wiederhole die Schritte 3 bis 9 für alle weiteren Zustände, die du parallel überwachen möchtest. Du kannst dabei auch numerische Datenquellen wählen und als Auslöser mathematische Operatoren (z. B. **Nummer größer als** mit einem Wert wie `22.5` und der Beschriftung `Verbrauch hoch!`) verwenden. 11. Klicke abschließend unten rechts im Hauptfenster auf **Speichern**, um die Konfiguration anzuwenden und die mehrfache Status-Ampel auf dem Dashboard zu aktivieren. --- ## 2. Erweiterte Einstellungen & Formatierung Die Bedingungen werden von oben nach unten auf ihre Gültigkeit geprüft. Das Widget zeigt alle Bedingungen an, deren Regeln auf die aktuellen Live-Werte zutreffen: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Ausrichtung der Meldung** | Dropdown-Menü ganz oben im Konfigurationsfenster. | Wechselt das Layout der Statusliste zwischen einer vertikalen (untereinander) oder horizontalen (nebeneinander) Anordnung. | | **UND-Gruppe** | Logischer Verknüpfungs-Tab im Bedingungen-Seitenmenü. | Erlaubt es, mehrere Bedingungen so miteinander zu verknüpfen, dass alle Kriterien gleichzeitig erfüllt sein müssen, damit dieser spezifische Status aktiv wird. | | **ODER-Gruppe** | Logischer Verknüpfungs-Tab im Bedingungen-Seitenmenü. | Erlaubt es, alternative Kriterien zu definieren, sodass der Status aktiv wird, sobald mindestens eine der Regeln zutrifft. | | **Löschen (Mülleimer-Symbol)** | Symbol rechts neben einer Bedingung im Hauptmenü. | Entfernt die ausgewählte Bedingungszeile dauerhaft aus der Konfiguration des Widgets. | | **Standard-Anzeige verwenden...** | Kontrollkästchen unten im Konfigurationsfenster. | Definiert eine Standardanzeige (Farbe/Icon/Text), die einspringt, falls aktuell keine einzige der definierten Regeln zutrifft. Ohne Haken bleibt das Widget für nicht definierte Zustände leer. | --- ## 3. Das fertige Dashboard-Ergebnis Nach der erfolgreichen Konfiguration liefert das Widget eine übersichtliche, strukturierte Liste auf dem Dashboard. Jeder aktuell zutreffende Zustand wird als eigenständiger farbiger Block mit der festgelegten Beschriftung und dem gewählten Icon dargestellt. Ändern sich die IoT-Datenwerte im Hintergrund, passt sich die Anzeige in Echtzeit an – zutreffende Ereignisse leuchten sofort in ihrer Signalfarbe auf, während inaktive Bedingungen ausgeblendet werden. Dies ermöglicht die kompakte und simultane Überwachung völlig unterschiedlicher Datenkriterien in einem einzigen Anzeigefeld. > 💡 **Praxis-Tipp:** Nutze die Kombination aus Text- und Zahlenwerten! Du kannst in einem einzigen Widget sowohl textbasierte Zustände (z. B. `Produktion`) als auch kritische Schwellenwerte (z. B. `Leistung > 22.5 kW`) abbilden, um einen schnellen, ganzheitlichen Statusbericht zu erhalten.