Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datensequenzen > PUT_PROCESS_LINE

PUT_PROCESS_LINE

Script-Funktion: Fügt einer bestimmten Datensequenz eine Zeile hinzu.

Syntax

PUT_PROCESS_LINE(Data sequence reference, Line, [Delimiter ])

Syntax	Beschreibung/Format
Datensequenz-Referenz	Referenz auf die Datensequenz, der eine Zeile hinzugefügt werden soll. Format: Script-Variable
Zeile	Zeile, welche der Datensequenz angehängt wird. Format: Script-Variable oder Script-Literal Auch die Angabe eines Script Arrays ist möglich.
Trennzeichen	Beliebiges Zeichen, welches die angegebene Zeile in Spalten aufteilt. Format: Script-Variable oder Script-Literal Wird für Zeile ein Array angegeben, besitzt dieser Parameter keine Wirkung.

Syntax

Beschreibung/Format

Datensequenz-Referenz

Referenz auf die Datensequenz, der eine Zeile hinzugefügt werden soll.
Format: Script-Variable

Zeile

Zeile, welche der Datensequenz angehängt wird.
Format: Script-Variable oder Script-Literal

Auch die Angabe eines Script Arrays ist möglich.

Trennzeichen

Beliebiges Zeichen, welches die angegebene Zeile in Spalten aufteilt.
Format: Script-Variable oder Script-Literal

Wird für Zeile ein Array angegeben, besitzt dieser Parameter keine Wirkung.

Rückgabewert
"0" - Datensequenz wurde erfolgreich um die angegebene Zeile erweitert.

Anmerkungen

Die Script-Funktion fügt einer Datensequenz eine neue Zeile hinzu. Die Datensequenz wird dabei direkt geändert - der Rückgabewert der Funktion zeigt nur, ob das Hinzufügen der Zeile erfolgreich durchgeführt werden konnte. Dabei ist die Referenz auf die zu ändernde Datensequenz und der Wert, der als neue Zeile eingefügt werden soll, anzugeben.

Datensequenzen können mit dem Sprachmittel CREATE_PROCESS oder mit den PREP_PROCESS* - Funktionen erstellt werden.

Achten Sie darauf, dass die Datensequenz, deren Referenz angegeben wurde, tatsächlich existiert oder nicht bereits via :CLOSE_PROCESS geschlossen wurde. Ist dies nicht der Fall, kommt es zu einem Laufzeitfehler. Mit dem Sprachmittel kann keine neue Datensequenz erstellt werden!

Die hinzuzufügende Zeile kann dabei entweder in Form einer Zeichenkette (Script-Literal bzw. Script-Variable) oder eines Script-Array (Script-Variable) angegeben werden. Bei einer Zeichenkette kann zusätzlich ein Trennzeichen angegeben werden, gemäß diesem die Aufteilung in mehrere Spalten erfolgt. Wird kein Trennzeichen spezifiziert, so besitzt die neue Zeile nur eine Spalte, die den kompletten Wert enthält.

Wird ein Array angegeben, so stellen dessen Elemente die Spalten der neuen Zeile dar. Die leeren Elemente am Ende des Arrays werden nicht verwendet.

Beispiele

Im folgendem Beispiel wird eine Datensequenz erstellt, welche eine Dateiliste speichert. Anschließend wird ein Dateiname aus einem Variablen-Objekt gelesen und der Datensequenz hinzugefügt.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","C:\AUTOMIC\temp\test*.txt","Y",,)
:SET &LINE# = GET_VAR(VARA.FILELIST)
:SET &RET# = PUT_PROCESS_LINE(&HND#,&LINE#)

Siehe auch:

Script-Sprachmittel	Beschreibung
:CLOSE_PROCESS	Verwirft eine Datensequenz innerhalb eines Scripts.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	Definition einer Schleife zur zeilenweisen Bearbeitung einer Datensequenz, wie beispielsweise den Inhalt einer sequentiellen Datei oder das textmäßige Ergebnis eines Kommandos.
CREATE_PROCESS	Erstellt ein neue Datensequenz.
GET_PROCESS_LINE	Ermittelt den aktuellen Zeileninhalt einer Datensequenz.

Script-Sprachmittel - Datensequenzen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support