CONVERT_OTF_MEMORY

Mit dem Parameter DEVICE=OTF_MEM bei der Funktion OPEN_FORM kann die Ausgabe der SAPscript-Textverarbeitung in einen Puffer erfolgen, anstatt z.B. einen Spoolauftrag zu erzeugen. Der Text wird in diesem Fall intern für das Pseudogerät SCREEN aufbereitet und das Ergebnis im Puffer abgelegt.

Der Puffer wird mit diesem Funktionsbaustein CONVERT_OTF_MEMORY ausgelesen und über den Tabellenparameter LINES zurückgegeben. Das Format des Textes in dieser Tabelle wird durch den Parameter FORMAT bestimmt. Die in der Tabelle LINES im Feld LINES-TDLINE belegte maximale Zeilenbreite wird vom Parameter MAX_LINEWIDTH gesteuert.

Als Wert für den FORMAT-Parameter ist z.Zt. nur 'ASCII' unterstützt.

Beim Format ASCII enthält die LINES-Tabelle im Feld LINES-TDLINE den auszugebenden Text (ohne jegliche Steuerzeichen), auf die angegebene maximale Zeilenbreite umgebrochen. Das Feld LINES-TDFORMAT enthält das Kennzeichen für eine SAPscript-Langzeile mit Zeilenumbruch (/=), wenn ein Zeilenbeginn angezeigt werden soll. Zeilen, die in diesem Feld nur das Langzeilenkennzeichen (=) enthalten, sind Fortsetzungen der vorigen Zeile. Im Format ASCII werden Seitenumbrüche nicht angezeigt.

Der beim Format ASCII zurückgegebene Text kann als SAPscript-Text aufgefaßt werden, indem das Feld LINES-TDFORMAT als SAPscript-Formatspalte interpretiert wird. Der Text kann jedoch ebenso als "RAW-Text" aufgefaßt werden indem man das Feld LINES-TDFORMAT ignoriert und jede Zeile der Tabelle LINES (Feld LINES-TDLINE) als eine Textzeile interpretiert.

Funktionsaufruf:

Syntax Syntax

CALL FUNCTION 'CONVERT_OTF_MEMORY'
EXPORTING FORMAT = 'ASCII'
MAX_LINEWIDTH = 132
IMPORTING BIN_FILESIZE = 
TABLES LINES = ?...
EXCEPTIONS MEMORY_EMPTY =
ERR_MAX_LINEWIDTH =
ERR_FORMAT =
ERR_CONV_NOT_POSSIBLE =

Ende des Quelltextes.

Export-Parameter:

FORMAT

Definiert das Format, in welches die SAPscript-OTF-Ausgabe konvertiert werden soll. Zur Zeit ist nur eine Konvertierung in das ASCII-Format möglich.

Defaultwert: 'ASCII'

MAX_LINEWIDTH

Geben Sie hier die maximale Zeilenbreite an, die eine konvertierte Textzeile in der Tabelle LINES haben darf.

Die maximale Zeilenlänge darf nicht kleiner als 2 oder größer als 132 sein.

Defaultwert: 132

Import-Parameter:

BIN_FILESIZE

Bei Binärformat: Anzahl der Bytes in LINES

Tabellen-Parameter:

LINES

In dieser Tabelle werden die konvertierten Textzeilen zurückgegeben.

Struktur: TLINE

Exceptions:

MEMORY_EMPTY	Das Memory ist leer. Mögliche Ursachen: Bei der Ausgabeaufbereitung ist ein Fehler aufgetreten und das Memory wurde nicht gefüllt Beim Lesen des Memory trat ein Fehler auf
ERR_MAX_LINEWIDTH	Die im Parameter MAX_LINEWIDTH übergebene Zeilenbreite liegt nicht zwischen 2 und 132.
ERR_FORMAT	Der Parameter FORMAT enthält ein Zielformat, in das SAPscript die OTF-Ausgabe nicht konvertieren kann.
ERR_CONV_NOT_POSSIBLE	Beim Konvertieren des Textes vom SAPscript-OTF-Format in das gewünschte Zielformat trat ein Fehler auf. Die Konvertierung wird abgebrochen.