Der HS/FS kann Werte von Kommunikationsobjekten (intern und EIB) aufzeichnen und archivieren.
Die Aufzeichnung kann zyklisch und per Befehl ausgeführt werden.
Alle Daten können in verschiedenen Formaten (csv, html, xml) abgerufen werden, wodurch eine Weiterverwertung, z. B. zur grafischen Darstellung oder Tabellenkalkulation, ermöglicht wird.
Weiterhin gibt es eine Menü-Seite, die Daten direkt als Diagramm darstellt.
Ein Archiv kann per eMail versendet, per http abgefragt, sowie per ftp ausgelagert werden.
Die Informationen können innerhalb des Netzwerkes, per ISDN-Direkteinwahl, oder über Internet abgerufen werden.
Die Aufzeichnung kann zyklisch und per Befehl ausgeführt werden.
Alle Daten können in verschiedenen Formaten (csv, html, xml) abgerufen werden, wodurch eine Weiterverwertung, z. B. zur grafischen Darstellung oder Tabellenkalkulation, ermöglicht wird.
Weiterhin gibt es eine Menü-Seite, die Daten direkt als Diagramm darstellt.
Ein Archiv kann per eMail versendet, per http abgefragt, sowie per ftp ausgelagert werden.
Die Informationen können innerhalb des Netzwerkes, per ISDN-Direkteinwahl, oder über Internet abgerufen werden.
Achtung
In den Archiven können nur numerische Werte gespeichert werden!
Hinweis
Texte können in Meldungs-Archiven gespeichert werden.
1.Archiv
Im Archiv (genauer: Datenarchiv) werden die Zustände von Kommunikationsobjekten archiviert.
Die Archivierung kann durch einen Befehl ausgeführt werden. Zusätzlich kann die Aufzeichnung der Daten zyklisch erfolgen.
Fragen zum Thema werden in der FAQ behandelt.
Um ein Datenarchiv anzulegen, wechseln Sie in das Fenster "Archive". Führen Sie den Mauszeiger im Verzeichnisbaum auf den Knoten "Archive". Betätigen Sie die rechte Maustaste. Es öffnet sich ein Pulldown-Menü. Klicken Sie auf "Archiv anlegen". Dem Verzeichnisbaum wird ein neues Archiv hinzugefügt.
Unter "Spalten" legen Sie fest, welche Daten innerhalb eines Datensatzes gespeichert werden sollen.
Die Archivierung kann durch einen Befehl ausgeführt werden. Zusätzlich kann die Aufzeichnung der Daten zyklisch erfolgen.
Fragen zum Thema werden in der FAQ behandelt.
Um ein Datenarchiv anzulegen, wechseln Sie in das Fenster "Archive". Führen Sie den Mauszeiger im Verzeichnisbaum auf den Knoten "Archive". Betätigen Sie die rechte Maustaste. Es öffnet sich ein Pulldown-Menü. Klicken Sie auf "Archiv anlegen". Dem Verzeichnisbaum wird ein neues Archiv hinzugefügt.
Unter "Spalten" legen Sie fest, welche Daten innerhalb eines Datensatzes gespeichert werden sollen.
1.1.Register
1.1.1.Daten
Hier wird die grundsätzliche Definition des Archivs durchgeführt.
Bezeichnung
Unter diesem Begriff wird das Archiv im HS/FS-Experten geführt.
Über die Endpunkt-Schnittstelle können Archive gesucht werden, bei denen ein Wort aus der Bezeichnung mit dem dort verwendeten Suchwort beginnt.
Über die Endpunkt-Schnittstelle können Archive gesucht werden, bei denen ein Wort aus der Bezeichnung mit dem dort verwendeten Suchwort beginnt.
Ringspeicher
Maximale Anzahl der Datensätze, die im Ringspeicher gehalten werden sollen. Ist diese Zahl erreicht, wird der älteste vorhandene Datensatz durch den nächsten neu anzulegenden ersetzt. Siehe auch Grenzwerte.
Zyklus
Wird diese Option gewählt, so werden die Daten zyklisch aufgezeichnet.
| Ja | Die Aufzeichnung erfolgt zyklisch. Die Zyklusdauer wird im nebenstehenden Feld in Minuten angegeben. Unabhängig von dieser Option kann durch Befehl jederzeit ein Datensatz gespeichert werden. |
|---|---|
| Nein | Die Aufzeichnung muss durch einen Befehl ausgelöst werden. |
Totzeit
Diese Zeit verhindert, dass in zu kurzen Abständen Daten aufgezeichnet werden.
Dieser Zeitraum ist in erster Linie im Zusammenhang mit Befehlen zur Datenaufzeichnung von Bedeutung.
Beispiel:
Liegt die Totzeit bei 60 Sekunden, werden Befehle zur Datenspeicherung erst nach Ablauf dieser Zeit ausgeführt. (FAQ zum Thema)
Dieser Zeitraum ist in erster Linie im Zusammenhang mit Befehlen zur Datenaufzeichnung von Bedeutung.
Beispiel:
Liegt die Totzeit bei 60 Sekunden, werden Befehle zur Datenspeicherung erst nach Ablauf dieser Zeit ausgeführt. (FAQ zum Thema)
Spalten
Bis zu 128 Kommunikationsobjekte (1 KO pro Spalte) können in einer Zeile gleichzeitig abgespeichert werden. Das erleichtert die spätere Auswertung. Jedes Archiv enthält in der ersten Spalte immer Datum und Uhrzeit.
Durch die Bedienknöpfe rechts neben der Liste werden die Spalten angelegt, geändert oder gelöscht. Dazu erscheint eine Maske.
Durch die Bedienknöpfe rechts neben der Liste werden die Spalten angelegt, geändert oder gelöscht. Dazu erscheint eine Maske.
Achtung
Wird ein Archiv verändert (Spalten werden hinzugefügt, gelöscht oder der Datentyp wird geändert), sind nach einer anschließenden Neu-Übertragung des Projekts auf den HS/FS alle dort evtl. bereits gespeicherten Daten dieses Archivs verloren!
1.1.2.Endpunkt
Auf Archive kann über die Endpunkte-Schnittstelle des HS/FS zugegriffen werden.
Eine Beschreibung der Aufruf-Parameter gibt es hier.
Eine Beschreibung der Aufruf-Parameter gibt es hier.
Hinweis
Anstelle des in allen Aufruf-Beispielen in der folgenden Tabelle eingesetzten Archivs, kann natürlich jedes beliebige Archiv verwendet werden.
Platzhalter sind in GROSSBUCHSTABEN angegeben.
Platzhalter sind in GROSSBUCHSTABEN angegeben.
1.1.2.1.Methoden
| Methode | Beschreibung/Aufruf |
|---|---|
| meta | Abruf von Meta-Daten des Archivs.https://HS_IP/endpoints/call?key=DA@my_archive&method=meta&user=USER&pw=PWD |
| get | Abruf von bestimmten Spalten eines Archivs in einem bestimmten Zeitraum.https://HS_IP/endpoints/call?key=DA@my_archive&method=get&startat=1702261500&cnt=12&size=5&cols=MYCOL1+MYCOL5&user=USER&pw=PWD |
1.1.2.2.Felder
ID
Der hier eingegebene Wert bildet zusammen mit dem fest vorgegebenen Präfix "DA", mit dem die ID durch ein '@'-Zeichen verbunden ist, den eindeutigen Objekt-Schlüssel des Endpunkts.
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Beschreibung
Eine sprechende Beschreibung des Archivs.
Über die Endpunkt-Schnittstelle können Archive gesucht werden, bei denen ein Wort aus der Beschreibung mit dem dort verwendeten Suchwort beginnt.
Über die Endpunkt-Schnittstelle können Archive gesucht werden, bei denen ein Wort aus der Beschreibung mit dem dort verwendeten Suchwort beginnt.
Tags
Eine Liste von Begriffen, getrennt durch Kommata (",").
Über die Endpunkt-Schnittstelle können Archive gesucht werden, bei denen ein einzelner Tag vollständig mit dem dort verwendeten Suchwort übereinstimmt.
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Über die Endpunkt-Schnittstelle können Archive gesucht werden, bei denen ein einzelner Tag vollständig mit dem dort verwendeten Suchwort übereinstimmt.
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Benutzergruppen
Achtung
Dieser Punkt ist nur verfügbar, wenn Benutzergruppen aktiviert wurden!
Benutzergruppen können berechtigt werden, über die Endpunkte-Schnittstelle auf dieses Archiv (zum Lesen) zuzugreifen.
1.1.3.E-Mail
Hinweis
Diese Option ist nur verfügbar, wenn zuvor unter Stammdaten\Projekt\Netzwerk\E-Mail der E-mail Versand aktiviert wurde.
E-Mail-Versand
Diese Liste zeigt alle Archiv-Versionen, die per eMail versendet werden können.
Betätigen Sie rechts neben der Liste die Bedienknöpfe "Anlegen/Ändern/Löschen". Zum Bearbeiten erscheint eine Maske.
Betätigen Sie rechts neben der Liste die Bedienknöpfe "Anlegen/Ändern/Löschen". Zum Bearbeiten erscheint eine Maske.
1.1.4.HTTP-Abruf
HTTP-Abruf
Diese Liste zeigt alle Archiv-Versionen, die per http-Abfrage abgerufen werden können.
Betätigen Sie rechts neben der Liste die Bedienknöpfe "Anlegen/Ändern/Löschen". Zum Bearbeiten erscheint eine Maske.
Betätigen Sie rechts neben der Liste die Bedienknöpfe "Anlegen/Ändern/Löschen". Zum Bearbeiten erscheint eine Maske.
1.1.5.FTP
Hinweis
Diese Option ist nur verfügbar, wenn zuvor unter Stammdaten\Projekt\Netzwerk\FTP die Unterstützung aktiviert wurde.
FTP-Versand
Diese Liste zeigt alle Archiv-Versionen, die per FTP ausgelagert werden können.
Betätigen Sie rechts neben der Liste die Bedienknöpfe "Anlegen/Ändern/Löschen". Zum Bearbeiten erscheint eine Maske.
Betätigen Sie rechts neben der Liste die Bedienknöpfe "Anlegen/Ändern/Löschen". Zum Bearbeiten erscheint eine Maske.
1.2.Grenzwerte
Die Daten werden dauerhaft (remanent) innerhalb eines Ringspeichers gespeichert. Der Speicher ähnelt einer Tabelle, die sich aus Zeilen und Spalten zusammensetzt. Er kann für jedes Archiv konfiguriert werden.
Achtung
Die erste Spalte enthält immer Datum und Uhrzeit der Speicherung und wird bei der Berechnung der Grenzwerte für HomeServer und FacilityServer nicht mitgezählt!
Die in den folgenden Tabellen aufgeführten Maximalangaben sind äußere Begrenzungen. Die Angaben stellen keine Eigenschaften bezüglich der Speicherkapazität dar. Im HS/FS und HS/FS-Experten können keine größeren Werte verwendet werden. Daher kann die Speicherkapazität, abhängig von den zu speichernden Daten und den verwendeten Komprimierungsverfahren, deutlich geringer sein!
Die Begrenzungen lauten wie folgt und die jeweils erste, die zutrifft, gilt. Die Begrenzungen sind unterschiedlich für den HomeServer und den FacilityServer.
Die Begrenzungen lauten wie folgt und die jeweils erste, die zutrifft, gilt. Die Begrenzungen sind unterschiedlich für den HomeServer und den FacilityServer.