Ansicht
Dokumentation

ABENST_TT_COPY - ST TT COPY

ABAP Short Reference   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

- tt:copy, asXML-Format

tt:copy $[ref="node"$] />

Wirkung

Die Anweisung tt:copy dient der Serialisierung in und zum Deserialisierung aus dem asXML-Format. Er kann auf beliebige Datenobjekte außer Referenzvariablen oder solchen, die Referenzvariablen als Komponenten enthalten, angewendet werden.

Mit dem optionalen Attribut ref kann der aktuelle Knoten für die Anweisung bestimmt werden. Ohne die Angabe von ref wird implizit der aktuelle Knoten des umgebenden Elements verwendet.

Serialisierung

Bei der Serialisierung wird das gesamte ABAP-Datenobjekt, das an den aktuellen Knoten angebunden ist, mit allen seinen Komponenten rekursiv in das asXML-Format transformiert und dieses an der Stelle der Anweisung in die XML-Daten eingesetzt.

Deserialisierung

Bei der Deserialisierung wird der XML-Datenstrom als asXML-Format interpretiert und dessen Werte an das an den aktuellen Knoten angebundene ABAP-Datenobjekt übergeben.

Hinweis

Bei der Serialisierung von Datenobjekten mit tt:copy ist zu beachten, dass nicht automatisch ein Knoten für das erzeugte asXML-Format eingefügt wird. Um gültige XML-Daten zu erhalten, muss dieser Knoten explizit im Template angegeben werden. Ansonsten sind die XML-Daten nicht deserialisierbar. Davon ausgenommen sind nur Strukturen mit einer einzigen Komponente oder interne Tabellen mit einer einzigen Zeile, was in der Regel aber keinerlei praktischen Nutzen bietet.

Beispiel

Die folgende Simple Transformation serialisiert das an die Datenwurzel ROOT angebundene ABAP-Datenobjekt unterhalb des Knotens node> in das asXML-Format. Ohne die Angabe des Knotens node> ergäbe die Transformation keine gültigen XML-Daten und die Deserialisierung würde zu einer Ausnahme führen.

tt:transform
  xmlns:tt="http://www.sap.com/transformation-templates">
  tt:root name="ROOT"/>
  tt:template>
    node>
      tt:copy  ref="ROOT" />
    /node>
  /tt:template>
/tt:transform>

Wenn das ABAP-Programm aus dem Beispiel im Abschnitt über interne Tabellen diese Transformation aufruft, ist das Ergebnis der Serialisierung wie folgt:

node>
  item>
    KEY>2/KEY>
    VALUES>
      item>4/item>
      item>8/item>
      item>16/item>
    /VALUES>
  /item>
  item>
    KEY>3/KEY>
    VALUES>
      item>9/item>
      item>27/item>
      item>81/item>
    /VALUES>
  /item>
  item>
    KEY>4/KEY>
    VALUES>
      item>16/item>
      item>64/item>
      item>256/item>
    /VALUES>
  /item>
/node>

Die Simple Transformation ist symmetrisch.

rdisp/max_wprun_time - Maximum work process run time   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4694 Date: 20240523 Time: 095342     sap01-206 ( 57 ms )