HAKOM PowerTSM® Documentation

Reporting Functions

Reporting-Functions

Überblick

Mit Hilfe der Templates können Reports sehr einfach und schnell in Excel erstellt werden. Die "Life Reporting"-Funktion ermöglicht das Positionieren von Zeitreihendaten an einem beliebigen Punkt des Reports zur individuelle Bewertung. Zeitreihendaten können durch das Nutzen der Funktionen unabhängig vom typischen TSM-Format in Excel ausgelesen.

Funktionsbeschreibung

Auf die Reporting-Functions des TSM kann - wie auf alle Excel Funktionen - über den Funktionsassistenten zugegriffen werden. Unter der Kategorie "TSM" können die drei Funktionen ausgewählt werden:

reporting-functions-de.jpg

TSM_ReadColumnValues

Diese Funktion ist die ausführlichste der TSM Reporting-Functions. Sie stellt eine Erweiterung der Funktion TSM_ReadTimeSeriesValues dar und liest Zeitreihen in Excel aus, kann aber auch Formeln wie peak oder max verarbeiten.

Reporting_Function_Argumente.png

Feld

Beschreibung

DataSource

Name der DB-Verbindung

Applications

Name des TSM Plugins

P1-P5

Parameter, die in Excel in den Zellen C10-C14 stehen (P1=C10...P5=C14)

FromDate

Startdatum im Format TT.MM.YYYY

ToDate

Enddatum im Format TT.MM.YYYY

Interval

Interval, in dem die Werte ausgelesen werden sollen:

Halbjahr = -10

Jahr = -8

Quartal = -7

Monat = -6

Woche = -5

Tag = -4

Stunde = -3

Halbe Stunde = -2

Viertel Stunde = -1

Unit

Einheit, in der die Zeitreihe ausgelesen werden soll. Soll die Einheit von der DB geladen werden, muss "DB" eingegeben werden. Wird ein anderer Wert eingegeben, wird die Einheit (wenn möglich) automatisch konvertiert (z.B.: von KWH auf GWH).

ShowMissingValues

Sollen fehlende Werte angezeigt werden? (WAHR = ja)

Horizontal

Werte können horizontal oder vertikal eingefügt werden. (WAHR = horizontal, FALSCH = vertikal)

ShowDates

Sollen Zeitstempel zu den Werten angezeigt werden? Wenn ja (=True) ist die Ausgabe nun zweidimensional. Die erste Spalte zeigt den Zeitstempel zu den Daten, die nun in der zweiten Spalte angezeigt werden. Das Format für die Zeitstempel kann in Excel/Spreadsheetgear umgestellt werden.

Beispiel Auslesen Werte von Versionszeitreihen

Bsp_Report_Functions.xlsx

image2019-6-4_13-18-2.png

image2019-6-4_13-16-22.png

Screenshot 2025-01-08 102642.png

Screenshot 2025-01-08 102709.png


Mehrere Intervalle nebeneinander anzeigen

Es ist möglich mehrere Intervalle (z.B.: Januar, Februar, März) nebeneinander anzeigen zu lassen, egal ob horizontal oder vertikal. Dazu gibt man eine TSM-Funktion in einer Zelle an und kopiert sie vertikal oder horizontal. Danach wählt man alle Zellen aus, in denen Werte eingetragen werden sollen, die Funktion einfügen und Strg+Umschalt+Eingabe drücken. Das erzeugt ein Array, das sich automatisch an die Intervalle der Zellen anpasst. 

Achtung: Wenn die Zellen horizontal angelegt werden sollen, muss der Wert  "Horizontal" in der Reporting-Function "WAHR" sein. Sollen sie vertikal angelegt werden muss der Wert "FALSCH" sein.

TSM_ReadTimeSeriesValues

Eine kürzere Version der TSM_ReadColumnValues-Funktion bei der die Parameter P1-P5 fehlen.

Bsp.:

image2019-6-4_13-13-43.png

image2019-6-4_13-14-14.png


Reporting Functions in TSM+

Um solch eine Funktion in TSM+ auszugeben, die über mehrere Zellen geht, muss der gesamte Bereich, in dem die Daten sein sollen, ausgewählt werden. Um die Formel einzufügen, bearbeiten oder zu löschen, muss dann (Fn+) f2 gedrückt werden, um das Feld mit der tatsächlichen Formel auszuwählen. Nach abgeschlossener Bearbeitung muss mit Str + Shitft + Enter bestätigt werden. 

Bevor der Wert der "Horizontal" Flag geändert werden kann, muss die Formel im alten Bereich gelöscht und im neuen angelegt werden. 

Um die Zeitstempel der "ShowDates" Flag anzuzeigen, müssen zwei Spalten oder Zeilen ausgewählt werden.

Das Datenformat kann so geändert werden:

Spalte/Zeile auswählen
Rechts-click > Range Explorer > Number Format > Date