EXPORT_TEXT

Verwendung

Der Funktionsbaustein EXPORT_TEXT konvertiert einen ITF-Text in das gewünschte Format FORMAT_TYPE und speichert ihn anschließend in einer lokalen Datei ab. Folgende Konvertierungen stehen zur Verfügung:

ITF-Text in Tabelle ITF_LINES lokale ITF-Datei FILE
ITF-Text in Tabelle ITF_LINES lokale RTF-Datei FILE
ITF-Text in Tabelle ITF_LINES lokale ASCII-Datei FILE

Beim Export der Formate ASCII und RTF werden Textincludes und Kontrollstrukturen (/: IF, /: ELSE, /: ENDIF, /: CASE, /: WHEN, /: ENDCASE) aufgelöst sowie Text-, Standard- und Systemsymbole ersetzt.

Im einzelnen müssen folgende Angaben gemacht werden:

FORMAT_TYPE = 'ITF'

Da der Ergebnisdatei Textheader-Informationen vorangestellt werden (für nähere Informationen zur Form der Ergebnisdatei siehe Dokumentation zum Report RSTXSITF), sollte der Parameter HEADER gefüllt sein.

Die Parameter FORMATWIDTH, CODEPAGE, SSHEET und WITH_TAB sind unwirksam.

FORMAT_TYPE = 'RTF'

Da der Ergebnisdatei Informationen über Autor, Erstellungsdatum etc. vorangestellt werden, sollte der Parameter HEADER gefüllt sein. Unbedingt erforderlich aber ist die Angabe von Stil und Formular des Textes (HEADER-TDSTYLE und HEADER-TDFORM).

In FORMATWIDTH kann die Zeilenbreite des Ergebnistextes gewählt werden. Bei CODEPAGE müssen die Zeichensatznummern aus der Spooladministration angegeben werden. Bei der RTF-Konvertierung können die Zeichensätze 1103, 1110 oder 1133 gewählt werden. Alle anderen Zuweisungen werden ignoriert; stattdessen wird der Zeichensatz 1133 verwendet. Soll der erzeugte RTF-Text von WinWord gelesen werden, ist der Zeichensatz 1133 zu empfehlen. SSHEET und WITH_TAB werden im Anschluß erklärt.

FORMAT_TYPE = 'ASCII'

Alle ITF-Informationen gehen bei dieser Konvertierung verloren; einzige Formatierungen sind im Prinzip Newline und Tabulator. Eine gewisse Seitenformatierung kann durch entsprechende Wahl der Zeilenbreite FORMATWIDTH erreicht werden. Der ITF-Text kann in eine ASCII-Datei mit beliebigem Zeichensatz CODEPAGE (Nummer aus der Spooladministration) konvertiert werden.

Zusammenfassend ist also lediglich bei den Importparametern CODEPAGE und FORMATWIDTH eine Angabe sinnvoll und wirksam; notwendig ist FORMAT_TYPE.

Formatumsetzung

Wird der Parameter WITH_TAB = 'X' gesetzt, dann wird im Fall FORMAT_TYPE = 'RTF' eine Formatumsetzung angestoßen. In der Transaktion SE74 (Formatumsetzung) muß vorher angegeben werden, welche Absatz- und Zeichenmarkierungen auf anderslautende Word-Formatvorlagen abgebildet werden sollen.

Umgesetzt wird

HEADER-TDSTYLE
oder	i
HEADER-TDFORM	n	SSHEET

Funktionsaufruf:

CALL FUNCTION 'EXPORT_TEXT'
        EXPORTING
                CODEPAGE        = SPACE
                FILE            = ?...
                FORMATWIDTH     = 72
                FORMAT_TYPE     = 'RTF'
                HEADER          = SPACE
                SSHEET          = SPACE
                WITH_TAB        = SPACE
                TAB_SUBSTITUTE  = 'X09'
        TABLES
                ITF_LINES       = ?... 
        EXCEPTIONS
                DOWNLOAD_ERROR  =
                FILE_OPEN_ERROR =
                FILE_WRITE_ERROR =

Export-Parameter:

CODEPAGE	Hier müssen die Zeichensatznummern aus der Spooladministration angegeben werden. Bezugsfeld: TCP02-CPCODEPAGE Defaultwert: SPACE
FILE	Name der Datei, die auf dem Präsentationsserver erzeugt werden soll (bei Bedarf mit vorangestelltem Pfadnamen). Ist der Pfad nicht vorhanden oder kann die Datei nicht zum Schreiben geöffnet werden, so werden die entsprechenden Ausnahmen gesetzt. Bezugsfeld: RLGRAP-FILENAME
FORMATWIDTH	Zeilenbreite der Zieldatei Defaultwert: 72
FORMAT_TYPE	Format der Zieldatei ('ITF', 'RTF' oder 'ASCII') Defaultwert: 'RTF'
HEADER	Textheader des Ausgangstextes Der Textheader enthält beschreibende Informationen zu einem Textbaustein wie z.B. Kurztext, Ersteller, letzter Änderer usw. Struktur: THEAD
SSHEET	Name einer Druckformatvorlage (.dfv) bzw. Dokumentvorlage (.dot). Soll eine Formatumsetzung wirksam werden, muß hier der symbolische Name angegeben werden, für den in der Transaktion "Formatumsetzung" (SE74) eine Umsetzung in den relevanten SAPscript-Stil oder das -Formular gepflegt wurde. Zusätzlich muß der Parameter WITH_TAB auf 'X' gesetzt werden. Defaultwert: SPACE
WITH_TAB	Mögliche Eingabewerte sind 'X' (ja) oder ' ' (nein). Wird WITH_TAB = 'X' gesetzt und zusätzlich der Parameter SSHEET versorgt, dann erfolgt eine Umsetzung von Absatz- und Zeichenformatierungen. Quell- und Zielformat können ein SAPscript-Stil, ein SAPscript-Formular oder eine MS Word-Dokumentvorlage sein. Mithilfe der Transaktion SE74 (Formatumsetzung) muß die Abbildung der jeweiligen Absatz- und Zeichenmarkierungen und/oder Word-Formatvorlagen aufeinander angegeben werden. Defaultwert: SPACE
TAB_SUBSTITUTE	Ersetzungswert für den SAPscript-Tabulator. Dieser Parameter ist nur bei einer Konvertierung von ITF nach ASCII wirksam. In einem Zeichenfeld der Länge 5 wird der Ersetzungswert definiert. Das erste Zeichen gibt die Art der Ersetzung an: 'C' leitet die Ersetzung durch eine Zeichenkette maximaler Länge 4 ein. Beispiel TAB_SUBSTITUTE = 'C<<>>' "Vor Tabulator,,nach Tabulator" in SAPscript wird zu "Vor Tabulator<<>>nach Tabulator" in der ASCII-Datei. 'X' veranlaßt die Ersetzung durch ein oder zwei Binärzeichen. Beispiel TAB_SUBSTITUTE = 'X09_ _'. Der SAPscript-Tabulator ",," wird durch den Hexwert 09 ersetzt. 'Ein Leerzeichen '_' leitet die Ersetzung durch 1 bis 99 Leerzeichen ein. Beispiel TAB_SUBSTITUTE = '_ 8_ _ _'. "Vor Tabulator,,nach Tabulator" in SAPscript wird zu "Vor Tabulator_ _ _ _ _ _ _ _nach Tabulator" in der ASCII-Datei. Defaultwert: 'X09_ _'

Tabellen-Parameter:

ITF_LINES

Zu exportierende SAPscript-Texttabelle

Struktur: TLINE

Exceptions:

FILE_OPEN_ERROR	Datei kann nicht geöffnet werden
FILE_WRITE_ERROR	Datei kann nicht geschrieben werden
DOWNLOAD_ERROR	Sonstige Fehler beim Download der Datei