SAVE_TEXT

SAVE_TEXT schreibt einen Textbaustein in die Textdatei bzw. das Textmemory zurück, abhängig vom Sicherungsmodus des jeweiligen Textobjekts.

Der Baustein kann sowohl für das Ändern vorhandener Texte als auch für das Anlegen neuer Texte verwendet werden. Ist jedoch sicher, daß es sich um einen neuen Text handelt, so kann das über den Parameter INSERT angegeben werden. Dies führt zu einer besseren Performanz, da ein Probelesen entfällt

Ist die übergebene Zeilentabelle leer, so wird der Text auf der Textdatei gelöscht.

Funktionsaufruf:

Syntax Syntax

CALL FUNCTION 'SAVE_TEXT'
	EXPORTING
		CLIENT		= SY-MANDT
		HEADER		= ?...
		INSERT		= SPACE
		SAVEMODE_DIRECT	= SPACE
		OWNER_SPECIFIED	= SPACE
	IMPORTING
		FUNCTION	=
		NEWHEADER	=
	TABLES
		LINES		= ?...
	EXCEPTIONS
		ID		=
		LANGUAGE	=
		NAME		=
		OBJECT		=

Ende des Quelltextes.

Export-Parameter:

CLIENT	Spezifizieren Sie hier den Mandanten, unter dem der Text gespeichert werden soll. Ist dieser Parameter nicht angegeben, so wird als Standardwert der aktuelle Mandant verwendet. Bezugsfeld: SY-MANDT Defaultwert: SY-MANDT
HEADER	Übergeben Sie hier die Feldleiste, die den Textheader des zu sichernden Textes enthält. Struktur: THEAD
INSERT	Der Parameter teilt der Textverarbeitung mit, daß es sich um einen noch nicht vorhandenen Textbaustein handelt. Normalerweise prüft SAPscript durch Lesen in der Textdatei, ob ein Textbaustein neu ist. Falls dies schon im rufenden Anwendungsprogramm bekannt ist, kann durch den Parameter das Probelesen unterdrückt und damit die Performanz verbessert werden. Mögliche Werte: '..' Updatemodus automatisch bestimmen 'X' Text ist neu Defaultwert: SPACE
SAVEMODE_DIRECT	Der Sicherungsmodus eines Textbausteins (direkt, Verbuchung) wird anhand des Textobjekts über die Tabelle TTXOB festgelegt. In bestimmten Fällen ist es jedoch sinnvoll, die verbuchungsseitige Sicherung durch eine sofortige Sicherung des Textes zu ersetzen (z.B. bei Hitergrundprogrammen). Mögliche Werte: ' ' Sicherungsmodus entsprechend Textobjekt 'X' der Textbaustein wird sofort gesichert Defaultwert: SPACE
OWNER_SPECIFIED	Der Parameter steuert, ob beim Neuanlegen eines Textes die Informationen im Textkopf bzgl. der Erstanlage automatisch von SAPscript eingesetzt wird oder ob die im Header diesbezüglich übergebenen Daten verwendet werden sollen. Betroffen sind davon die Felder TDFUSER, TDFDATE, TDFTIME und TDFRELES im Textheader. Mögliche Werte: ' ' Information wird von SAPscript versorgt 'X' Information wird aus dem Header übernommen Wenn die Option eingeschaltet und eines der zuvor genannten Felder initial ist, so wird dieses Feld weiterhin von SAPscript gefüllt. Diesen Parameter werden Sie setzen, wenn Texte per Programm hinzugefügt werden, welche einen bestimmten Eigentümer oder eine bestimmte Release-Information erhalten sollen, die abweichend von der aktuellen Umgebung sein soll. (Beispiel: Migrationsprogramm zur Übernahme von Texten aus dem System R/2 ins SAPscript). Defaultwert: SPACE

Import-Parameter:

FUNCTION

Der Parameter gibt den Verarbeitungsstatus des Textbausteins für den aktuellen Aufruf zurück.

Mögliche Werte:

' ' keine Aktion
'I' Textbaustein wurde neu angelegt
'U' Textbaustein wurde verändert
'D' Textbaustein wurde gelöscht

Tabellen-Parameter:

LINES

Die Tabelle enthält die Textzeilen des zu sichernden Textes.

Struktur: TLINE

Exceptions:

ID	Die im Feld TDID des Textheaders angegebene Text-Id ist nicht in der Tabelle TTXID vorhanden. Sie muß dort zusammen mit dem Objekt des Textbausteins definiert sein.
LANGUAGE	Das im Feld TDSPRAS des Textheaders angegebene Sprachkennzeichen ist nicht in der Tabelle T002 definiert
NAME	Der im Feld TDNAME des Textheaders angegebene Name eines Textbausteins entspricht nicht den SAPscript-Konventionen. Mögliche Fehler: Feld enthält nur Leerzeichen Feld enthält die unzulässigen Zeichen '*' oder ','
OBJECT	Das im Feld TDOBJECT des Textheaders angegebene Textobjekt ist nicht in der Tabelle TTXOB enthalten.