Show TOC Anfang des Inhaltsbereichs

 CONVERT_TEXT_R2   Dokument im Navigationsbaum lokalisieren

Der Funktionsbaustein konvertiert Texte, zwischen dem SAP R/2-Textformat und dem SAPscript-Format. Zur Zeit ist nur die Umsetzrichtung R/2 nach SAPscript implementiert.

Neben der Umsetzung des Formataufbaus von Textzeilen sind folgende Eigenschaften eines R/2-Textes zu betrachten:

·        Zeilenattribute

·        Steuerkommandos

·        Symbole

Bei der Umsetzung können verschiedene Inkompatibilitäten auftreten. Diese Inkompatibilitäten werden in Stufen zusammengefaßt. Über den Parameter ERRORLEVEL wird die Gradnummer der schwersten Inkompatibilität zurückgegeben.

 

Zeilenformat

Das Zeilenformat in R/2- und SAPscript-Texten ist ähnlich. Beide Zeilen bestehen aus einem Feld, welches ein Zeilenformat enthält und einem Feld mit dem eigentlichen Inhalt. Die Umsetzung des Zeilenformates wird unter dem Punkt Zeilenattribute beschrieben.

Eine Textzeile in R/2 kann aus maximal 220 Zeichen bestehen, in SAPscript ist der Zeileninhalt auf 132 Zeichen beschränkt. Besteht eine R/2-Textzeile aus mehr als 132 Zeichen, so wird der Rest in eine Folgezeile mit leerem Absatzformat übertragen.

 

Zeilenattribute

SAPscript unterscheidet nicht zwischen fixen und variablen Zeilen, sondern kennt im R/2-Sinne nur variable Zeilen. Für die Umsetzung der R/2-Zeilenformate gelten folgende Regeln:

Bei Zeilen mit dem Attribut A und F beginnt immer ein neuer SAPscript-Absatz.

Unmittelbar aufeinanderfolgende Zeilen mit dem Attribut V werden als ein Absatz angesehen. Steht vor der ersten V-Zeile eine Zeile mit dem Attribut F, so ist die erste V-Zeile der Beginn eines neuen SAPscript-Absatzes. Hat die vor dem V-Block stehende Zeile das Attribut A, so werden die V-Zeilen als Fortsetzung der A-Zeile angesehen und kein neuer Absatz angefangen.

Standardmäßig wird für alle Absätze der SAPscript-Defaultabsatz '*' eingesetzt. Sie können jedoch über die Parameter PARAGRAPH_AV und PARAGRAPH_F einen anderen Absatz vorgeben.

 

Steuerkommandos

Die folgenden Steuerkommandos werden nicht umgesetzt, da es keine entsprechenden SAPscript-Äquivalente gibt:

.nlf

 nächste 2 Zeilen übereinander drucken

.psz

Anzahl Zeilen pro Seite einstellen

.lpi

Zeilenabstand definieren

.prn

Steuerkommando für Drucker ausgebe

off

linken Rand für Zeilen mit Attribut V einstellen

.nam

Name des Spoolfiles festlegen

.set

Wert für Zahl- und Kapitel-Variable definieren

 

 

Die restlichen R/2-Steuerkommandos werden wie folgt auf SAPscript-Kommandos abgebildet:

.ifi &symbol

/: IF &symbol(I)& EQ '  '

.ifn &symbol

/: IF &symbol& NE '  '

.abs <n>

/: PROTECT

Inhalt der nächsten <n> Zeilen aus R/2-Text

/: ENDPROTECT

.def &symbol=<wert>

/: DEFINE &symbol& = '<wert>

.pct=<wert>

/: DEFINE &pct& = '<wert>'

.top <textnr>

/: TOP

/: INCLUDE <textnr>

/: ENDTOP

.bot <textnr>

/: BOTTOM

/: INCLUDE <textnr>

/: ENDBOTTOM

 

Symbole

Symbole werden einerseits auf die andere Syntax von SAPscript umgestellt, andererseits sind auch die Bezeichnungen von R/2-Datenbanksymbolen, die sich aus Tabellenname/Segment-Id und Feldname zusammensetzen, auf die in R/3 anderslautenden Tabellen und Felder umzusetzen.

Bei der Syntax sind alle Aufbereitungsoptionen (Offset, Länge, Vortext) auch mit SAPscript realisierbar, bis auf die Umsetzung des Symbolwertes über eine Tabelle.

Die Zuordnung des Symbolnamens von R/2-Datenbanksymbolen zu den jeweiligen SAP-Bezeichnungen erfolgt über den Aufruf des Funktionsbausteins RS3L_CONVERT_FIELDNAME. Für weitere Informationen lesen Sie bitte die Dokumentation zu diesem Funktionsbaustein.

Die Parameter SOURCE_SYSTEM, SOURCE_RELEASE, SOURCE_OBJECT, DESTINATION_TABLE und IGNORE_ALIASNAMES werden ohne weitere Interpretation an diesen Funktionsbaustein durchgereicht.

Die R/2-Symbole für Kapitelvariable (p0..p3) werden nicht nach SAPscript übernommen.

 

Funktionsaufruf:

 

CALL FUNCTION  'CONVERT_TEXT_R2'

     EXPORTING  HEADER_R2         = ?...

                HEADER            = ?...

                DIRECTION         = 'IMPORT'

                PARAGRAPH_AV      = '* '

                PARAGRAPH_F       = '* '

                INCLUDE_ID        = 'ST  '

                INCLUDE_ZEROS     = 'X'

                INCLUDE_PREFIX    = SPACE

                COMMENT_LINES     = 'X'

                SOURCE_SYSTEM     = 'SAP'

                SOURCE_RELEASE    = SPACE

                SOURCE_OBJECT     = SPACE

                DESTINATION_TABLE = SPACE

                IGNORE_ALIASNAMES = SPACE

                ERROR_COMMENTS    = SPACE

     IMPORTING  NEWHEADER_R2      =

                NEWHEADER         =

                NEWSTYLE          =

                ERRORLEVEL        =

     TABLES     LINES_R2          = ?...

                LINES             = ?...

 

Export-Parameter:

 

HEADER_R2

Der Parameter muß den Textheader des R/2-Textes enthalten.

Struktur: TEXTH

HEADER

Der Parameter muß den Textheader des SAPscript-Textes enthalten.

Struktur: THEAD

DIRECTION

Der Parameter legt die Umsetzrichtung fest. Zur Zeit ist nur der Wert IMPORT unterstützt, d.h. eine Konvertierung von Texten im R/2-Format in das SAPscript-Format

Defaultwert: 'IMPORT'

PARAGRAPH_AV

Angabe des Absatzformats, das beim Anfang von R/2-Zeilenblöcken mit dem Attribut A oder V verwendet werden soll. Wird der Parameter nicht angegeben oder hat er als Wert nur Leerzeichen, so wird der Default-Absatz '*' verwendet.

Bezugsfeld: TLINE-TDFORMAT

Defaultwert: '*'

PARAGRAPH_F

Angabe des Absatzformats, das für jede R/2-Zeile mit dem Zeilenattribut F verwendet werden soll. Wird der Parameter nicht angegeben oder hat er als Wert nur Leerzeichen, so wird der Default-Absatz '*' verwendet.

Bezugsfeld: TLINE-TDFORMAT

Defaultwert: '*'

INCLUDE_ID

Sind in R/2-Texten Standardtexte inkludiert, so werden diese Zeilen durch in ein SAPscript-INCLUDE-Kommando umgesetzt. Mit diesem Parameter kann die ID des SAPscript-Textes spezifiziert werden. Defaultwert ist 'ST'.

Bezugsfeld: THEAD-TDID

Defaultwert 'ST'

INCLUDE_ZEROS

Bei der Umsetzung von Texten aus dem SAP R/2-System werden die Nummern der eingebundenen Standardtexte 8-stellig übernommen, d.h. führende Nullen werden mit umgesetzt.

Mit diesem Parameter können Sie die Umsetzung der führenden Nullen in der Standardtextnummer beeinflussen.

Mögliche Werte:

'X'   führende Nullen übernehmen

'  '   führende Nullen entfernen

Defaultwert: 'X'

Beispiel

Im R/2-Text ist der Standardtext 33 eingebunden. Die entsprechende Textzeile sieht folgendermaßen aus:

S   00000033

Diese Textzeile wird in SAPscript durch das INCLUDE-Kommando repräsentiert.

/: INCLUDE '00000033' OBJECT 'TEXT' ID 'ST'

Ist der Parameter INCLUDE_ZEROS mit SPACE bewertet, so sieht das generierte INCLUDE-Kommando folgendermaßen aus:

/: INCLUDE '33' OBJECT 'TEXT' ID 'ST'

 

INCLUDE_PREFIX

Sind in den zu übernehmenden Textbausteinen R/2-Standardtexte inkludiert, so kann hier ein Präfix angegeben werden, der beim INLCUDE-Kommando vor die Textnummer gestellt wird:

Defaultwert: SPACE

Beispiel

INCLUDE_PREFIX = 'R2_'

R/2-Zeile: S  00001234

SAPscript-Zeile: /:  INCLUDE 'R2_00001234'....

COMMENT_LINES

Mit diesem Parameter legen Sie fest, wie Kommandozeilen aus R/2 behandelt werden sollen, die von SAPscript nicht mehr unterstützt werden.

Mögliche Werte:

'X'   Zeilen als Kommentarzeilen übernehmen

'  '   Zeilen nicht übernehmen

Defaultwert: 'X'

SOURCE_SYSTEM

Geben Sie den Systemnamen an, aus dem der Textbaustein kommt. Dieser wird i.a. immer 'SAP' sein (Defaultwert).

Defaultwert: 'SAP'

 

Der Funktionsbaustein CONVERT_TEXT_R2 leitet diesen Parameter direkt an den Parameter SOURCE_SYSTEM des intern aufgerufenen Funktionsbausteins RS3L_CONVERT_FIELDNAME weiter, der die Umsetzung des Feldnamens durchführt. Weitere Informationen erhalten Sie über die dortige Parameterdokumentation.

SOURCE_RELEASE

Hier können Sie das Release des umzusetzenden R/2-Textbausteins spezifizieren. Die Angabe wird für die Umsetzung von Datenbanksymbolen des R/2-Textes benötigt.

Defaultwert: SPACE

Der Funktionsbaustein CONVERT_TEXT_R2 leitet diesen Parameter direkt an den Parameter gleichen Namens des intern aufgerufenen Funktionsbausteins RS3L_CONVERT_FIELDNAME weiter, der die Umsetzung des Feldnamens durchführt. Weitere Informationen erhalten Sie über die dortige Parameterdokumentation.

SOURCE_OBJECT

Migrationsobjekt, innerhalb dessen die Umsetzung des Feldnamens durchgeführt wird.

Defaultwert: SPACE

 

Der Funktionsbaustein CONVERT_TEXT_R2 leitet diesen Parameter direkt an den Parameter BMIG_OBJECT des intern aufgerufenen Funktionsbausteins RS3L_CONVERT_FIELDNAME weiter, der die Umsetzung des Feldnamens durchführt. Weitere Informationen erhalten Sie über die dortige Parameterdokumentation.

DESTINATION_TABLE

Der Parameter spezifiziert die R/3-Tabelle, zu der der gerade umgesetzte Text gehört.

Defaultwert: SPACE

 

Der Funktionsbaustein CONVERT_TEXT_R2 leitet diesen Parameter direkt an den Parameter R3_TABLE des intern aufgerufenen Funktionsbausteins RS3L_CONVERT_FIELDNAME weiter, der die Umsetzung des Feldnamens durchführt. Weitere Informationen erhalten Sie über die dortige Parameterdokumentation.

IGNORE_ALIASNAMES

Mit diesem Parameter steuern Sie die Prüfung der Alias-Namen bei der Umsetzung.

Mögliche Werte:

'X'   Prüfung ignorieren

'  '   Prüfung durchführen

Defaultwert: SPACE

Der Funktionsbaustein CONVERT_TEXT_R2 leitet diesen Parameter direkt an den Parameter gleichen Namens des intern aufgerufenen Funktionsbausteins RS3L_CONVERT_FIELDNAME weiter, der die Umsetzung des Feldnamens durchführt. Weitere Informationen erhalten Sie über die dortige Parameterdokumentation.

ERROR_COMMENTS

Über ERROR_COMMENTS definieren Sie, ob bestimmte Fehler, die bei der Konvertierung auftreten, als Kommentare in den SAPscript-Text übernommen werden. Die Meldungen beziehen sich i.a. auf einen Fehler, der beim Umsetzen der nachfolgenden Textzeile entdeckt wurde.

Mögliche Werte:

'X'   Fehlermeldungen als Kommentar einblenden

'  '   Fehlermeldungen nicht einblenden

In jeder Meldungszeile ist durch einen Präfix angegeben, wo die Fehlermeldung entstanden ist. Nähere Informationen können der dortigen Dokumentation entnommen werden.

CTR2    Fehlermeldung aus Textumsetzungsroutine

-> Funktionsbaustein CONVERT_TEXT_R2

RS3L    Fehlermeldung aus Umsetzung der Feldnamen

-> FB RS3L_CONVERT_FIELDNAME

Ist zu dem Fehlerfall kein Fehlertext vorhanden, so wird statt dessen nach dem Präfix die Zeichenkette ?.. angezeigt.

Defaultwert: SPACE

 

Import-Parameter:

 

NEWHEADER_R2

Veränderter Header des R/2-Textes.

Da zur Zeit nur die Konvertierung R/2 nach SAPscript realsiert ist, wir der im Parameter HEADER_R2 angegebene Textheader unverändert in diesen Ausgabeparameter zurückgestellt.

Struktur: TEXTH

NEWHEADER

Die Parameter gibt den Textheader zurück mit den entsprechend der durchgeführten Aktion veränderten Feldern.

Struktur: THEAD

NEWSTYLE

Wird zur Zeit nicht gefüllt.

Bezugsfeld: THEAD-TDSTYLE

ERRORLEVEL

Bei der Konvertierung der Texte vom R/2 in das SAPscript-Format können verschiedene Probleme auftreten. Der höchste Grad der aufgetretenen Probleme wird über diesen Parameter zurückgegeben.

ERRORLEVEL = 0:

Es wurden keine besonderen Abweichungen festgestellt.

ERRORLEVEL = 1:

Es wurden kleinere Abweichungen ermittelt, die im wesentlichen die Formatierung betreffen. Der eigentliche Textinhalt wurde unverändert übernommen werden.

Zeichen für Solltrennstellen wurden entfernt

Durch Zeilenumbruch getrennte Worte wurden zusammengefügt (nur bei Zeilen mit dem Attribut A oder V)

Der interne Aufruf des Funktionsbausteins RS3L_CONVERT_FIELDNAME lieferte bei der Umsetzung eines Feldnamens die Fehlerstufe 1 zurück.

ERRORLEVEL = 2:

Die Umsetzung von Textelementen wurde zwar vorgenommen, es ist aber nicht sichergestellt, daß diese im SAP-System entsprechend interpretiert werden können.

Der umgesetzte Text enthielt Symbole, bei denen nicht sichergestellt ist, daß sie auch im SAP-System durch den entsprechenden Wert ersetzt werden können:

Symbole, die sich auf Tabellenfelder beziehen *)

Symbole, die sich auf Segmentfelder beziehen  *)

Symbole, die über die R/2-Tabelle 164V umgesetzt werden

*) Diese Fehler können nur dann auftreten, wenn der Funktionsbaustein RS3L_CONVERT_FIELDNAME nicht vorhanden ist.

Der interne Aufruf des Funktionsbausteins RS3L_CONVERT_FIELDNAME lieferte bei der Umsetzung eines Feldnamens die Fehlerstufe 2 zurück.

ERRORLEVEL = 3:

Der R/2-Text enthielt Funktionen, die von SAPscript nicht mehr bzw. z.Zt. noch nicht unterstützt werden.

R/2-Kommandos:.nlf,.psz,.lpi,.prn,.off,.nam

Umsetzung der Werte von Symbolen über eine Tabelle &symbol(Txxxx)

Kapitelzähler: &p0... &p3

Der interne Aufruf des Funktionsbausteins RS3L_CONVERT_FIELDNAME lieferte bei der Umsetzung eines Feldnamens die Fehlerstufe 3 zurück.

ERRORLEVEL = 4:

Umsetzfehler

Kommandozeile wurde abgeschnitten:

Die Zeilenlänge des SAPscript-Textbausteins ist kürzer als ein umzusetzendes Kommando. Der Rest dieser Zeile mußte abgeschnitten werden. Dieses Kommando wird von SAPscript nicht oder nicht richtig interpretiert.

Ungültige Referenz auf Standardtext:

Im R/2-Text ist eine Zeile mit dem Zeilenformat S vorhanden, deren Zeileninhalt keine gültige Textnummer darstellt.

Der interne Aufruf des Funktionsbausteins RS3L_CONVERT_FIELDNAME lieferte bei der Umsetzung eines Feldnamens die Fehlerstufe 4 oder höher zurück.

Der interne Aufruf des Funktionsbausteins RS3L_CONVERT_FIELDNAME erzeugte bei der Umsetzung eines Feldnamens eine der Ausnahmen DOUBLE_TUMLE, DOUBLE_TUMLA oder INTERNAL_ERROR.

Hinweis

Die Bedeutung der Fehlerstufen in Bezug auf den Funktionsbaustein RS3L_CONVERT_FIELDNAME können Sie der Dokumentation zu diesem FB entnehmen.

 

Bezugsfeld: SY-SUBRC

 

Tabellen-Parameter:

 

LINES_R2

Diese Tabelle enthält die Textzeilen des Textes im R/2-Format.

Struktur: TEXTL

LINES

Die Tabelle LINES enthält die Textzeilen des Textes im SAPscript-Format

Struktur: TLINE

 

 

Ende des Inhaltsbereichs