READ_TEXT_INLINE

READ_TEXT_INLINE stellt dem Anwendungsprogramm einen Text in den angegebenen Arbeitsbereichen zur Verfügung. Diese Arbeitsbereiche müssen dann bei allen SAPscript-Funktionsbausteinen angegeben werden, die diesen Text bearbeiten sollen.

Der Funktionsbaustein liest einen Text aus der Textdatei oder dem Textmemory. Der Text muß durch Angabe von OBJECT, NAME, ID und LANGUAGE vollständig spezifiziert sein. In einem internen Arbeitsbereich kann nur ein Text abgelegt werden. Deshalb sind generische Angaben in diesen Parametern nicht zugelassen.

Zusätzlich werden soviele Zeilen aus der Tabelle LINES in die Tabelle INLINES übertragen, wie im Parameter INLINE_COUNT definiert sind. Diese Zeilentabelle kann dazu verwendet werden, die ersten Textzeilen auf einem beliebigen Dynpro anzuzeigen und zu verändern. Zum PAI-Zeitpunkt ist dazu der Funktionsbaustein EDIT_TEXT_INLINE aufzurufen.

Funktionsaufruf:

Syntax Syntax

CALL FUNCTION 'READ_TEXT_INLINE'
	EXPORTING
		OBJECT		= ?...
		NAME		= ?...
		ID		= ?...
		LANGUAGE	= ?...
		INLINE_COUNT	= ?...
		IMPORTING HEADER =
	TABLES
		LINES		= ?...
		INLINES		= ?...
	EXCEPTIONS
		ID		=
		LANGUAGE	=
		NAME		=
		NOT_FOUND	=
		OBJECT		=
		REFERENCE_CHECK	=

Ende des Quelltextes.

Export-Parameter:

OBJECT	Hier geben Sie den Namen des Textobjektes an, dem der Text zugeordnet ist. Die zugelassenen Objekte finden Sie in der Tabelle TTXOB. Bezugsfeld: THEAD-TDOBJECT
NAME	Übergeben Sie hier den Namen des Texbausteins. Der Textname kann bis zu 70 Stellen lang sein. Seine innere Strukturierung hängt vom verwendeten Textobjekt ab. Bezugsfeld: THEAD-TDNAME
ID	Geben Sie hier die Text-Id des Textbausteins an. Zulässige Werte für die Text-Id sind abhängig vom Textobjekt in der Tabelle TTXID definiert. Bezugsfeld: THEAD-TDID
LANGUAGE	Über diesen Parameter legen Sie den Sprachschlüssel des Textbausteins fest. Es werden nur Sprachen akzeptiert, die in der Tabelle T002 definiert sind. Bezugsfeld: THEAD-TDSPRAS
INLINE_COUNT	Geben Sie hier an, wieviele Textzeilen vom Anfang der Textzeilentabelle LINES in Tabelle INLINES übertragen werden.

Import-Parameter:

HEADER

Falls der gewünschte Text gefunden wurde, wird in diesem Parameter der Textheader zurückgegeben.

Struktur: THEAD

Tabellen-Parameter:

LINES

Die Tabelle enthält alle Textzeilen, die zu dem gelesenen Text gehören.

Struktur: TLINE

INLINES

Die Tabelle enthält so viele Zeilen der Tabelle LINES, wie im Parameter INLINE_COUNT angegeben sind.

Struktur: TLINE

Exceptions:

ID	Die im Parameter ID angegebene Text-Id ist nicht in der Tabelle TTXID vorhanden. Sie muß dort zusammen mit dem Objekt des Textbausteins definiert sein.
LANGUAGE	Im Parameter LANGUAGE ist ein Sprachkennzeichen angegeben, welches nicht in der Tabelle T002 definiert ist.
NAME	Im Parameter NAME wurde der Name eines Textbausteins übergeben, der nicht den SAPscript-Konventionen entspricht. Mögliche Fehler: Feld enthält nur Leerzeichen Feld enthält die unzulässigen Zeichen '*' oder ','
OBJECT	Der Parameter OBJECT enthält den Namen eines Textobjekts, welches nicht in der Tabelle TTXOB enthalten ist.
NOT_FOUND	Der angegebene Textbaustein wurde nicht gefunden
REFERENCE_CHECK	Der zu lesende Textbaustein hat selbst keine eigenen Textzeilen, sondern verweist auf die Zeilen eines anderen Textbausteins. Diese Verweiskette kann über mehrere Stufen gehen. Bei dem vorliegenden Text ist die Verweiskette unterbrochen, d.h. ein ursprünglich in dieser Kette liegender Textbaustein ist nicht mehr vorhanden.