
Der Funktionsbaustein IMPORT_TEXT lädt eine lokale Datei ins SAP-System hoch und führt anschließend, abhängig vom Dateiformat FORMAT_TYPE, eine der drei folgenden Konvertierungen durch:
Lokale ITF-Datei in Tabelle ITF_LINES
Lokale RTF-Datei in Tabelle ITF_LINES
Lokale ASCII-Datei in Tabelle ITF_LINES
Im einzelnen müssen folgende Angaben gemacht werden:
Im einzelnen müssen folgende Angaben gemacht werden:FORMAT_TYPE = 'ITF'
Hier können ITF-Dateien mit Header-Informationen (für nähere Informationen zur Form dieser Datei siehe Dokumentation zum Report RSTXLITF), aber auch ITF-Texte ohne diesen Vorspann behandelt werden. Sind Headerinformationen vorangestellt, so werden sie in den Exportparameter NEWHEADER geschrieben. In diesem Fall erfolgt auch eine Formatierung: Die Zeilenbreite orientiert sich an den in der Tabelle TTXOB abgelegten Angaben für das vorliegende Textobjekt. Die Parameter HEADER, FORMATWIDTH, CODEPAGE, WORD_LANGU, SSHEET und WITH_TAB sind unwirksam.
FORMAT_TYPE = 'RTF'
Unter WORD_LANGU sollte die Sprache der verwendeten MS Word-Fassung angegeben werden, damit sprachabhängige Elemente in der RTF-Datei interpretiert werden können. Als Defaultwert wird die SAP-Systemsprache gesetzt. Die Parameter FORMATWIDTH und CODEPAGE sind unwirksam, SSHEET und WITH_TAB werden im Anschluß erklärt, HEADER ist nur im Zusammenhang mit einer Formatumsetzung ( WITH_TAB = 'X') interessant. In diesem Fall wird der Parameter NEWHEADER mit neuen, aktuellen Werten gefüllt.
FORMAT_TYPE = 'ASCII'
Carriage Return (x0D) und Linefeed (x0A) werden in Newline ('/ ') umgewandelt, Formfeed (x0c) auf das Kommando '/: NEW-PAGE' und der ASCII-Tabulator auf den ITF-Tabulator (',,') abgebildet.
Unter CODEPAGE muß der Zeichensatz der Quelldatei (d.h. seine Nummer in der Spooladministration) angegeben werden; die Zeichen werden dann in den System-Zeichensatz umgewandelt. Ist für CODEPAGE kein Wert vorhanden, findet keine Zeichensatzkonvertierung statt.
Die Parameter FORMATWIDTH, SSHEET, WITH_TAB, WORD_LANGU und HEADER werden nicht ausgewertet.
Formatumsetzung
FormatumsetzungWird 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 Word-Formatvorlagen auf anderslautenden Absatz- und Zeichenmarkierungen abgebildet werden. Umgesetzt wird
|
HEADER-TDSTYLE |
||
|
SS |
i |
oder |
|
HE |
n |
HEADER-TDFORM |
|
ET |
Funktionsaufruf:
Funktionsaufruf:
CALL FUNCTION 'IMPORT_TEXT'
EXPORTING
CODEPAGE = ?...
FILE = ?...
FORMAT_TYPE = 'ITF'
HEADER = SPACE
SSHEET = SPACE
WITH_TAB = SPACE
WORD_LANGU = SY-LANGU
IMPORTING
NEWHEADER =
TABLESITF_LINES = ?...
EXCEPTIONS
FILE_OPEN_ERROR =
FILE_READ_ERROR =
UPLOAD_ERROR =
Export-Parameter:
Export-Parameter:|
CODEPAGE |
Zeichensatz der Quelldatei. Hier müssen die Zeichensatznummern aus der Spooladministration angegeben werden. Bezugsfeld: TCP02-CPCODEPAGE |
|
FILE |
Name der Datei, die hochgeladen werden soll. Ist diese Datei nicht vorhanden oder nicht lesbar, so werden entsprechende Ausnahmen erzeugt. Hinweis
Groß-/Kleinschreibung ist für den Dateinamen relevant. Der Pfad der Datei sollte voll spezifiziert werden. Bezugsfeld: RLGRAP-FILENAME |
|
FORMAT_TYPE |
Format der Datei ('ITF', 'RTF' oder 'ASCII') Defaultwert: 'ITF' |
|
HEADER |
Struktur: THEAD Defaultwert: SPACE |
|
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 |
|
WORD_LANGU |
Nur für RTF-Konvertierung: Systemsprache von Word Dieser Parameter wird zu Zeit nicht ausgewertet! Defaultwert: SY-LANGU |
Import-Parameter:
Import-Parameter:|
NEWHEADER |
Textheader des SAPscript-Ergebnistextes Der Textheader enthält beschreibende Informationen zu einem Textbaustein wie z.B. Kurztext, Ersteller, letzter Änderer usw. Der Aufbau dieser Struktur ist in der Tabelle THEAD festgelegt. Struktur: THEAD |
Tabellen-Parameter:
Tabellen-Parameter:|
ITF_LINES |
Texttabelle des Ergebnistextes Struktur: TLINE |
Exceptions:
Exceptions:|
FILE_OPEN_ERROR |
Datei kann nicht geöffnet werden |
|
FILE_READ_ERROR |
Datei kann nicht (vollständig) gelesen werden. Mögliche Ursache: Lesefehler des Betriebssystems (kein SAP-Fehler) oder Upload nicht komplett bei falscher GUI-Installation (Arbeitsverzeichnis schreibgeschützt) |
|
UPLOAD_ERROR |
Sonstige Fehler beim Upload der Datei |