Reporting Functions
Überblick
Die Reporting-Functions sind eine Sammlung von Funktionen die als Excel Formeln zur Verfügung stehen. Sie können in allen Excel Dateien eingebunden werden, auch wenn es sich dabei um keine TSM Templates handelt.
Mithilfe dieser Funktionen ist es möglich eigene Reports und Datenblätter zu erstellen und Daten aus Zeitreihen direkt in der gewünschten Form einzubinden.
Folgende Funktionen stehen zur Verfügung:
| Funktionsname | Beschreibung |
|---|---|
| ReadTimeSeriesValues | Liest Werte einer Zeitreihe entsprechend der wesentlichsten Parameter. |
| ReadColumnValues | Liest Zeitreihendaten via spezifischer Plug-ins aus. |
| ReadSetting | Liest den Wert eines TSM Settings aus der HAKOM.Config Konfigurationsdatei aus. |
Die Reporting Functions stehen als Excel Formeln zur Verfügung und können über den Excel Funktionsassistenten eingefügt werden:
Beispiel
Im hier ersichtlichen Beispiel werden die aktuellen Zeitreihendaten in vorbereiteten Tabellen geladen und die darauf aufbauenden Diagramme automatisch erzeugt.
TSM_ReadTimeSeriesValues
Die Funktion ReadTimeSeriesValues stellt die grundlegende Funktionalität Zeitreihendaten zu laden zur Verfügung.
Die folgenden Parameter stehen zur Verfügung:
| Parameter | Beschreibung | Datentyp |
|---|---|---|
| DataSource | Name der Datenbankverbindung über welche die Zeitreihendaten geladen werden. | String |
| Name | Name der Zeitreihe, welche die Daten enthält. | String |
| FromDate | Beginn des Auslesezeitraums. | Datumsstempel ("TT.MM.JJJJ") |
| ToDate | Ende des Auslesezeitraums. | Datumsstempel ("TT.MM.JJJJ") |
| Interval | Intervall in welchem die Zeitreihendaten geladen werden. | Numerisch
|
| Unit | Einheit in welcher die Zeitreihendaten geladen werden. | String (per "DB" wird die Einheit aus der Datenbank übernommen) |
| ShowMissingValues | Steuert ob fehlende Zeitreihendaten angezeigt werden. | Boolean (WAHR/FALSCH) |
| Horizontal | Steuert ob die Zeitreihendaten in horizontaler oder vertikaler Form eingefügt werden. | Boolean (WAHR/FALSCH) |
Die geladenen Daten werden in die Vorlage in Form eines Excel Arrays eingefügt (sowohl horizontale als auch vertikale Darstellung wird unterstützt, siehe Parameter "Horizontal"). Die Länge des Arrays ergibt sich aus dem Auslesezeitraum und dem konfigurierten Intervall. Die Daten eines Intervallschritts werden jeweils in eine Zelle geschrieben.
TSM_ReadColumnValues
Diese Funktion stellt eine Erweiterung der Funktion TSM_ReadTimeSeriesValues dar und unterstützt zusätzlich das Auslesen von Zeitreihendaten via spezifischer Plug-ins.
| Parameter | Beschreibung | Datentyp |
|---|---|---|
| DataSource | Name der Datenbankverbindung über welche die Zeitreihendaten geladen werden. | String |
| Application | Name des TSM Plug-ins | String |
| P1-P5 | Parameter, die in den jeweiligen Plug-in spezifischen TSM Templates in den Zellen C10-C14 eingetragen sind (P1=C10...P5=C14) Mehr Informationen zu den in diesen Zellen enthaltenen Parametern und ihrer Funktion sind hier zu finden: Zeitreihen auslesen, Lesen in Excel | |
FromDate | Beginn des Auslesezeitraums. | Datumsstempel ("TT.MM.JJJJ") |
| ToDate | Ende des Auslesezeitraums. | Datumsstempel ("TT.MM.JJJJ") |
| Interval | Intervall in welchem die Zeitreihendaten geladen werden. | Numerisch
|
| Unit | Einheit in welcher die Zeitreihendaten geladen werden. | String (per "DB" wird die Einheit aus der Datenbank übernommen) |
| ShowMissingValues | Steuert ob fehlende Zeitreihendaten angezeigt werden. | Boolean (WAHR/FALSCH) |
| Horizontal | Steuert ob die Zeitreihendaten in horizontaler oder vertikaler Form eingefügt werden. | Boolean (WAHR/FALSCH) |
Beispiel
Mithilfe dieser Funktion ist es möglich Audit- oder Notierungsstände von Zeitreihen auszulesen. Dafür wird in den jeweils gewünschten Parameter-Feldern der gewünschte Audit- oder Notierungsstempel eingetragen (Kombinationen sind möglich) inklusive der Information ob die Stände exakt oder nicht exakt geladen werden sollen. Mehr Informationen zum Arbeiten mit Audit- und Notierungsdaten sind hier zu finden: Arbeiten mit Auditdaten, Arbeiten mit Notierungsdaten
TSM_ReadSetting
Diese Funktion ermöglicht es einzelne Einträge aus der verwendeten HAKOM.Config auszulesen und in Excel anzuzeigen.
Unterstützt werden alle TSM spezifischen Einstellungen, die in der HAKOM.Config hier eingebunden sind:
<HAKOMConfiguration>
<products>
<TSM>
<settings>
<!-- TSM spezifische Settings -->
</settings>
</TSM>
</products>
</HAKOMConfiguration>
Für diese Funktion steht nur ein Parameter zur Verfügung:
| Parameter | Beschreibung | Datentyp |
|---|---|---|
| Setting | Name des Settings, für welches der Wert ausgelesen werden soll. | String (der Name des Settings wird ohne die voran- bzw. hintangestellten spitzen Klammern eingetragen) Beispiel: "LanguageKey" |