13.07.2015 Aufrufe

Download - IP-Symcon

Download - IP-Symcon

Download - IP-Symcon

MEHR ANZEIGEN
WENIGER ANZEIGEN

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

YUMPU macht aus Druck-PDFs automatisch weboptimierte ePaper, die Google liebt.

AC_GetLoggedValuesBenötigt: <strong>IP</strong>-<strong>Symcon</strong> >= 3.0array AC_GetLoggedValues ( integer $InstanzID , integer $VariablenID , integer $Startzeit , integer $Endzeit, integer $Limit )ParameterlisteInstanzIDVariablenIDStartzeitEndzeitLimitID zum ArchivHandlerID der abzufragenden VariablenDatum/Zeit als Unix TimestampDatum/Zeit als Unix TimestampMaximale Anzahl an Datensätzen. (0 = Kein Limit, 10000 ist das harte Limit, welches immer greift)RückgabewerteEin Array mit folgenden key => value Paaren.Die Ausgabe startet mit dem neusten Datensatz und dann absteigend mit den älteren Datensätzen.Index Typ BeschreibungTimeStamp integer Datum/Zeit beim Erstellen des Datensatzes als Unix TimestampValue variant WertBeschreibungDieser Befehlt gibt die Rohdaten zurück, die über das Archiv für eine Variable mit der VariablenID mitprotokolliertwurden. Dabei können die Start- und Endzeit als Parameter angegeben werden. Der Parameter Limit limitiert diemaximale Anzahl der zurückgegebenen Datensätze, wobei das Limit von 10000 Datensätzen pro Abfrage nieüberschritten werden kann.Das Archiv erstellt nur neue Datensätze für geänderte Werte! Aktualisierungen werden nicht berücksichtigt.Diese Funktion verursacht eine erhebliche Belastung für das System, da in den meisten Fällen sehr viele Datensätzeverarbeitet werden müssen. Bitte weichen Sie in jedem möglichen Falle auf bereits voraggregierte Werte über dieAC_GetAggregatedValues Funktion aus. Diese Funktion bietet Ihnen direkten Zugriff auf Mittelwerte oder Summenfür verschiedene Zeiträume wie z.B. Jahre, Monate, Wochen und Tage.In <strong>IP</strong>-<strong>Symcon</strong> 2.x war diese Funktion fehlerbehaftet. Es wurde immer ein Wert mehr ausgegeben, welcher vor derStartzeit lag. Das war insofern nützlich, dass die für z.B. die Graphengenerierung der vorherige Wert bekannt war,und für die vollständige Zeitspanne ein Graph erstellt werden konnte. Anderfalls wäre eine Lücke am Anfang desGraphen sichtbar. Für eine Funktion mit dem Parameter Startzeit ist diese Funktionsweise jedoch nicht korrekt. Werfür seine Skripte genau diese besondere Funktionsweise benötigt, kann die Hilfsfunktion nutzen, die den vorherigenDatensatz, der vor der Startzeit liegt, entsprechend abfragt und zum Array hinzufügt.Beispiel//Alle Datensätze vom 01.01.2013 bis zum 07.01.2013 abfragen$werte = AC_GetLoggedValues(12345, 55554, mktime(0, 0, 0, 1, 1, 2013), mktime(23, 59, 59, 1, 7, 2013), 0//Alle heutigen Datensätze abfragen$werte = AC_GetLoggedValues(12345, 55554, strtotime("today 00:00"), time(), 0); //55554 ist die ID der Varia

Hurra! Ihre Datei wurde hochgeladen und ist bereit für die Veröffentlichung.

Erfolgreich gespeichert!

Leider ist etwas schief gelaufen!