# Sunburst Visualisierung Widget type: `opendash-widget-ow-aggregate-sunburst` · Plugin: `@opendash/plugin-openware`  ### Beschreibung Die **Sunburst-Visualisierung** stellt hierarchische Datenstrukturen in Form eines kreisförmigen Diagramms dar, das sich von innen nach außen aufbaut. IoT-Anwender können damit verschachtelte Verhältnisse und Anteilsverteilungen – wie etwa den Energieverbrauch einzelner Hallen aufgeteilt auf spezifische Maschinengruppen – intuitiv über mehrere Ebenen hinweg erfassen. ### Voraussetzungen * Mindestens ein kontinuierlicher Datenpunkt oder eine Reihe von aggregierbaren Datenströmen (z. B. Verbrauchswerte, Kosten oder Stückzahlen). * Eine logische oder strukturelle Zuordnung der Datenpunkte im System, um eine sinnvolle hierarchische Aufteilung im Diagramm zu ermöglichen. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf dem neu hinzugefügten Widget-Platzhalter direkt auf die Schaltfläche **Einstellungen**. 2. Definiere im Reiter **Daten** das gewünschte Auswertungszeitfenster. Wähle dazu beispielsweise **Relative Auswahl**, trage den Wert `1` ein und belasse das Dropdown-Feld auf **Woche**. 3. Wechsel im oberen Bereich des Konfigurationsfensters in den Reiter **Einstellungen**. 4. Klicke auf das **Plus-Zeichen (`+`)** unter dem Symbol, um eine neue Datengruppe für die innerste Ebene der Hierarchie anzulegen. 5. Fahre mit der Maus über das neu erstellte Feld `New Group`, klicke auf das **Stift-Symbol (Bearbeiten)** und gib einen passenden Oberbegriff ein (z. B. `Unternehmen`). 6. Klicke ganz rechts in der Zeile auf den **Pfeil nach unten**, um die Detailkonfiguration der Gruppe auszuklappen. 7. Klicke auf das **Plus-Zeichen (`+`)** in der Zeile **Keine Datenpunkt(e)**, um die Zuweisung der Datenquellen zu öffnen. 8. Setze Häkchen bei den Datenpunkten, die in diese Ebene einfließen sollen (z. B. `Verbrauch (Maschine A)`, `Verbrauch (Maschine B)` und `Verbrauch (Maschine C)`), und klicke anschließend auf **Schließen**. 9. Klicke unten rechts im Fenster auf **Speichern**, um die Konfiguration zu übernehmen und das Widget zu erstellen. --- ## 2. Erweiterte Einstellungen & Formatierung Zusätzlich zu den Basisschritten bietet das Konfigurationsmenü Optionen in den Reitern **Daten** und **Einstellungen**, um die Filterung, Aggregation und Darstellung feinzutunen: | Option | Beschreibung | Funktion | | :----------------------------------------------------- | :----------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | | **Relative Auswahl** | Zeitbereichs-Option im Reiter Daten. | Berechnet die Anteile flexibel anhand eines mitlaufenden Zeitfensters (z. B. letzte 24 Stunden). | | **Absolute Auswahl** | Zeitbereichs-Option im Reiter Daten. | Fixiert die Auswertung auf ein festes historisches Start- und Enddatum. | | **Daten aus der Zukunft laden** | Kontrollkästchen im unteren Datenbereich. | Bezieht Prognosewerte oder Planwerte in das Diagramm ein, sofern diese im System vorliegen. | | **Randwerte ergänzen** | Kontrollkästchen im unteren Datenbereich. | Schließt zeitliche Lücken an den Rändern des Intervalls mit den jeweils angrenzenden Datenwerten. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im unteren Datenbereich. | Rundet das Auswertungsintervall automatisch auf die exakten Grenzen der gewählten Zeiteinheit ab. | | **Sonstige Einstellungen / Automatisch Aktualisieren** | Ausklappbarer Menüpunkt im Datenbereich. | Aktiviert das automatische Nachladen der Messwerte für eine Echtzeit-Aktualisierung des Diagramms. | | **Hierarchie der Daten festlegen** | Dropdown-Menü im Reiter Einstellungen. | Schaltet um zwischen einer benutzerdefinierten Struktur (**Custom**) und bestehenden Systemhierarchien. | | **Verfahrensauswahl (z. B. Summe)** | Dropdown-Feld innerhalb einer Gruppe. | Bestimmt die mathematische Logik (z. B. Aufsummierung), mit der die Werte der untergeordneten Ebenen zusammengefasst werden. | | **Keine Untergruppe(n)** | Plus-Schaltfläche innerhalb einer Gruppe. | Erzeugt eine weitere, nachgelagerte Tortebebene nach außen, um tiefere Verschachtelungen abzubilden. | | **Namen der Datenpunkte kürzen** | Kontrollkästchen im Bereich Bezeichnungen formatieren. | Aktiviert das automatische Abschneiden von langen Datenpunktnamen für eine bessere Lesbarkeit. | | **Kürzung am Anfang bis / am Ende bis** | Text-Eingabefelder unter der Namenskürzung. | Legt fest, wie viele Zeichen vom Anfang oder Ende der Bezeichnung entfernt werden sollen. | --- ## 3. Das fertige Dashboard-Ergebnis Sobald die Konfiguration gespeichert ist, erscheint ein ringförmiges, mehrschichtiges Kuchendiagramm auf dem Dashboard. Der innerste Kreis stellt die oberste Ebene der Struktur dar (z. B. das gesamte Unternehmen). Die Segmente, die sich ringförmig nach außen hin anschließen, brechen diesen Gesamtwert in die jeweils zugewiesenen Unterkategorien oder einzelnen Maschinen auf. Die Größe eines Segments entspricht dabei proportional seinem Anteil am Gesamtwert. Wenn du mit dem Mauszeiger über ein Segment fährst, öffnet sich ein Infofeld (Tooltip). Dieses zeigt dir den genauen Namen des Datenpunkts, den Absolutwert sowie den prozentualen Anteil an, den dieses spezifische Segment an der übergeordneten Ebene ausmacht. > 💡 **Praxis-Tipp:** Nutze die Sunburst-Visualisierung idealerweise für eine detaillierte Kosten- oder Verbrauchsanalyse. Durch die Schachtelung von innen nach außen siehst du nicht nur, welcher Bereich die meisten Ressourcen verbraucht, sondern zeitgleich auch, welche einzelnen Unterkomponenten innerhalb dieses Bereichs die Hauptverursacher sind.