ABAPCALL_TRANSFORMATION_OPTIONS - CALL TRANSFORMATION OPTIONS

BAL_S_LOG - Application Log: Log header data   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

CALL TRANSFORMATION - transformation_options

Kurzreferenz

Syntax

... OPTIONS [clear              = val]
            [data_refs          = val]
            [initial_components = val]
            [technical_types    = val]
            [value_handling     = val]
            [xml_header         = val] ... .

Zusätze:

1. ... clear

2. ... data_refs

3. ... initial_components

4. ... technical_types

5. ... value_handling

6. ... xml_header

Wirkung

Der Zusatz OPTIONS erlaubt die Angabe von vorgegebenen Transformationsoptionen, denen bestimmteWerte zugeordnet werden können, um die Transformation zu steuern. Die Werte müssen inDatenobjekten val vom Typ c oder string angegeben werden. Jede Transformationsoption darf nur einmal angegeben werden.

Zusatz 1

...clear

Wirkung

Die Transformationsoption clear steuert, wie die ABAP-Zielfelder bei einer Deserialisierung von XML nach ABAP initialisiert werden.

Mögliche Werte	Bedeutung
all	Alle hinter RESULT angegebenen Zielfelder werden vor Aufruf der Transformation initialisiert. Dies ist die empfohlene Einstellung.
supplied	Bei ST werden vor Aufruf der Transformation die Zielfelder initialisiert, denen imST-Programm ein Wurzelknoten zugeordnet ist. Bei XSLT werden Zielfelder, für die im XML-Dokumentein Wurzelknoten vorhanden ist, vor dem Einlesen des Knotens initialisiert. Andere Zielfelder behalten ihren Wert.
none	Standard, die hinter RESULT angegebenen Zielfelder werden mit der Ausnahme von internen Tabellen nicht initialisiert.

Hinweis

Die Verwendung von none kann dazu führen, dass manche Zielfelder ihren alten Wert behalten,während anderen ein neuer Wert zugewiesen wird. Wenn ein Zielfeld strukturiert ist, kann dies insbesondere für die einzelnen Komponenten zutreffen.

Zusatz 2

... data_refs

Wirkung

Die Transformationsoption data_refs steuert die Ausgabe vonDatenreferenzen, falls von ABAP nach XML transformiert wird.

Mögliche Werte	Bedeutung
no	Standard bei ST, es werden keine Datenreferenzen ausgegeben.
heap	Standard bei XSLT und nur dort möglich, überselbstständige Datenreferenzen referenzierte Daten werden als Unterelemente desasXML-Elements <asx:heap> ausgegeben. Überunselbstständige Datenreferenzen referenzierte Daten werden nicht serialisiert.
heap-or-error	Nur bei XSLT möglich. Wie heap, wobei es aber zur Ausnahme CX_XSLT_SERIALIZATION_ERROR kommt, wenn die zu serialisierenden Datenunselbstständige Datenreferenzen enthalten.
heap-or-create	Nur bei XSLT möglich. Wie heap, wobei aber überunselbstständige Datenreferenzen referenzierte Daten wie überselbstständige Datenreferenzen referenzierte Daten behandelt werden.
embedded	Referenzierte Daten werden mit der Referenz ausgegeben.

Zusatz 3

... initial_components

Wirkung

Die Transformationsoption initial_components steuert die Ausgabe von initialen Strukturkomponenten, falls von ABAP nach XML transformiert wird.

Mögliche Werte	Bedeutung
include	Initiale Komponenten von Strukturen werden ausgegeben.
suppress_boxed	Standardeinstellung, initiale Boxed Components werden nicht ausgegeben, initiale Komponenten aller anderen Strukturen werden ausgegeben.
suppress	Initiale Komponenten von Strukturen werden nicht ausgegeben.

Zusatz 4

... technical_types

Wirkung

Die Transformationsoption technical_types steuert das Verhalten, falls bei derSerialisierung von Datenreferenzen keine Typbeschreibung serialisiert werden kann. Dies ist der Fall, wenn dietechnische Typeigenschaften desdynamischen Typs der Datenreferenzvariablen zwar bekannt sind, der Typ aber keinen Namen hat.

Mögliche Werte	Bedeutung
error	Standard bei XSLT und nur dort möglich. Die Serialisierung einer Datenreferenzvariable mit gebundenem dynamischen Typ führt zur Ausnahme CX_XSLT_DESERIALIZATION_ERROR.
ignore	Nur bei XSLT möglich. Eine Datenreferenzvariable mit gebundenem dynamischen Typ wird bei der Serialisierung ignoriert.

Zusatz 5

... value_handling

Wirkung

Die Transformationsoption value_handling steuert die Toleranz bei Konvertierungen beimMapping elementarer ABAP-Typen.

Mögliche Werte	Bedeutung
default	Standardeinstellung, bei der Serialisierung kommt es bei einem ungültigenWert in einem Feld vom Typ n zur Ausnahme CX_SY_CONVERSION_NO_NUMBER. Bei der Deserialisierungkommt es zur Ausnahme CX_SY_CONVERSION_DATA_LOSS, wenn Zielfelder der Typen c, n oderx zu kurz sind, bzw. zur Ausnahme CX_SY_CONVERSION_LOST_DECIMALS, wenn Zielfelder vom Typ p zu wenig Nachkommastellen haben.
move	Nur bei der Serialisierung möglich. Ungültige Werte in einem Feld vom Typ n werden unverändert nach XML kopiert.
accept_data_loss	Nur bei der Deserialisierung möglich. Wenn Zielfelder der Typen c,n oder x zu kurz sind, werden überschüssige Daten bei c und x rechts und bei n links abgeschnitten.
accept_decimals_loss	Nur bei der Deserialisierung möglich. Wenn Zielfelder vom Typ p zu wenig Nachkommastellen haben, wird auf die zur Verfügung stehenden Nachkommastellen gerundet.
reject_illegal_characters	Nur bei der Deserialisierung möglich. Wenn ein zu deserialisierender WertZeichen enthält, die nicht zum Encoding des XML-Dokuments oder zur aktuellen Codepage des ASABAP passen, wird eine Ausnahme CX_SY_CONVERSION_CODEPAGE ausgelöst. Wenn das XML-Dokument alsiXML-Input-Stream übergeben wird, übersteuert die Einstellung des iXML-Parsers das Encoding des XML-Dokuments.

Hinweise

• Die in der Tabelle erwähnten Ausnahmen können bei CALL TRANSFORMATION nicht direkt behandelt werden, sondern sind in CX_TRANSFORMATION_ERROR bzw. deren Unterklassen verpackt.
  
• Wird ein Wert angegeben, der in der entsprechenden Richtung nicht unterstützt wird, kommt es dagegen zur direkt behandelbaren AusnahmeCX_SY_TRANS_OPTION_ERROR.
  
  

Beispiel

Bei einer Angabe von value_handling = 'reject_illegal_characters' kommt es beispielsweise zurAusnahme, wenn im XML-Header eines im Zeichensatz Latin-1 vorliegenden XML-Dokuments encoding="utf-8"angegeben ist und das XML-Dokument andere Zeichen als die des 7-Bit-ASCII-Zeichensatzes enthält.

Zusatz 6

... xml_header

Wirkung

Die Transformationsoption xml_header steuert die Ausgabe des XML-Headers, falls nach XML transformiert und in ein Datenobjekt vom Typ c, string oder eine interne Tabelle geschrieben wird.

Mögliche Werte	Bedeutung
no	Es wird kein XML-Header ausgegeben.
without_encoding	Es wird ein XML-Header ohne Angabe des Encodings ausgegeben.
full	Standardeinstellung, es wird ein XML-Header mit Angabe des Encodings ausgegeben.

rdisp/max_wprun_time - Maximum work process run time   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.


Length: 12698 Date: 20120526 Time: 191645     triton ( 399 ms )