Show TOC

FunktionsdokumentationIMPORT_TEXT Dieses Dokument in der Navigationsstruktur finden

 

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   FILE   ITF-Text   in Tabelle ITF_LINES

  • Lokale RTF-Datei   FILE   ITF-Text   in Tabelle ITF_LINES

  • Lokale ASCII-Datei   FILE   ITF-Text   in Tabelle ITF_LINES

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

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 Word-Formatvorlagen auf anderslautenden Absatz- und Zeichenmarkierungen abgebildet werden. Umgesetzt wird

HEADER-TDSTYLE

SS

i

oder

HE

n

HEADER-TDFORM

ET

Funktionsaufruf:

Syntax Syntax

  1. 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	=
Ende des Quelltextes.
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 Hinweis

Groß-/Kleinschreibung ist für den Dateinamen relevant. Der Pfad der Datei sollte voll spezifiziert werden.

Ende des Hinweises.

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:

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:

ITF_LINES

Texttabelle des Ergebnistextes

Struktur: TLINE
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