START_FORM

Zwischen dem Aufruf der Funktionsbausteine OPEN_FORM und CLOSE_FORM können Sie verschiedene Formulare verwenden. Damit ist es möglich, mehrere unterschiedliche Formulare in eine Druckausgabe zusammenzufassen. Sie dürfen jedoch nur solche Formulare in einer Druckausgabe bündeln, die das gleiche Seitenformat besitzen.

Der Wechsel des Formulars erfolgt über den Funktionsbaustein START_FORM. Ein noch geöffnetes Formular muß zuvor mit END_FORM abgeschlossen werden.

Ist beim Aufruf von START_FORM kein Formularname angegeben, so wird das zuletzt geöffnete Formular erneut gestartet. Falls nach dem OPEN_FORM noch kein Formular aktiv war, so wird der Funktionsbaustein über die Ausnahme UNUSED verlassen.

Funktionsaufruf:

Syntax Syntax

CALL FUNCTION 'START_FORM'
	EXPORTING
		FORM		= SPACE
		LANGUAGE	= SPACE
		STARTPAGE	= SPACE
		PROGRAM		= SPACE
		ARCHIVE_INDEX	= SPACE
	IMPORTING
		LANGUAGE	=
	EXCEPTIONS
		FORM		=
		FORMAT		=
		UNENDED		=
		UNOPENED	=
		UNUSED		=

Ende des Quelltextes.

Export-Parameter:

FORM	Der Parameter enthält den Namens des Formulars, das für die Ausgabe dienen soll. Ist hier kein Formular angegeben, so wird das zuletzt aktive Formular erneut gestartet. Defaultwert: SPACE
LANGUAGE	Formulare sind sprachabhängig. Geben Sie hier die gewünschte Sprache ein. Ist das Formular in dieser Sprache nicht vorhanden, wird versucht, das Formular in der Originalsprache aufzurufen. Ist der Parameter LANGUAGE leer, so wird die Sprache des zuletzt aktiven Formulars verwendet. Bezugsfeld: THEAD-TDSPRAS Defaultwert: SY-LANGU
STARTPAGE	Normalerweise beginnt SAPscript mit der in der Formulardefinition angegebenen Startseite. Wenn Sie abweichend hiervon die Ausgabe mit einer anderen Formularseite beginnen möchten, so geben Sie hier den Namen der gewünschten Formularseite an. Wenn die gewünschte Seite nicht definiert ist, wird die im Formular definierte Startseite verwendet. Defaultwert: SPACE
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 aus dem Programm ersetzt, welches beim OPEN_FORM im Parameter OPTIONS angegeben ist (Feld TDPROGRAM). Wenn Sie hier einen Programmnamen übergeben, so werden die Programmsymbole bis zum nächsten END_FORM aus den Datenbereichen des hier angegebenen Programms ersetzt. Bezugsfeld: SY-REPID Defaultwert: SPACE
ARCHIVE_INDEX	Geben Sie hier eine Indexinformation für die zu archivierende Druckausgabe an. Diese Information (DARA-Zeile) wird mit der Druckausgabe im Archiv abgelegt. Damit können Sie im Archiv auf diese spezielle Druckausgabe über diese Indexinformation direkt zugreifen. Struktur: TOA_DARA Defaultwert: SPACE

Import-Parameter:

LANGUAGE

Der Parameter teilt Ihnen mit, welche Sprachvariante des Formulars tatsächlich verwendet wurde.

Bezugsfeld: THEAD-TDSPRAS

Exceptions:

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 dieser Zugriff fehlschlägt, wird die Suche im Mandant 0 fortgesetzt, zuerst in der gewünschten Sprache, anschließend noch einmal in der Originalsprache.
FORMAT	Innerhalb einer durch OPEN_FORM und CLOSE_FORM definierten Druckausgabe dürfen Sie nur Formulare verwenden, die das gleiche Seitenformat besitzen. Das aktuelle Formular besitzt ein Seitenformat, welches von den zuvor aufgerufenen Formularen abweicht. Fassen Sie nur solche Formulare in einem Spoolauftrag zusammen, die alle das gleiche Format besitzen (z.B. DINA4). Die Seitenorientierung spielt dabei keine Rolle, d.h. Formulare mit Seiten im Hochformat können mit solchen im Querformat gemischt werden.
UNENDED	Das zuletzt geöffnete Formular ist noch offen. Es muß zuerst mit einem END_FORM beendet oder die Formularausgabe muß mit OPEN_FORM abgeschlossen werden.
UNOPENED	Die aktuelle Formularfunktion konnte nicht durchgeführt werden, da die Formularausgabe noch nicht mit OPEN_FORM initialisiert wurde.
UNUSED	In einem der Parameter FORM oder LANGUAGE wurden nur Leerzeichen übergeben. Bisher war noch kein Formular geöffnet, dessen Name oder Sprache als Defaultwert übernommen werden konnte.