SaveRetainData-Baustein
Kurz-Information
Name |
SaveRetainData |
→POE-Typ |
|
Kategorie |
Weitere Systembausteine, Persistenz-Bausteine, Baustein mit interner Fehlerdiagnose |
Grafische Schnittstelle |
|
Verfügbar ab |
Der Baustein wird für die Plattform WindowsX86 (inkl. integrierte SPS unter Windows) unterstützt. |
Funktionalität
Der Baustein speichert die Werte von →gepufferten Variablen persistent in eine CSV-Datei. Vergleiche SaveRetainDataFast-Baustein für ein alternatives Speichern.
Einschränkungen
STRING-Werte werden nur bis zum 254. Zeichen gespeichert. Zeichenfolgen > 254 Zeichen werden entsprechend abgeschnitten.
Die Werte für gepufferte →Funktionsbaustein-Instanzen werden nicht gespeichert.
Verwendungsempfehlung
Verwenden Sie den Baustein nur einmal in einem →Programm mit einem →Task, bei dem ein entsprechend lange Zykluszeit definiert ist. Am besten wird der Aufruf des Bausteins außerdem durch eine Variable ausgelöst, die im Programm deklariert ist (siehe LoadRetainData-Baustein).
Grund: Abhängig von der Anzahl der Variablen und vom Speichermedium des Zielsystems kann das Speichern der Werte einen längeren Zeitraum in Anspruch nehmen. Falls Sie den Baustein daher öfter in der Anwendung aufrufen, erhöht sich die Ausführungsdauer der Anwendung mit jedem Aufruf.
Eingänge, Ausgänge, Ergebniswert
|
Bezeichner |
Beschreibung |
|
Eingänge: |
fileName |
STRING |
Name der Datei, in die die Werte der Variablen gespeichert werden |
Ausgänge: |
RC |
UDINT |
Ergebniscode:
|
Ergebniswert: |
– |
UDINT |
liefert den Ergebniscode von RC |
Der Eingang EN und der Ausgang ENO sind für den →Aufruf
des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.
Informieren Sie sich unter:
"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.
Interne Fehlerdiagnose für Baustein
Der Baustein prüft die folgenden Fehlerfälle:
Der Systemdienst wurde nicht geladen.
Der Ergebniscode des Funktionsaufrufs entspricht einem Fehler (Ausgang RC ≠ Wert 0).
In einem solchen Fehlerfall wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) gesetzt.
Beispiel für Verwendung im ST-Editor
Siehe LoadRetainData-Baustein.
Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.