PRINT_TEXT

Der in den Parameter HEADER und LINES enthaltene Textbaustein wird für ein Ausgabegerät aufbereitet und ausgegeben. Die dafür notwendigen Angaben von Stil und Formular werden den Feldern TDSTYLE bzw. TDFORM des Textheaders entnommen.

Über den Parameter OPTIONS können Sie verschiedene Einstellungen für die Aufbereitung und die Druckausgabe einstellen. Dazu müssen Sie bei diesem Parameter eine Feldleiste angeben, die die Struktur ITCPO besitzt, und deren Feldwerte mit den von Ihnen gewünschten Werten versehen sind. Einige dieser Einstellungen kann der Benutzer auch noch auf dem optionalen Drucksteuerbild ändern (Parameter DIALOG). Dieses Drucksteuerbild erscheint auch dann, wenn notwendige Druckeinstellungen im Parameter OPTIONS oder dem Benutzerstammsatz nicht oder falsch angegeben sind.

Bevor ein Text gedruckt wird, können Sie ihn fertig aufbereitet am Bildschirm anschauen (programmgesteuert über Feld TDPREVIEW im Parameter OPTIONS oder explizit durch den Benutzer auf dem Drucksteuerbild).

Hat das Feld TDFORMAT im Textheader den Wert SPACE, wird die Aufbereitung vom SAPscript-Composer vorgenommen. Im anderen Fall wird der Funktionsbaustein PRINT_TEXT_FORMAT_xxx aufgerufen, wobei xxx für den Inhalt des Feldes TDFORMAT steht. Dieser Funktionsbaustein muß dann die für dieses Textformat vorgesehenen Textverarbeitung aufrufen, welche für die Druckausgabe des entsprechenden Formates vorgesehen ist. Es hängt von diesem Schnittstellenbaustein und der aufgerufenen Textverarbeitung ab, welche der beim PRINT_TEXT übergebenen Parameter ausgewertet werden.

Funktionsaufruf:

Syntax Syntax

CALL FUNCTION 'PRINT_TEXT'
	EXPORTING
		HEADER		= ?...
		DEVICE		= 'PRINTER'
		DIALOG		= 'X'
		OPTIONS		= SPACE
		APPLICATION	= 'TX'
		ARCHIVE_INDEX	= SPACE
		ARCHIVE_PARAMS	= SPACE
	IMPORTING
		RESULT		=
		NEW_ARCHIVE_PARAMS =
		TABLES LINES	= ?...
		OTFDATA		= ?...
	EXCEPTIONS
		CANCELED	=
		DEVICE		=
		FORM		=
		OPTIONS		=
		UNCLOSED	=
		UNKNOWN		=
		FORMAT		=
		TEXTFORMAT	=
		COMMUNICATION	=

Ende des Quelltextes.

Export-Parameter:

HEADER	Dieser Parameter enthält den Header des Textbausteins, für den Sie die Druckaufbereitung erstellen möchten. Für die Aufbereitung werden aus dem Header nur die Angaben in den Feldern TDSTYLE und TDFORM verwendet. Struktur: THEAD
DEVICE	SAPscript kann die Ausgabe für verschiedene Gerätetypen aufbereiten. Spezifizieren Sie deshalb hier den gewünschten Gerätetyp. Mögliche Werte: 'PRINTER' Druckerausgabe 'TELEX' Telexausgabe 'TELEFAX' Telefaxausgabe 'ABAP' Bildschirmaufbereitung als ABAP-Liste (Oberfläche des rufenden Programms) 'SCREEN' Bildschirmaufbereitung 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 im Parameter OPTIONS erfolgen, oder gesteuert durch den Benutzer auf dem Drucksteuerbild. Defaultwert: 'PRINTER'
DIALOG	Mit dem Parameter DIALOG steuern Sie, ob vor der Druckausgabe ein Dialogfenster 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:ITCPO 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:

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

Tabellen-Parameter:

LINES

Hier müssen Sie die Tabelle mit den zu druckenden Textzeilen angeben.

Struktur: TLINE

OTFDATA

Wenn beim Parameter OPTIONS das Feld TDGETOTF mit 'X' belegt wurde, wird über den optionalen Tabellenparameter OTFDATA die aufbereitete Ausgabe im OTF-Format zurückgegeben.

In diesem Fall wird keine Druckausgabe, Bildschirmanzeige oder Fax/Telex/Teletex-Ausgabe durchgeführt.

Struktur: ITCOO

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.
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.
OPTIONS	Über den Parameter OPTIONS wurden 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).
TEXTFORMAT	Die an den Funktionsbaustein übergebenen Textzeilen liegen in einem Format vor, das in der aktuellen Umgebung nicht verarbeitet werden kann. Das Format ist im Textheader in dem Feld TDTEXTTYPE abgelegt. Mögliche Ursachen für das Auftreten dieser Ausnahme können sein: Das Textformat wird überhaupt nicht unterstützt Das Textformat kann auf dem aktuellen Frontend nicht verarbeitet werden, da hier die dazu notwendige Textverarbeitung nicht installiert ist. Das Textformat kann unter Batch-Input-Bedingungen nicht verarbeitet werden, da das dafür zuständige Textverarbeitungsprogramm nicht Batch-Input-fähig ist. Das Textformat kann nicht im Hintergrund verarbeitet werden, da das dafür zuständige Textverarbeitungsprogramm nicht aus Hintergrundabläufen angestoßen werden kann. etc.
COMMUNICATION	Das Feld TDTEXTTYPE des Textheaders ist nicht leer, d.h. es enthält die Angabe eines Textformats, welches den Aufruf eines externen Textverarbeitungsprogramms erfordert. Beim Aufruf dieser Textverarbeitung ist ein Fehler aufgetreten. Mögliche Ursachen: Die externe Textverarbeitung ist auf dem Frontend nicht oder falsch installiert Die Textverarbeitung konnte nicht gestartet werden Bei der Kommunikation mit dieser Textverarbeitung trat ein Fehler auf Bei der Übertragung der Textdaten trat ein Fehler auf etc. Zur Bearbeitung von Texten in einem Fremdformat werden intern die Funktionsbausteine EDIT_TEXT_FORMAT_xxx bzw. PRINT_TEXT_FORMAT_xxx aufgerufen, wobei xxx der Inhalt des Feldes TDTEXTTYPE ist. Diese Funktionsbausteine enden mit der Ausnahme COMMUNICATION. SAPscript reicht diese Abbruchmeldung ohne weitere Analyse an das Druckprogramm weiter.
UNKNOWN	Es trat ein Fehler auf, der aber nicht näher spezifiziert ist. Diese Ausnahme ist nur beim Funktionsbaustein PRINT_TEXT vorgesehen, der in früheren Releases alle Fehler nur über diese Ausnahme zurückmeldete. Die Ausnahmebehandlung des PRINT_TEXT wurde inzwischen so erweitert, daß die relevanten Fehlermeldungen durch eigene Ausnahmen abgefangen werden.