RingBufferRead (FPScript)
Liest eine Datenspur aus einem HistoryBase-Ringspeicher.
Syntax
RingBufferRead(HistoryBaseFile, Machine, Group, TraceName, FromTime, ToTime)
Die Syntax der RingBufferRead-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
HistoryBaseFile |
Zeichenkette die den Pfad der einzulesenden Ringspeicherdatei angibt. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette (Dateiname). |
Machine |
Name eines Computers im Netzwerk auf dem die angegebene Ringspeicherdatei bereits von einer HistoryBase-Komponente verwendet wird. Dieses Argument kann auch ein leerer Text sein. In diesem Fall wird die HistoryBase-Instanz auf dem ausführenden System gesucht bzw. instanziiert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
Group |
Name der Spurgruppe im Ringspeicher, in der sich die zu importierende Spur befindet. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
TraceName |
Name der Spur, die importiert werden soll. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
FromTime |
Der Zeitpunkt des ersten (ältesten) Wertes, der aus der Spur ausgelesen werden soll. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 32-Bit Ganzzahl, 64-Bit Fließkomma und Kalenderzeit. |
ToTime |
Der Zeitpunkt des letzten (jüngsten) Wertes, der aus der Spur ausgelesen werden soll. Dieser Zeitpunkt muss größer als der in FromTime angegebene Zeitpunkt sein. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 32-Bit Ganzzahl, 64-Bit Fließkomma und Kalenderzeit. |
Anmerkungen
Das Ergebnis hat immer die Datenstruktur Datenreihe.
Der Weisang HistoryBase-Ringspeicher in Version 2.4 oder höher muss auf dem ausführenden System und ggf. auf dem in Machine angegebenen System installiert sein.
Ist ein Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
RingBufferRead("C:\RingBuffer.rbf", "RemoteMachine", "SPS", "Signal", '1.1.2010 10:00', '1.1.2010 11:00') |