# Status-Ampel
![[status-ampel.png]]
### Beschreibung
Das **Status-Ampel Widget** bietet eine intuitive visuelle Anzeige des aktuellen Betriebszustands einer Maschine oder eines Prozesses auf Basis definierter Bedingungen. IoT-Anwender können damit kritische Zustände, Warnungen oder den Normalbetrieb auf einen Blick und in Echtzeit direkt auf dem Dashboard erfassen.
### Voraussetzungen
* Ein konfiguriertes IoT-Datenfeld oder ein Event-Zustand im System (z. B. Maschinenzustände oder Fehlermeldungen).
* 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. Klicke im Bereich **Bedingungen** auf die Schaltfläche **+ Bedingung hinzufügen**, um eine neue Auswertungsregel (Bedingung 1) zu erstellen.
3. Klicke im sich öffnenden Seitenmenü auf **Bedingung hinzufügen**, um das Auswahlmenü für die Datenquellen anzuzeigen.
4. Wähle unter **Daten Item auswählen** das gewünschte Datenfeld aus der Liste aus (z. B. `Demo Halle B - Event Zustand`).
5. Definiere unter **Wähle einen Auslöser** die logische Regel, indem du den passenden Operator auswählst (z. B. **Zeichenkette entspricht** oder **Zeichenkette enthält**).
6. Trage im Feld **Gib den Vergleichs-Zeichenkette ein** den genauen Statuswert ein, bei dem die Bedingung greifen soll (z. B. `Produktion`, `Wartung` oder `Ausgeschaltet`).
7. Bestimme im Bereich **Darstellung** das visuelle Erscheinungsbild für diesen Zustand:
* Wähle die gewünschte Signalfarbe über den Farbregler oder die Farbmatrix aus.
* Klicke optional auf das Icon-Feld (standardmäßig `facircle`), wähle ein passendes Symbol aus der Icon-Bibliothek aus und bestätige mit **OK**.
* Lege im Dropdown-Menü **Icon-Ausrichtung** fest, wo das Symbol positioniert werden soll (z. B. **Links**).
* Trage optional im Feld **(Optional) Angezeigter Text** eine kurze Beschriftung ein.
8. Klicke unten rechts im Seitenmenü auf **Fertig**, um die Bedingung zu sichern.
9. Wiederhole die Schritte 2 bis 8, um weitere Statusbedingungen und deren Farbzuweisungen hinzuzufügen.
10. Klicke abschließend unten rechts im Hauptfenster auf **Speichern**, um die Konfiguration anzuwenden und die Status-Ampel auf dem Dashboard zu aktivieren.
---
## 2. Erweiterte Einstellungen & Formatierung
Die Bedingungen werden von oben nach unten geprüft – es wird immer die erste Bedingung angezeigt, deren Regel auf den aktuellen Wert zutrifft. Über das Menü lassen sich zusätzliche logische Verknüpfungen und Standardanzeigen einrichten:
| Option | Beschreibung | Funktion |
| :--- | :--- | :--- |
| **UND-Gruppe** | Logischer Verknüpfungs-Tab im Bedingungen-Seitenmenü. | Erlaubt es, mehrere Bedingungen so miteinander zu verknüpfen, dass alle gleichzeitig zutreffen müssen, um den Status auszulösen. |
| **ODER-Gruppe** | Logischer Verknüpfungs-Tab im Bedingungen-Seitenmenü. | Erlaubt es, alternative Bedingungen zu definieren, sodass der Status ausgelöst wird, wenn mindestens eine der Regeln zutrifft. |
| **Löschen (Mülleimer-Symbol)** | Symbol oben rechts neben einer Bedingungs-Gruppe. | Entfernt die ausgewählte Bedingung oder die gesamte Regelgruppe unwiderruflich aus der Liste. |
| **Standard-Anzeige verwenden...** | Kontrollkästchen unten im Konfigurationsfenster. | Definiert einen Fallback-Zustand (Farbe/Icon), der angezeigt wird, wenn keine der oben definierten Regeln auf den aktuellen Wert zutrifft. Bleibt das Widget ohne aktive Regel leer. |
---
## 3. Das fertige Dashboard-Ergebnis
Nach der erfolgreichen Einrichtung zeigt das Widget eine großflächige, unmissverständliche Farbanzeige, die den aktuellen Zustand des ausgewählten IoT-Datenpunkts in Echtzeit widerspiegelt. Neben der prägnanten Hintergrundfarbe wird – je nach Konfiguration – das gewählte Statussymbol (z. B. ein Kreis- oder Alarm-Icon) gut sichtbar dargestellt. Das Widget aktualisiert sich automatisch, sobald sich das zugrundeliegende Datenfeld im System ändert, und ermöglicht so eine sofortige visuelle Überwachung ohne manuelle Interaktion.
> 💡 **Praxis-Tipp:** Da die Regeln strikt von oben nach unten abgearbeitet werden, solltest du die wichtigste oder spezifischste Bedingung (wie z. B. einen kritischen Fehlerzustand oder `Nothalt`) immer ganz oben in der Liste platzieren, damit sie sofort priorisiert signalisiert wird.