Audit und Notierung

Audit

Die Nachverfolgung von Änderungen ist in gewissen kritischen Bereichen unerlässlich. HAKOM TSM unterstützt Sie dabei mit folgenden Funktionen:

• Auditierung von allen Änderungen einer Zeitreihendefinition oder sonstige Stammdatenänderungen
• Auditierung von allen Zeitreihendatenänderungen: Dabei wird der geänderte Zeitbereich und der Änderungszeitpunkt gespeichert. Die Daten werden standardmäßig nicht auditiert.
• Historisierung geänderter Daten: Dabei wird der zu einem bestimmten Änderungszeitpunkt geänderte Datensatz in einer Archivtabelle persistiert. Das System unterstützt durchgängig das Arbeiten mit diesen gespeicherten Datensätzen, als wären es Live-Daten.

Konzept

Audit kann für jede beliebige Zeitreihe im System aktiviert werden. Der Zeitstempel wird beim Speichern automatisch zum jeweiligen Systemdatum sekundengenau gesetzt. Alle Daten werden diesem Zeitpunkt zugewiesen. Somit können die Daten der Zeitreihe zu jedem beliebigen Zeitpunkt abgerufen werden.

Exakt vs. nicht exakt

Bei den im Zuge der Audit Funktion gespeicherten Daten, unterscheidet HAKOM TSM zwischen exakten und nicht exakten (zur gegebenen Zeit gültigen) Werten.

Exakt

Möchte man alle Änderungen zu einem gegebenen Zeitpunkt abrufen und alle vorherigen Werte, die zu einem anderen Zeitpunkt geschrieben wurden, ignorieren (0 - fehlend darstellen), dann ruft man die Daten exakt ab. Achtung, bei einem exakten Abruf sucht das System nach dem angegebenen Zeitstempel genau. Bei abweichendem Zeitstempel werden keine Daten zurück geliefert, da es dort keine Änderungen gab. Um beim Finden der vorhandenen Zeitstempel zu unterstützen, listet die TSM App pro Zeitreihe alle möglichen Zeitstempel auf. In der WebTSM Services API können alle Änderungen über den Pfad GET /repositories/:repository/timeseries/:id|name/data/modifications abgerufen werden.

Nicht exakt

Möchte man alle Änderungen zu einem gegebenen Zeitpunkt zusätzlich zu den vorherigen Änderungen abrufen, dann ruft man die Daten nicht exakt ab. In diesem Fall kann der Zeitstempel auch ungenau angegeben werden, da alle historisierten Daten vor dem angegebenen Zeitpunkt abgerufen werden.

Beispiel

Als Beispiel zeigt die nachfolgende Grafik drei Änderungen derselben Zeitreihe, wobei das älteste Änderungsdatum an unterster ("Change date 1")  und das neueste Änderungsdatum ("Change date 3") an oberster Stelle steht:

Es werden nun Daten zum Zeitpunkt 3 (also letzte Änderung) und Zeitpunkt 2 (eine Änderung davor) jeweils exakt und nicht exakt abgerufen:

Abruf der Daten

TSM Plugin

In TSM Plugin können historisierte Daten im Hauptfenster unter der "Audit" Auswahlliste abgerufen werden. Dabei entspricht "Änderung am" einem exakten Abruf und "Stand am" einem nicht exakten Abruf. Zusätzlich gibt es für beide Abrufe auch die Möglichkeit die letzten n Änderungen bzw. Stände als einzelne zusätzliche Zeitreihenspalten in Excel gemeinsam abzurufen.

WebTSM Services API

In der WebTSM Services API kann der Zeitstempel in Daten-Pfaden (wie /repositories/:repsoitory/timeseries/:id|name/data) via Paramter "audit" in ISO 8601 Format übergeben werden. Es werden dann alle Daten zum angegebenen Zeitpunkt abgerufen. Mittels Parameter "exactAudit" kann darüber hinaus ein exakter Abruf ausgeführt werden.

Notierung

Unterschied zu Audit

Zeitreihen mit aktiviertem Audit ermöglichen bereits das Auslesen historischer Daten. Allerdings wird der Zeitstempel vom System vergeben. Eine manuelle Beeinflussung ist in diesem Fall nicht möglich.

In bestimmten Fällen ist aber genau das notwendig. Zum Beispiel, wenn Einflussfaktoren zusammen mit Berechnungsergebnissen mit demselben Zeitstempel verknüpft werden sollen. Das ist beispielsweise der Fall bei einer Prognose, welche mit 15 Uhr Wetterdaten eine 15 Uhr Prognose erstellt, die nicht exakt zum Systemdatum 15 Uhr berechnet wurde. Ohne einer manuellen Vergabe des Berechnungsdatums wäre es schwer zusammenhängende Datensätze zu verknüpfen.

Möchte man also den Zeitstempel selbst wählen und von einer vollwertigen Änderungsverfolgung (Audit) profitieren, dann ist eine Notierungszeitreihe die richtige Wahl.

Aktivierung der Notierung

Notierung sollte beim Erstellen der Zeitreihe aktiviert werden, auf jeden Fall spätestens vor dem Speichern der ersten Daten auf die betreffende Zeitreihe.

Wird Notierung für eine bestehende Zeitreihe mit bereits vorhandenen Daten aktiviert, müssen die vorhandenen Daten migriert werden.

TSM App:

1. Klick auf Öffnen im  TSM Ribbon
2. Klick auf den Button Suche... im Zeitreihen Bereich des TSM Fensters
3. Eingabe der gewünschten Suchkriterien und danach Klick auf Suche
4. Entsprechende Zeitreihe auswählen
5. Anschließend auf den Reiter Bearbeiten wechseln
6. Auswahl der Checkbox Notierung - die entsprechende Tabelle wird automatisch vergeben.
7. Klick auf Speichern 

WebTSM Services API:

In der WebTSM Services API kann die Eigenschaft "Quotation" im Body auf true gesetzt werden.

{
    "Name": "MyFirstTimeSeries",
    "Type": 2,
    "Interval": {
        "Value": "Minute",
        "Multiplier": 15
    },
    "Unit": "KWh",
	"Quotation": true
}

Standard Notierungsverhalten

Die Wahl des Standard Notierungsverhalten hat Auswirkungen darauf, welche Version der Zeitreihe beim Auslesen mit Notierung geladen wird:

Mehr über Audit erfahren Sie hier: Audit

Mehr über Notierung erfahren Sie hier: Notierungen

Wir empfehlen folgende Videos unter Video Tutorials:

• Auditing
• Quotation Time Series
• Exact Versus NotExact