OPEN_FORM

Der Baustein OPEN_FORM öffnet den Formulardruck. Diese Funktion muß aufgerufen werden, bevor mit den anderen Formularfunktionen (WRITE_FORM, START_FORM, CONTROL_FORM ...) gearbeitet werden kann.

Die Angabe eines Formularnamens beim Öffnen ist nicht obligatorisch. Wenn kein Formular angegeben ist, muß vor einer Ausgabe ein Formular mit dem Funktionsbaustein START_FORM geöffnet werden.

Der Formulardruck muß mit einem CLOSE_FORM beendet werden. Ist dies nicht der Fall, wird nichts ausgegeben bzw. auf dem Bildschirm angezeigt.

Innerhalb eines Programms sind mehrere OPEN_FORM.. CLOSE_FORM Paare zugelassen. Damit ist es möglich, daß von einem Programm die Ausgaben in mehrere unterschiedliche Spoolaufträge geschrieben werden können

Funktionsaufruf:

Syntax Syntax

CALL FUNCTION 'OPEN_FORM'
	EXPORTING
		FORM		= SPACE
		LANGUAGE	= SY-LANGU
		DEVICE		= 'PRINTER'
		DIALOG		= 'X'
		OPTIONS		= SPACE
		APPLICATION	= 'TX'
		ARCHIVE_INDEX	= SPACE
		ARCHIVE_PARAMS	= SPACE
	IMPORTING
		LANGUAGE	=
		RESULT		=
		NEW_ARCHIVE_PARAMS =
	EXCEPTIONS
		CANCELED	=
		DEVICE		=
		FORM		=
		OPTIONS		=
		UNCLOSED	=

Ende des Quelltextes.

Export-Parameter:

FORM	Sie können in diesem Parameter den Namen eines Formulars angeben, welches dann die Ausgabeaufbereitung steuert. Nach Aufruf des OPEN_FORM können Sie sofort mit weiteren Funktionsbausteinen in dieses Formular ausgeben. Falls hier nichts angegeben ist, muß vor dem Aufruf der eigentlichen Ausgabefunktionen ein START_FORM mit einem gültigen Formularnamen erfolgen. 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. Bezugsfeld: THEAD-TDSPRAS Defaultwert: SY-LANGU
DEVICE	SAPscript kann die Ausgabe für verschiedene Gerätetypen aufbereiten. Spezifizieren Sie deshalb hier den gewünschten Gerätetyp. Mögliche Werte: 'PRINTER' Drucker-Ausgabe 'TELEX' Telex-Ausgabe 'TELEFAX' Telefax-Ausgabe 'ABAP' Bildschirmaufbereitung als ABAP-Liste (Oberfläche des rufenden Programms) 'SCREEN' Bildachirmaufbereitung als ABAP-Liste (Oberfläche unter Kontrolle von SAPscript, über Parameter APPLICATION einstellbar) Die Druckausgabe bei PRINTER, TELEX oder TELEFAX kann auch in als Druckansicht auf dem Bildschirm angezeigt werden. Dies kann per Programm durch setzen des Feldes TDPREVIEW (Struktur ITCPO) im Parameter OPTIONS erfolgen, oder gesteuert durch den Benutzer auf dem Drucksteuerbild. Die für die Faxausgabe vorgesehenen Felder (Struktur ITCPO) TDSENDTIME und TDSENDDATE sind für Zukünftige Erweiterungen und werden z.Zt. nicht verwendet. Defaultwert: 'PRINTER'
DIALOG	Mit dem Parameter DIALOG steuern Sie, ob vor der Druckausgabe ein Dialog-Fenster erscheinen soll, in dem der Benutzer verschiedene Spoolparameter für die Druckausgabe einstellen kann. Mögliche Werte: ' ' Kein Drucksteuerbild anzeigen 'X' Druckdsteuerbild einblenden Defaultwert: 'X'
OPTIONS	Über den Parameter OPTIONS können Sie verschiedene Einstellungen für die Druckausgabe festlegen. Der Aufbau dieser Feldleiste wird durch die Struktur ITCPO beschrieben. Über das Drucksteuerbild können einige der definierten Einstellungen vom Benutzer verändert werden. Struktur: TCPO Defaultwert: SPACE
APPLICATION	Für den Gerätetyp SCREEN wird die Aufbereitung des Textes am Bildschirm angezeigt. Dazu ist eine CUA-Oberfläche notwendig, in der die verschiedenen Menüpunkte definiert sind. Das gleiche gilt, wenn eine Druckansicht auf dem Bildschirm für die anderen Gerätetypen gewünscht wird. Geben Sie hier eine der von SAPscript bereitgestellten Oberflächenkürzel an. Normalerweise wird diese Oberfläche derjenigen entsprechend, die auch in der Tabelle TTXOB dem jeweiligen Textobjekt zugeordnet sind. Bezugsfeld: TTXOB-TDAPPL Defaultwert: 'TX'
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 diese im Archiv auf diese spezielle Druckausgabe über diese Indexinformation direkt zugreifen. Struktur: TOA_DARA Defaultwert: SPACE
ARCHIVE_PARAMS	Die hier übergebenen Einstellungen werden beim Archivieren der Ausgabe ausgewertet. Der Aufbau der Archivparameter ist als ABAP-Dictionary-Struktur ARC_PARAMS festgelegt. Struktur: ARC_PARAMS Defaultwert: SPACE

Import-Parameter:

LANGUAGE

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

Bezugsfeld: THEAD-TDSPRAS

RESULT

Der Parameter enthält Ergebnisse der Druckaufbereitung. Außerdem können Sie durch den Vergleich der entsprechenden Felder des Parameters OPTIONS mit denen des Parameters RESULT feststellen, ob der Benutzer bestimmte Einstellungen auf dem Drucksteuerungsbild verändert hat.

Struktur: ITCPP

NEW_ARCHIVE_PARAMS

Der Parameter enthält Ergebnisse der Archivierung, u.a. auch. die durch den Benutzer im Drucksteuerbild veränderten Archivparameter. Der Aufbau ist als ABAP-Dictionary-Struktur ARC_PARAMS festgelegt.

Struktur: ARC_PARAMS

Exceptions:

CANCELED	Beim Start der SAPscript-Druckaufbereitung wurde ein Optionsbild ausgegeben, auf dem der Benutzer Einstellungen für die weitere Ausgabe vornehmen kann wie z.B.: Festlegen des Druckernamens Informationen für Deckblatt Seitenauswahl Anzahl Kopien etc. Die möglichen Folgeaktionen, die von diesem Bildschirm aus möglich sind, wurden nicht aufgerufen, sondern die weitere Ausgabeaufbereitung wurde abgebrochen. Der Funktionsbaustein wird ohne weitere Aktivität beendet. Es ist kein Formular mehr für die Ausgabe geöffnet.
DEVICE	In dem Parameter DEVICE wurde ein ungültiger Gerätetyp angegeben.
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.
OPTIONS	Über den Parameter OPTIONS wurde Werte von Aufbereitungsoptionen übergeben, die ungültig sind. Mögliche Fehler: Das im Feld TDDEST übergebene Ausgabegerät ist nicht vorhanden Das Feld TDPAGESLCT zur Auswahl der zu druckenden Seiten enthält unzulässige Zeichen
UNCLOSED	Es soll ein neues Formular eröffnet werden, obwohl noch ein altes Formular aktiv ist. Dieses Formular muß zuerst abgeschlossen werden (CLOSE_FORM oder END_FORM).