Druckparameter müssen vor dem Beginn des Druckens festgelegt werden.

Beim Drucken von Listen nach ihrer Erstellung verwendet das System das in den Druckparametern festgelegte Druckformat, um die Liste auf die Druckseiten aufzuteilen und eventuell zu beschneiden.

Beim Drucken von Listen während ihrer Erstellung, verwendet das System das Druckformat zur eigentlichen Listenformatierung im Programm.

Druckparameter können interaktiv durch den Benutzer oder intern im Programm übergeben werden.

Für jedes Drucken benötigt das Spool-System einen vollständigen und konsistenten Satz Druckparameter. In ABAP repräsentieren Feldleisten der Struktur PRI_PARAMS (ABAP-Dictionary) einen Satz Druckparameter.

Falls die Druckparameter interaktiv übergeben werden, erscheint nach dem Start des ausführbaren Programms (Report) ein Dialogfenster, auf dem die wichtigsten Druckparameter abgefragt werden.

Die folgende Tabelle zeigt die Zuordnung zwischen den Eingabefeldern des Druckparameter-Dialogfensters und den Komponenten von PRI_PARAMS.

Das Druckparameter-Dialogfenster überprüft die Eingabewerte auf ihre Konsistenz und Vollständigkeit. Mit inkonsistenten Druckparametern, z.B. Ausgabeformate, die für das angegebene Ausgabegerät nicht zur Verfügung stehen, kann nicht gedruckt werden.

Zusätzlich zu den Druckparametern gibt es noch Archivierungsparameter. Diese müssen nur angegeben werden, wenn die optische Archivierung eingeschaltet ist (Archivierungsmodus ist Archivieren oder Drucken und Archivieren). In ABAP repräsentieren Feldleisten der Struktur ARC_PARAMS (ABAP-Dictionary) einen Satz Archivierungsparameter

Die folgende Tabelle zeigt die Zuordnung zwischen den Eingabefeldern des Druckparameter-Dialogfensters und den Komponenten von ARC_PARAMS:

Das Druckparameter-Dialogfenster erscheint immer nach der Auswahl

• Ausführen und Drucken auf dem Selektionsbild

• Drucken auf der Listenoberfläche

Sie können das Dialogfenster für diese Benutzeraktionen nicht unterbinden .

Sie können in Ihrem Programm lediglich die Vorgabewerte für das Druckparameter-Dialogfenster setzen. Hierzu verwenden Sie den Funktionsbaustein SET_PRINT_PARAMETERS. Dieser Funktionsbaustein hat keine Exportparameter und wirkt nur auf das Drucken von Listen, das durch obige Benutzeraktionen gestartet wird.

Für Ausführen und Drucken auf dem Selektionsbild müssen Sie SET_PRINT_PARAMETERS spätestens zum Zeitpunkt AT SELECTION-SCREEN aufrufen. Für Drucken auf der Listenoberfläche muß der Funktionsbaustein spätestens vor dem Senden der Liste zum Ausgabebild aufgerufen werden.

Die folgende Tabelle listet den Zusammenhang der Importparameter von SET_PRINT_PARAMETERS mit den Druck- und Archivierungsparametern auf:

Den Parametern IN_PARAMETERS und IN_ARCHIVE_PARAMETERS dürfen Sie nur Feldleisten der Struktur PRI_PARAMS bzw. ARC_PARAMS zuweisen. Diese Feldleisten müssen entweder initial sein oder die Ergebnisse des Funktionsbausteins GET_PRINT_PARAMETERS.

Der Parameter FOOT_LINE wird nur bei der Auswahl Drucken auf der Listenoberfläche berücksichtigt. Ist dieser Parameter gleich 'X', wird eine systemdefinierte Fußzeile auf jeder Seite ausgegeben.

Beim Drucken über die Druckanweisungen

• NEW-PAGE PRINT ON

• SUBMIT ... TO SAP-SPOOL

• CALL FUNCTION 'JOB-SUBMIT'

setzen Sie die Druckparameter programmgesteuert über die entsprechenden Zusätze der Druckanweisungen. Sie können dabei einen Benutzerdialog über das Druckparameter-Dialogfenster führen oder diesen unterbinden.

Um die Parameter ordnungsgemäß und vollständig an das Spool-System zu senden, empfiehlt es sich, immer den gesamten Parametersatz in den Anweisungen zu übergeben. Der Funktionsbaustein GET_PRINT_PARAMETERS dient der Erstellung eines solchen Satzes.

• Entkopplung des Benutzerdialogs von den eigentlichen Druckanweisungen.

GET_PRINT_PARAMETERS führt folgende Funktionen aus:

• Über die Importparameter können Sie die Druck- und Archivierungsparameter setzen. Der Funktionsbaustein holt sich alle notwendigen nicht über Importparameter gesetzten Werte aus dem System. Diese Werte entsprechen den Vorgabewerten auf dem Druckparameter-Dialogfenster, von denen einige im Benutzerstammsatz gesetzt sind.

• Der Funktionsbaustein führt standardmäßig einen Benutzerdialog über das Druckparameter-Dialogfenster. Der Benutzer kann dort die durch Importparameter oder Vorgabewerte gefüllten Felder überschreiben.

• Der Funktionsbaustein stellt abhängige Parameter automatisch ein. Bei der Eingabe eines Importparameters, z.B einer bestimmten Aufbereitung, werden davon abhängige Parameter, z.B Zeilen und Spalten, die nicht als Importparameter eingegeben werden, automatisch gesetzt.

• Der Funktionsbaustein liefert vollständige Sätze von Druck- und Archivierungsparametern als Exportparameter, die Sie mit den Zusätzen der Druckanweisungen an das Spool-System übergeben können. Diese Sätze sind entweder vollständig oder leer.

Der Funktionsbaustein GET_PRINT_PARAMETERS hat die gleichen Importparameter wie der Funktionsbaustein SET_PRINT_PARAMETERS mit folgenden Ausnahmen:

GET_PRINT_PARAMETERS hat keinen Importparameter FOOT_LINE, da dieser nur nach der Auswahl von Drucken auf dem Ausgabebild gebraucht wird.

GET_PRINT_PARAMETERS hat folgende zusätzliche Importparameter:

• MODE

• NO_DIALOG

bestimmt, ob das Dialogfenster angezeigt wird oder nicht. Enthält NO_DIALOG den Wert 'X', wird kein Benutzerdialog geführt.

Der Funktionsbaustein GET_PRINT_PARAMETERS hat folgende Exportparameter:

• OUT_PARAMETERS

• OUT_ARCHIVE_PARAMETERS

• VALID

Dieser Parameter zeigt an, ob die Sätze OUT_PARAMETERS und OUT_ARCHIVE_PARAMETERS vollständig oder leer sind. Enthält VALID den Wert 'X', sind die Parameterätze vollständig und können an das Spool-System übergeben werden. Enthält VALID den Wert SPACE, sind die Parametersätze leer. VALID enthält genau dann den Wert SPACE, falls der Benutzer den Benutzerdialog abbricht. Sie sollten deshalb nach einem Benutzerdialog immer VALID abfragen. Wird kein Benutzerdialog geführt, enthält VALID den Wert 'X'.

Der Funktionsbaustein GET_PRINT_PARAMETERS hat folgende Ausnahmeparameter:

• ARCHIVE_INFO_NOT_FOUND

• INVALID_PRINT_PARAMS, INVALID_ARCHIVE_PARAMS

Der Funktionsbaustein GET_PRINT_PARAMETERS ist die einzige erlaubte Methode, den Druck- und Archivierungsparametersätzen Werte zuzuweisen. Mit GET_PRINT_PARAMETERS gefüllte Parametersätze, die an das Spool-System übergeben werden, führen während des Druckens nicht zu Programmabbrüchen. Dies ist besonders bei der Hintergrundverarbeitung wichtig. Voraussetzung hierfür ist allerdings, daß der Exportparameter VALID ungleich SPACE ist und keine Ausnahme erzeugt wurde.

Beachten Sie, daß bei GET_PRINT_PARAMETERS die Vollständigkeit der Parametersätze und damit Lauffähigkeit des Druckauftrags im Vordergrund stehen. GET_PRINT_PARAMETERS führt keinen vollständigen Konsistenztest wie das Druckparameter-Dialogfenster durch. Konsistenzen werden nur dort hergestellt, wo es für die Lauffähigkeit des Druckauftrags von Bedeutung ist. Inkonsistente Eingaben werden teilweise ignoriert, teilweise ersetzt. Beispielsweise können Sie

• über die Importparameter LINE_SIZE, LINE_COUNT Werte setzen, die nicht zu dem Parameter LAYOUT passen. Bei einem Benutzerdialog wird diese Inkonsitenz erkannt. Ohne Benutzerdialog können diese Angaben zu abgeschnittenen Ausdrucken führen.

• in den Importparameter DESTINATION einen ungültigen Wert und gleichzeitig IMMEDIATELY auf 'X' setzen. In diesem Fall ersetzt der Funktionsbaustein das Ausgabegerät durch einen Standardwert (LP01) und setzt die Komponente PRIMM auf SPACE. Dadurch wird der Auftrag mit zum Standarddrucker passenden Einstellungen im Spool-System gespeichert.