# Zustands-Statistik Widget type: `opendash-widget-hc-states` · Plugin: `@opendash/plugin-highcharts` ![State Overview preview](../../../../../_attachments/opendash/widgets/assets/widget-previews/hc-states.png) ### Beschreibung Das **Zustands-Statistik Widget** wertet die Häufigkeit oder Dauer von verschiedenen Anlagenzuständen (z. B. Produktion, Stillstand oder Störung) über einen frei wählbaren Zeitraum aus. IoT-Anwender erhalten dadurch eine übersichtliche statistische Aufarbeitung, um Engpässe in der Produktion oder wiederkehrende Fehlermuster auf einen Blick zu identifizieren. ### Voraussetzungen * Mindestens eine Datenquelle, die diskrete Zustandsdaten oder Status-Events (z. B. Betriebsmodi, Fehlercodes oder Maschinenzustände) liefert. * Die erforderlichen Rechte auf dem Dashboard, um Widgets hinzuzufügen und zu bearbeiten. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf die Schaltfläche **Einstellungen** auf dem noch nicht konfigurierten Widget-Block, um in das Konfigurationsmenü zu gelangen. 2. Klicke im Reiter **Daten** in das obere Eingabefeld unter **Wähle Datenquellen aus, die du visualisieren möchtest.**. 3. Wähle aus der Liste die gewünschte Status-Variable aus. 4. Bestimme im Bereich **Wähle den Zeitraum, für den die Daten geladen werden sollen.** das gewünschte Auswertungsfenster (standardmäßig ist hier `1` **Woche** im Modus **Relative Auswahl** eingestellt). 5. Wechsle ganz oben in den Reiter **Einstellungen**. 6. Wähle im Bereich **Visualisierungsart festlegen** das gewünschte Diagramm-Format aus (z. B. **Blockdiagramm**). 7. Klicke unten rechts im Konfigurationsfenster auf **Speichern**, um die Statistik auf deinem Dashboard zu erstellen. --- ## 2. Erweiterte Einstellungen & Formatierung Die Benutzeroberfläche bietet zahlreiche Optionen, um die Datenbasis einzugrenzen und die visuelle Struktur der Statistik anzupassen: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Filter hinzufügen** | Kontrollkästchen direkt unter der Datenquellenauswahl. | Ermöglicht das Filtern der Status-Events nach bestimmten Mustern oder Bedingungen vor der Visualisierung. | | **Absolute Auswahl** | Schaltfläche im Bereich der Zeitraumeinstellungen. | Fixiert das Auswertungsfenster auf einen statischen Zeitraum mit festem Start- und Enddatum. | | **Daten aus der Zukunft laden** | Kontrollkästchen im Zeitraum-Menü. | Bezieht im Voraus geplante Wartungsfenster oder Soll-Zustände mit ein, sofern diese im System hinterlegt sind. | | **Randwerte ergänzen** | Kontrollkästchen im Zeitraum-Menü. | Vervollständigt unvollständige Statusblöcke an den exakten Zeitgrenzen der Abfrage. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im Zeitraum-Menü. | Rundet das gewählte Zeitfenster automatisch passend auf die Grenzen der verwendeten Zeiteinheit ab. | | **Automatisch Aktualisieren** | Kontrollkästchen unter den sonstigen Einstellungen. | Aktualisiert die Statistik in regelmäßigen Abständen selbstständig auf dem Dashboard. | | **Kuchendiagramm** | Option unter **Visualisierungsart festlegen**. | Zeigt die Verteilung der Zustände als Kreissegmente anstelle eines horizontalen Balken- oder Blockdiagramms an. | | **Gruppiere Zustand nach** | Dropdown-Menü im Einstellungsreiter. | Definiert das mathematische Aggregationskriterium für die Zustände (z. B. basierend auf der reinen Anzahl an Vorkommnissen). | | **Zahlenwerte in Blöcke der angegebenen Größe gruppieren** | Numerisches Eingabefeld (Standard: `0`). | Erlaubt es, diskrete Statuswerte oder IDs in logische Wertebereiche zusammenzufassen (`0` deaktiviert die Gruppierung). | | **Zeige Legende unter Diagramm** | Kontrollkästchen im unteren Einstellungsbereich. | Blendet eine zusätzliche, strukturierte Namenslegende unterhalb der Grafik ein. | --- ## 3. Das fertige Dashboard-Ergebnis Nach dem Speichern visualisiert das Widget die Zustände in einer absteigend sortierten Rangliste. Jeder Zustand (wie z. B. *Stillstand*, *Produktion* oder *Störung*) wird auf einer eigenen horizontalen Linie mit einem farbigen Balken dargestellt. Neben dem Namen des Zustands wird direkt die absolute Häufigkeit (z. B. `446`) sowie der prozentuale Anteil am Gesamtzeitraum (z. B. `44.2%`) ausgegeben. Das Widget reagiert direkt auf Interaktionen: Fährst du mit der Maus über einen der Balken, hebt sich dieser visuell hervor, um die Lesbarkeit einzelner Zeilen in komplexen Diagrammen zu erleichtern. > 💡 **Praxis-Tipp:** Nutze die Visualisierung, um versteckte Zeitfresser zu eliminieren. Zeigt das Diagramm beispielsweise eine unerwartet hohe Anzahl für den Zustand "Störung (Material)", ist dies ein klarer Indikator dafür, die logistische Lieferkette oder die Materialzufuhr an der Maschine genauer zu überprüfen.