Show TOC

FunktionsdokumentationTEXT_INCLUDE_REPLACE Dieses Dokument in der Navigationsstruktur finden

 

Mit dieser Funktion werden die in Textzeilen vorhandenen INCLUDE-Kommandos aufgelöst, d.h. durch die entsprechenden Textzeilen des einzubindenden Textes ersetzt. Ist ein Textbaustein nicht vorhanden oder hat der Benutzer keine Berechtigung, so bleibt das INCLUDE-Kommando erhalten.

Funktionsaufruf:

Syntax Syntax

  1. CALL FUNCTION 'TEXT_INCLUDE_REPLACE'
	EXPORTING
		HEADER		= ?...
		STARTLINE	= 1
		ENDLINE		= 99999
		PROGRAM		= SPACE
		ALL_LEVEL	= 'X'
	IMPORTING
		NEWHEADER	=
		CHANGED		=
		ERROR_TYPE	=
	TABLES
		LINES		= ?...
Ende des Quelltextes.
Export-Parameter:

HEADER

Dieser Parameter enthält den Header des Textbausteins, dessen INCLUDEs aufgelöst werden sollen.

Struktur: THEAD

STARTLINE

Hier können Sie den Index der Tabellenzeile angeben, ab der die gewünschte Funktion wirken soll. Ist kein Wert oder ein ungültiger Wert spezifiziert, wird die erste Zeile der Texttabelle angenommen.

Bezugsfeld: SY-TABIX

Defaultwert: 1

ENDLINE

Hier geben Sie den Index der letzten Textzeile an, auf den Sie die gewünschte Funktion anwenden wollen. Ist kein Wert oder ein ungültiger Wert angegeben, wird standardmäßig die letzte Zeile der Texttabelle angenommen.

Bezugsfeld: SY-TABIX

Defaultwert: 99999

PROGRAM

Für die Ersetzung von Programmsymbolen muß SAPscript wissen, in welchem aktiven Programm die Workareas für die zu übernehmenden Werte liegen.

Ist nichts angegeben, so werden die Feldwerte in dem zuerst gerufenen Programm gesucht (SY-CPROG).

Wenn Sie hier einen Programmnamen übergeben, so werden die Programmsymbole aus den Datenbereichen des hier angegebenen Programms ersetzt. Diese Zuordnung ist nur für den aktuellen Aufruf des Funktionsbausteins gültig

Bezugsfeld: SY-REPID

Defaultwert: SPACE

ALL_LEVEL

Über ALL_LEVEL kann gesteuert werden, ob nur die in der Texttabelle vorhandenen INCLUDE-Kommandos aufgelöst werden sollen, oder auch die durch diese Auflösung eventuell neu hinzugekommenen INCLUDE-Kommandos.

Mögliche Werte:

  • ' ' nur vorhandene INCLUDEs auflösen

  • 'X' alle INCLUDEs auflösen

Defaultwert: 'X'
Import-Parameter:

NEWHEADER

Die Parameter gibt den Textheader zurück mit den entsprechend der durchgeführten Aktion veränderten Feldern.

Struktur: THEAD

CHANGED

Der Parameter zeigt an, ob INCLUDEs aufgelöst wurden und sich der Inhalt der Texttabelle damit verändert hat.

Mögliche Werte:

  • 'X' INCLUDEs wurden aufgelöst

  • ' ' keine INCLUDEs aufgelöst

ERROR_TYPE

Dieser Parameter liefert z.Zt. noch keine Fehlermeldungen zurück.

Bezugsfeld: SY-TABIX
Tabellen-Parameter:

LINES

Die Tabelle enthält die Textzeilen, in denen die INCLUDE-kommandos aufgelöst werden sollen.

Struktur: TLINE