# Aggregation historischer Werte Widget type: `opendash-widget-hc-aggregate-multi` · Plugin: `@opendash/plugin-openware`  ### Beschreibung Das Widget **Aggregation historischer Werte** fasst komplexe, historische IoT-Zeitreihendaten über wählbare Zeiträume mathematisch zusammen und stellt sie übersichtlich in einem frei konfigurierbaren Graphen dar. Anwender können dadurch langfristige Trends analysieren, ohne von einzelnen, unaufbereiteten Rohdatenpunkten überfordert zu werden. ### Voraussetzungen * Mindestens ein aktiver Datenpunkt oder eine kontinuierliche Datenquelle (z. B. historische Energie- oder Verbrauchswerte) im System. * Gespeicherte historische Datenbestände für den gewünschten Abfragezeitraum. --- <h2>1. Konfiguration und Einrichtung</h2> 1. Klicke auf der Dashboard-Kachel des noch unkonfigurierten Widgets auf die Schaltfläche **Einstellungen**. 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. Navigiere durch deine Gerätestruktur und wähle die gewünschten numerischen Variablen aus (z. B. den Verbrauch mehrerer Maschinen), um sie der Konfiguration hinzuzufügen. Bestätige die Auswahl mit einem Klick auf **Schließen**. 4. Lege im Bereich **Wähle den Zeitraum, für den die Daten geladen werden sollen.** das Zeitintervall fest (z. B. eine relative Auswahl von `1` **Woche**). Dieser Schritt ist zwingend erforderlich, um das historische Zeitfenster für die Aggregationsbasis zu definieren. 5. Wechsle ganz oben in den Reiter **Einstellungen**. 6. Wähle im Bereich **Datenaggregationsoptionen** unter der Frage *„Bitte wählen Sie aus in welchem Intervall Daten zusammengefasst werden sollen“* die gewünschte mathematische Berechnungsart (z. B. **Summe** oder **Durchschnitt**). Dieser Schritt ist zwingend erforderlich. 7. Scrolle im selben Bereich weiter nach unten zu *„Wähle eine Daten Aggregation“* und bestimme das zeitliche Aggregationsintervall (z. B. **Stunde**, **Tag** oder **Woche**). Auch dieser Schritt ist zwingend erforderlich, um festzulegen, in welchen Schritten die Werte komprimiert werden. 8. Klicke unten rechts auf die Schaltfläche **Speichern**, um die Konfiguration zu übernehmen und das aggregierte Diagramm auf dem Dashboard zu erstellen. --- <h2>2. Erweiterte Einstellungen & Formatierung</h2> Über die erweiterten Steuerungselemente lassen sich die zeitliche Genauigkeit der mathematischen Transformation und das Design des Graphen anpassen: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Relative Auswahl** | Registerkarte bei den Zeitraum-Optionen. | Wechselt zu einem flexiblen, dynamisch rollierenden Zeitfenster basierend auf dem aktuellen Zeitpunkt (z. B. letzte Woche). | | **Absolute Auswahl** | Registerkarte bei den Zeitraum-Optionen. | Fixiert die historische Datenabfrage auf ein fest definiertes Start- und Enddatum im Kalender. | | **Daten aus der Zukunft laden** | Kontrollkästchen im Daten-Menü. | Ermöglicht es, prognostizierte Werte oder zukünftige Soll-Vorgaben anzuzeigen, sofern diese im System hinterlegt sind. | | **Randwerte ergänzen** | Kontrollkästchen im Daten-Menü. | Füllt fehlende Datenpunkte an den äußeren Grenzen des Zeitraums auf, um eine lückenlose Kurve zu gewährleisten. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im Daten-Menü. | Rundet den Abfragezeitraum automatisch exakt auf die Grenzen der gewählten Zeiteinheit ab. | | **Sonstige Einstellungen (Automatisch Aktualisieren)** | Ausklappbarer Bereich im Daten-Reiter. | Aktualisiert die Visualisierung auf dem Dashboard in regelmäßigen Abständen selbstständig mit neuen Werten. | | **Visualisierungsart festlegen** | Auswahlraster im Einstellungs-Reiter. | Ändert die grafische Darstellung des Diagramms (z. B. zwischen Standard-Liniendiagramm, gekurvtem Liniendiagramm, Flächendiagramm, Punktwolke oder Blockdiagramm). | | **Interaktionsmöglichkeiten** | Ausklappbarer Bereich im Einstellungs-Reiter. | Erlaubt das Ein- oder Ausblenden von unterstützenden Elementen wie einer Legende unter dem Diagramm oder interaktiven Tooltips bei Mausberührung. | | **Farboptionen** | Farbwähler im Einstellungs-Reiter. | Ermöglicht es, den einzelnen Datenreihen oder aggregierten Graphen individuelle Farben zuzuweisen. | --- <h2>3. Das fertige Dashboard-Ergebnis</h2> Nach dem erfolgreichen Speichern stellt das Widget die historischen Datenreihen in der gewählten Diagrammform dar. Am oberen Rand des Widgets befindet sich eine übersichtliche Legende, die die exakten Namen der aggregierten Datenreihen (z. B. `avg_hour_Wirkleistung (Gesamt)`) abbildet. Die Datenpunkte sind nicht mehr als unruhige Rohwerte sichtbar, sondern fließen in sauberen, mathematisch zusammengefassten Intervallen über die Zeitachse. Wenn du mit der Maus über den Graphen fährst (Hover-Effekt), blendet sich ein interaktives Infofenster ein. Dieses zeigt dir für den jeweiligen Aggregationsabschnitt den präzisen berechneten Wert sowie den genauen Zeitraum an, sodass Ausreißer oder Perioden mit besonders hohen Summenwerten sofort abgelesen werden können. > 💡 **Praxis-Tipp:** Nutze die Kombination aus der Aggregationsoption **Summe** und dem Intervall **Tag**, um den absoluten täglichen Gesamtverbrauch deiner Anlagen über mehrere Wochen hinweg miteinander zu vergleichen. Dadurch lassen sich wöchentliche Betriebsmuster oder untypische Mehrverbräuche an Wochenenden extrem schnell lokalisieren.