Show TOC

FunktionsdokumentationREAD_FORM_LINES Dieses Dokument in der Navigationsstruktur finden

 

Mit dieser Funktion können Sie die Zeilen eines Formularelements in eine interne Tabelle übernehmen.

Wird der Formularname nicht angegeben, so werden die Textzeilen aus dem gerade geöffneten Formular übernommen, ansonsten die des spezifizierten Formulars. Im letzteren Fall werden die Textzeilen der aktiven Version des Formulars aus der Datenbank zur Verfügung gestellt.

Funktionsaufruf:

Syntax Syntax

  1. CALL FUNCTION  'READ_FORM_LINES'
    	EXPORTING
    		FORM	= SPACE
    		LANGUAGE = SPACE
    		WINDOW	= 'MAIN'
    		ELEMENT	= SPACE
    	TABLES
    		LINES	= ?...
    	EXCEPTIONS
    		ELEMENT	=
    		FORM	=
    		UNOPENED =
Ende des Quelltextes.
Export-Parameter:

FORM

Der Parameter legt den Namen des Formulars fest, aus dem Sie Zeilen übernehmen wollen. Ist nichts angegeben, so wird das aktuell geöffnete Formular genommen.

Defaultwert: SPACE

LANGUAGE

LANGUAGE definiert die gewünschte Formularsprache. Ist keine Sprache angegeben. wird die des gerade geöffneten Formulars verwendet.

Defaultwert: SPACE

WINDOW

Übergeben Sie dem Funktionsbaustein hier den Namen des Fensters, in dem sich das Formularelement befindet. Fehlt die Angabe zum Fenster, wird das Formularelement im Hauptfenster gesucht.

Defaultwert: 'MAIN'

ELEMENT

Hier können Sie den Namen des Formularelements angeben, dessen Textzeilen gelesen werden sollen. Ist der Parameter leer, wird nach dem 'namenlosen' Element gesucht.

Defaultwert: SPACE

Tabellen-Parameter:

LINES

In die hier angegebene Tabelle werden die Zeilen des gewünschten Elementes gestellt.

Struktur: TLINE

Exceptions:

ELEMENT

Der Parameter ELEMENT enthält den Namen eines Formularelements, welches nicht gefunden werden konnte.

Mögliche Ursachen:

  • Das Element ist nicht vorhanden.

  • Ein Element sind fensterspezifisch und in dem angegebenen Fenster wurde das Element nicht gefunden. Falls kein Fenstername spezifiziert wurde, wird standardmäßig das Element im Fenster MAIN gesucht.

  • Es wurde ein Fenster spezifiziert, welches im Formular nicht definiert wurde.

  • Die Formularversion, die das Textelement in dem gewünschten Formularfenster enthält, ist nicht aktiv

FORM

Der Parameter FORM enthält den Namen eines Formulars, welches nicht gefunden werden konnte.

Mögliche Ursachen:

  • Das Formular ist nicht vorhanden

  • Es gibt keine aktive Version dieses Formulars

SAPscript sucht zuerst das Formular im aktuellen Mandanten unter der gewünschten Sprache. Ist das Formular nicht vorhanden, erfolgt ein weiterer Versuch mit der Originalsprache des Formulars. Falls auch diese Zugriff fehlschlägt, wird die Suche im Mandant 0 fortgesetzt, zuerst in der gewünschten Sprache, anschließend noch einmal in der Originalsprache.

UNOPENED

Es wurde beim Aufruf des Funktionsbausteins kein Formular angegeben. Dies bedeutet, daß die Elemente aus dem aktuell geöffneten Formular gelesen werden sollen.

Es ist kein Formular offen.