Siemens SIMATIC S7 Serie Systemhandbuch Seite 496

Erweiterte Anweisungen
9.9 Rezepte und Datenprotokolle
Parameter und Datentyp
NAME IN
ID Durchgang
HEADER Durchgang
DATA Durchgang
DONE OUT
496
Datentyp Beschreibung
Variant Name des Datenprotokolls: Sie geben einen Namen ein.
Diese Variante unterstützt nur den Datentyp String und
kann nur im DB- oder im lokalen Speicher abgelegt wer‐
den. (Standardwert: ' ')
Diese Zeichenkette ist der Name der Datenprotokolldatei.
Verwenden Sie Zeichen aus dem ASCII-Zeichensatz, die
Zeichen \ / : * ? " < > | und das Leerzeichen sind nicht zu‐
lässig.
DWord Numerische Kennung des Datenprotokolls: Sie speichern
diesen generierten Wert zur Verwendung mit anderen Da‐
tenprotokollanweisungen. Der Parameter ID wird bei der
Anweisung DataLogCreate nur als Ausgang verwendet.
(Standardwert: 0)
Der Zugriff auf diesen Parameter über einen symbolischen
Namen ist nicht zulässig.
Variant Pointer auf die Spaltenköpfe des Datenprotokolls in der
obersten Zeile der Datenmatrix in der CSV-Datei. (Stan‐
dardwert: null).
HEADER-Daten müssen sich im DB- oder M-Speicher befin‐
den.
Die Zeichen müssen den üblichen Formatregeln für CSV-
Dateien entsprechen, und die einzelnen Spaltennamen
sind durch Komma zu trennen. Bei dem Datentyp kann es
sich um Strings, Byte-Arrays oder Zeichen-Arrays handeln.
Zeichen- bzw. Byte-Arrays ermöglichen eine größere Grö‐
ße, während der Datentyp String auf maximal 255 Bytes
begrenzt ist.
Der Parameter HEADER ist optional. Wenn der HEADER
nicht parametriert ist, wird keine Kopfzeile in der Daten‐
protokolldatei angelegt.
Variant Pointer auf die Datenstruktur des Datensatzes, anwender‐
definierter Datentyp (UDT) oder Array. Datensatzdaten
müssen sich im DB- oder M-Speicher befinden.
Der Parameter DATA gibt die einzelnen Datenelemente
(Spalten) eines Protokolldatensatzes und deren Datentyp
an. Bei der Anweisung DataLogCreate sind die Strukturda‐
tentypen auf eine einzige Schachtelungsebene begrenzt.
Ein Array aus Zeichenketten gilt in diesem Kontext nicht als
einzelne Schachtelungsebene. Derzeit gibt die Anweisung
DataLogCreate keinen Fehler zurück. Die Anweisung ver‐
arbeitet nur die erste Zeichenkette des Arrays. Die Anzahl
der deklarierten Datenelemente muss der Anzahl der im
Parameter HEADER angegebenen Spalten entsprechen.
Sie können maximal 253 Datenelemente (mit Zeitstempel)
bzw. 255 Datenelemente (ohne Zeitstempel) zuweisen.
Durch diese Einschränkung bleibt Ihr Datensatz innerhalb
des Grenzwerts von maximal 256 Spalten eines Excel-Ar‐
beitsblatts.
Bool Das Bit DONE ist einen Zyklus lang WAHR, nachdem die
letzte Anforderung fehlerfrei ausgeführt wurde. (Standard‐
wert: Falsch)
S7-1200 Automatisierungssystem
Systemhandbuch, V4.5 05/2021, A5E02486681-AO