# Energiedatentabelle Widget type: `opendash-widget-table-energy-step` · Plugin: `@opendash/plugin-highcharts`  ### Beschreibung Das Widget **Energiedatentabelle** dient der strukturierten, tabellarischen Gegenüberstellung und Aggregation verschiedener verbrauchs- und leistungsrelevanter Messwerte. Anwender profitieren von einer übersichtlichen, zeitlich flexibel gruppierbaren Darstellung, die es ermöglicht, Kennzahlen wie Wirkleistung und Wirkarbeit direkt miteinander zu vergleichen und langfristige Verbrauchstrends aufzudecken. ### Voraussetzungen * Mindestens ein oder mehrere zeitreihenbasierte Energiedatenpunkte (z. B. Telemetriedaten für Wirkleistung, Wirkarbeit oder andere Verbrauchswerte) im System. * Historische Datenbestände im System für den auszuwählenden Betrachtungszeitraum. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf der Dashboard-Kachel des noch unkonfigurierten Widgets auf die Schaltfläche **Einstellungen**. 2. Klicke im Reiter **Daten** in das Eingabefeld **Auswahl von einem Daten Item** direkt unter der Sektion „Wähle Datenquellen aus, die du Visualisieren möchtest.“. 3. Navigiere durch deine Gerätestruktur und wähle die gewünschten Energiedatenpunkte aus. Bestätige deine Auswahl anschließend mit einem Klick auf **Schließen**. 4. Definiere im Bereich „Wähle den Zeitraum, für den die Daten geladen werden sollen.“ zwingend den zeitlichen Rahmen, indem du entweder eine **Relative Auswahl** (z. B. `1` **Jahr**) oder eine **Absolute Auswahl** festlegst. Diese Angabe ist zwingend erforderlich, damit das System die Datenhistorie korrekt abfragt. 5. Wechsle im oberen Bereich des Konfigurationsfensters in den Reiter **Einstellungen**. 6. Lege für jeden ausgewählten Datenpunkt zwingend die gewünschte Aggregationsmethode fest, indem du die entsprechende Schaltfläche (z. B. **Durchschnitt**, **Summe**, **Minimalwerte**, **Maximalwerte** oder **Differenz zwischen erstem & letztem Wert**) anklickst. 7. Klicke unten rechts auf **Speichern**, um die Konfiguration zu übernehmen und die Energiedatentabelle auf deinem Dashboard zu erstellen. --- ## 2. Erweiterte Einstellungen & Formatierung Über das Konfigurationsmenü kannst du mathematische Feinabstimmungen vornehmen und steuern, wie tief die zeitliche Staffelung der Tabelle reicht: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Relative Auswahl** | Zeitbereichs-Option im Reiter Daten. | Lädt Daten flexibel anhand eines rollierenden Zeitfensters relativ zum aktuellen Zeitpunkt (z. B. das letzte Jahr). | | **Absolute Auswahl** | Zeitbereichs-Option im Reiter Daten. | Fixiert die Datenabfrage auf ein fest definiertes Start- und Enddatum im Kalender. | | **Daten aus der Zukunft laden** | Kontrollkästchen im unteren Datenbereich. | Bezieht zukünftige Plan-, Prognose- oder Soll-Werte in die Tabelle mit ein, sofern diese verfügbar sind. | | **Randwerte ergänzen** | Kontrollkästchen im unteren Datenbereich. | Schließt zeitliche Lücken an den Rändern des Abfragezeitraums automatisch mit den jeweils angrenzenden Datenwerten. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im unteren Datenbereich. | Rundet den ausgewählten Abfragezeitraum exakt auf die Grenzen der eingestellten Zeiteinheit ab. | | **Sonstige Einstellungen** | Ausklappbares Menü im Datenbereich. | Ermöglicht die Aktivierung einer automatischen, regelmäßigen Aktualisierung der angezeigten Tabellenwerte. | | **Wähle eine Daten Aggregation** | Mathematische Optionen je Datenpunkt im Reiter Einstellungen. | Bestimmt pro Spalte das Berechnungsverfahren (z. B. **Durchschnitt** für kontinuierliche Leistungswerte oder **Differenz zwischen erstem & letztem Wert** für Zählerstände). | | **Nachkommastellen anzeigen** | Schieberegler im Reiter Einstellungen. | Aktiviert oder deaktiviert die Anzeige von Dezimalstellen für die numerischen Werte in den Spalten. | | **Nur Monate** | Schieberegler im Reiter Einstellungen. | Komprimiert die Tabellenzeilen standardmäßig auf eine reine Monatsübersicht, ohne tiefere Unterbaufunktion. | --- ## 3. Das fertige Dashboard-Ergebnis Nach dem erfolgreichen Speichern stellt das Widget die aggregierten Daten in einer interaktiven, hierarchischen Tabelle dar. In der Hauptansicht sind die Daten übersichtlich nach übergeordneten Zeiträumen (z. B. Jahren oder Monaten) gruppiert, wobei die Spalten die exakten Namen der konfigurierten Datenpunkte sowie die angewendete Aggregationsart widerspiegeln. Du kannst mit der Tabelle interagieren, indem du auf den kleinen Pfeil (`>`) links neben einem Zeitraum (z. B. neben einem bestimmten Monat) klickst. Dadurch klappt sich die Tabelle dynamisch auf und legt die detaillierten Tageswerte für diesen Zeitraum offen. Ein erneuter Klick auf den Pfeil schließt die Detailansicht wieder und sorgt für ein aufgeräumtes Dashboard. > 💡 **Praxis-Tipp:** Nutze für Zählerstände (wie die Wirkarbeit in kWh) immer die Aggregationsoption **Differenz zwischen erstem & letztem Wert** und für die Auslastung (Wirkleistung in kW) den **Durchschnitt**. Auf diese Weise siehst du beim Aufklappen eines Monats auf einen Blick sowohl den realen Energieverbrauch in diesem Zeitraum als auch die durchschnittlich abgerufene Leistung.