# Tabellarische Übersicht aggregierter Daten
Widget type: `opendash-widget-table-aggregate` · Plugin: `@opendash/plugin-openware`

### Beschreibung
Das Widget **Tabellarische Übersicht aggregierter Daten** fasst historische Zeitreihen mathematisch präzise zusammen und gibt sie in einer strukturierten Listenform aus. Anwender erhalten dadurch die Möglichkeit, verschiedene Messgrößen über frei wählbare Zeitintervalle hinweg zu komprimieren, um Verbräuche, Spitzenwerte oder Mittelwerte im direkten Vergleich einsehen zu können.
### Voraussetzungen
* Mindestens eine oder mehrere historische Datenquellen (z. B. Telemetriedaten für Leistung, Zählerstände oder Verbräuche) im System.
* Gespeicherte historische Datenbestände für den gewählten Abfragezeitraum.
---
## 1. Konfiguration und Einrichtung
1. Klicke auf der Dashboard-Kachel des noch leeren Widgets auf die Schaltfläche **Einstellungen**.
2. Klicke im Reiter **Daten** in das obere Auswahlfeld unter „Wähle Datenquellen aus, die du Visualisieren möchtest.“.
3. Navigiere durch deine Gerätestruktur, wähle die gewünschten numerischen Variablen aus und bestätige dies mit einem Klick auf **Schließen**.
4. Wähle im darunter liegenden Bereich „Wähle den Zeitraum, für den die Daten geladen werden sollen.“ den gewünschten Zeitrahmen aus (wähle hierzu entweder die **Relative Auswahl** wie z. B. `1` **Tag** oder die **Absolute Auswahl**). Dieser Schritt ist zwingend erforderlich.
5. Wechsle ganz oben in den Reiter **Einstellungen**.
6. Bestimme im Bereich „Bitte wählen Sie aus in welchem Intervall Daten zusammengefasst werden sollen“ das zeitliche Intervall der Aggregation (z. B. **Stunden**).
7. Lege direkt darunter im Bereich „Wähle eine Daten Aggregation“ für jede deiner ausgewählten Datenquellen die mathematische Funktion fest (z. B. **Durchschnitt** oder **Summe**), indem du die entsprechende Option anklickst.
8. Klicke unten rechts auf die Schaltfläche **Speichern**, um die Konfiguration zu übernehmen und das Widget auf deinem Dashboard zu aktivieren.
---
## 2. Erweiterte Einstellungen & Formatierung
Über die Konfigurationsoberfläche lassen sich sowohl die Abfrageparameter als auch die mathematischen Darstellungen im Detail verfeinern:
| Option | Beschreibung | Funktion |
| :--- | :--- | :--- |
| **Relative Auswahl** | Registerkarte bei den Zeitraum-Optionen im Daten-Reiter. | Aktiviert ein rollierendes, dynamisches Zeitfenster basierend auf der aktuellen Systemzeit. |
| **Absolute Auswahl** | Registerkarte bei den Zeitraum-Optionen im Daten-Reiter. | Fixiert das historische Abfragefenster auf ein festes Start- und Enddatum im Kalender. |
| **Daten aus der Zukunft laden** | Kontrollkästchen im unteren Datenbereich. | Ermöglicht die Einbindung von prognostizierten oder geplanten zukünftigen Werten, falls im System vorhanden. |
| **Randwerte ergänzen** | Kontrollkästchen im unteren Datenbereich. | Füllt eventuell fehlende Datenpunkte an den äußeren Grenzen des Zeitraums automatisch auf. |
| **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im unteren Datenbereich. | Rundet das gewählte Zeitfenster präzise auf die Grenzen der eingestellten Zeiteinheit ab. |
| **Sonstige Einstellungen** | Ausklappbarer Bereich ganz unten im Daten-Reiter. | Erlaubt die Aktivierung einer automatischen Intervall-Aktualisierung für die Tabellenwerte. |
| **Zeitintervall-Tasten** | Auswahlknöpfe (**Sekunden**, **Minuten**, **Stunden**, **Tage**, **Wochen**, **Monate**, **Jahre**) im Einstellungs-Reiter. | Legt fest, in welchen zeitlichen Abschnitten die Datenpunkte mathematisch zusammengefasst werden. |
| **Aggregationsfunktionen** | Auswahltasten (**Summe**, **Durchschnitt**, **Minimalwerte**, **Maximalwerte**, **Anzahl**, **Differenz Min & Max**) je Datenpunkt. | Bestimmt die mathematische Rechenmethode, mit der die Rohwerte des jeweiligen Kanals komprimiert werden. |
| **Name der Datenquelle in Spaltenname anzeigen** | Schieberegler im unteren Einstellungsbereich. | Blendet den übergeordneten Gerätenamen zusätzlich zum Variablennamen in der Spaltenüberschrift ein. |
| **Letzten gültigen Wert anzeigen...** | Schieberegler im unteren Einstellungsbereich. | Vermeidet leere Tabellenzellen bei unregelmäßigen Datenströmen, indem der letzte bekannte Wert fortgeschrieben wird. |
---
## 3. Das fertige Dashboard-Ergebnis
Nach dem Speichern präsentiert sich das Widget als übersichtliche, mehrspaltige Tabelle auf deinem Dashboard. Die erste Spalte listet fortlaufend die exakten Zeitstempel (z. B. im Stunden-Takt) auf. In den folgenden Spalten werden die berechneten Werte für deine ausgewählten Datenpunkte exakt nach der zugewiesenen Methode (wie dem berechneten Stunden-Durchschnitt oder der Stunden-Summe) ausgegeben.
Über die Seitennavigation am unteren rechten Rand der Tabelle kannst du komfortabel durch die historischen Seiten blättern. Das Widget eignet sich ideal, um komplexe Datenreihen schnell lesbar zu machen und Abweichungen im zeitlichen Verlauf sofort zu identifizieren.
> 💡 **Praxis-Tipp:** Kombiniere dieses Widget mit der Aggregationsfunktion **Maximalwerte** im Intervall **Tage**, um im Handumdrehen eine übersichtliche Tabelle der täglichen Spitzenlasten deines Betriebs zu erstellen und teure Peak-Zeiten aufzuspüren.