# Zustandsübergänge Widget type: `opendash-widget-pattern-dependency` · Plugin: `@opendash/plugin-highcharts`  ### Beschreibung Das **Zustandsübergänge Widget** visualisiert die Wechselbeziehungen und die Häufigkeit von Wechseln zwischen verschiedenen Betriebszuständen in Form eines kreisförmigen Chord-Diagramms. IoT-Anwender erhalten dadurch einen direkten Überblick über Prozessabfolgen und können wiederkehrende Fehlerpfade, ineffiziente Abläufe oder untypische Maschinenzyklen sofort identifizieren. ### Voraussetzungen * Mindestens eine Datenquelle, die Status-Events oder diskrete Maschinenzustände (z. B. Produktion, Störung, Stillstand) als fortlaufende Zeitreihe liefert. * Vorhandene Berechtigungen zur Konfiguration und Bearbeitung des Dashboards. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf die Schaltfläche **Einstellungen** auf dem noch nicht konfigurierten Widget-Block, um das Konfigurationsfenster zu öffnen. 2. Stelle sicher, dass du dich im Reiter **Daten** befindest, und klicke in das obere Eingabefeld unter **Wähle Datenquellen aus, die du visualisieren möchtest.**. 3. Wähle aus der Liste die gewünschte Status-Datenquelle aus. 4. Lege im Bereich **Wähle den Zeitraum, für den die Daten geladen werden sollen.** das gewünschte Zeitfenster fest. Gib dazu die Zahl ein (z. B. `1`) und wähle die Einheit aus dem Dropdown-Menü (z. B. **Woche**). 5. Wechsle ganz oben in den Reiter **Einstellungen**. 6. Klicke unten rechts im Konfigurationsfenster auf **Speichern**, um die Einrichtung abzuschließen und das Diagramm zu erstellen. --- ## 2. Erweiterte Einstellungen & Formatierung Die Benutzeroberfläche bietet zusätzliche Optionen, um die Gruppierung und Darstellung der Zustände präzise anzupassen: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Filter hinzufügen** | Kontrollkästchen unter der Datenquellenauswahl. | Ermöglicht es, die einbezogenen Statusmeldungen vorab nach bestimmten Kriterien einzuschränken. | | **Absolute Auswahl** | Tab im Bereich der Zeitraumeinstellungen. | Wechselt von einem rollierenden Zeitfenster zu einer festen Spanne mit konkretem Start- und Enddatum. | | **Daten aus der Zukunft laden** | Kontrollkästchen im Zeitraum-Menü. | Bezieht zukünftige Planungsdaten oder Soll-Zustände mit ein, falls diese im System vorhanden sind. | | **Randwerte ergänzen** | Kontrollkästchen im Zeitraum-Menü. | Vervollständigt die Zustandsdaten an den äußeren Grenzen des gewählten Zeitfensters, um unvollständige Übergänge zu vermeiden. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im Zeitraum-Menü. | Rundet den Abfragezeitraum automatisch auf die Grenzen der gewählten Zeiteinheit ab. | | **Zustände gruppieren** | Dropdown-Menü im Reiter **Einstellungen**. | Ermöglicht es, gleichartige Zustände nach übergeordneten Clustern oder Regeln zusammenzufassen. | | **Nach zusätzlichem Wert gruppieren (optional)** | Eingabefeld im Reiter **Einstellungen**. | Erlaubt die Einspeisung eines weiteren Parameters, um die Übergänge tiefergehend zu filtern. | | **Zustände anhand der ersten N Zeichen ihres Namens gruppieren** | Numerisches Eingabefeld (Standard: `0`). | Schneidet die Statusbezeichnungen nach einer bestimmten Zeichenlänge ab, um Strings mit variierenden Endungen automatisch zusammenzuführen (`0` nutzt den vollständigen Namen). | --- ## 3. Das fertige Dashboard-Ergebnis Nach dem Speichern wird ein kreisförmiges Chord-Diagramm auf dem Dashboard angezeigt. Die äußeren Segmente des Kreises repräsentieren die einzelnen Betriebszustände, während die farbigen, geschwungenen Verbindungsbänder (Chords) die Übergänge zwischen ihnen darstellen. Die Breite eines Bandes an der jeweiligen Basis signalisiert, wie häufig dieser spezifische Zustandswechsel im gewählten Zeitraum stattgefunden hat. Rechts neben dem Diagramm befindet sich eine interaktive Legende mit Filtermöglichkeiten. Über zwei Schnellauswahl-Schaltflächen lassen sich alle Zustände auf einmal aktivieren oder deaktivieren. Zudem kann jeder Zustand einzeln über ein Kontrollkästchen ein- oder ausgeblendet werden. Fährst du mit der Maus über eines der Verbindungsbänder (Hover-Effekt), blendet das Widget einen Tooltip ein, der die genaue Richtung des Übergangs (z. B. von *Produktion* zu *Stillstand*) sowie die exakte Anzahl der gezählten Wechsel anzeigt. > 💡 **Praxis-Tipp:** Wenn dein Diagramm durch zu viele seltene Kleinstübergänge unübersichtlich wird, nutze die Kontrollkästchen in der rechten Filter-Liste. Blende gezielt die normalen Standard-Zustände (wie *Produktion*) aus, um dich ausschließlich auf die Wechselbeziehungen zwischen verschiedenen Störungsarten und Rüstzeiten zu konzentrieren.