Comments
SAP ST TT ATTRIBUTE documentation, setup help and example usage
ARTICLE
ST - tt:attribute , Non-Literal Attributes
Syntax
...
/tt:attribute
Effect
The non-literal attributes of an ST program are defined using the statement tt:attribute . A non-literal attribute is assigned to an attribute of an XML element of the XML data. In serializations, the content of the non-literal attribute sets the value of the attribute in the XML data; in deserializations, the value of the attribute in the XML data is read and processed.
This statement can be specified one or more times within a literal
XML element before its subelements. Each statement defines a non-literal attribute of the current XML element with the name attr specified in name . The optional attribute ref sets the current node node for the context of the non-literal attribute attr .
Serializing Non-Literal Attributes
In serializations, the name attr of the attribute is written together with =" or =' into the definition of the current XML element. After that, the content of tt:attribute is serialized and the result is written after attr=" or attr='
. The result of the serialization must not be structured, which means that it must not contain subelements. Finally, the attribute is completed with " or ' .
Note
In valid XML data, the names of the attributes of an XML element must be unique. For performance reasons, this is not checked in serializations of non-literal attributes; the application developers themselves are responsible.
Deserializing Non-Literal Attributes
In deserializations, the name of the attribute is compared to the attributes of the current XML element in the source XML data. The order of the attributes is not relevant. The deserialization fails if the attribute does not exist in the inbound stream. After that, the value of the attribute is deserialized according to the content of tt:attribute and the closing character is compared. The deserialization fails if not the entire content of the attribute is deserialized. Surplus attributes of the inbound stream are ignored.
Special Form of Non-Literal Attributes
Syntax
[map=...] /
Effect
This special form of non-literal attributes combines the tt:value
command with the general syntax shown above.
This special form is a short form of:
tt:value ref="node" [map=...] /
/tt:attribute
This allows the simple formulation of the frequent situation where an elementary value is expressed as the content of an attribute.
Example
In the ST program below, the values of the data roots ROOT1
and ROOT2 are serialized as values of the attributes
attr1 and attr2 of element X or are deserialized from them, respectively.
xmlns:tt="http://www.sap.com/transformation-templates">
tt:root name="ROOT1"/
tt:root name="ROOT2"/
<(><<)>tt:template>
<(><<)>X>
tt:attribute name="attr1" value-ref="ROOT1" /
tt:attribute name="attr2" value-ref="ROOT2" /
<(><<)>Y>...<(><<)>/Y>
<(><<)>/X>
<(><<)>/tt:template>
/tt:transform
If the values "Text1" and "Text2" are passed to ROOT1
and ROOT2 , the result of a serialization is:
<(><<)>Y>...<(><<)>/Y>
/X
To deserialize the above result again, the ST program below can be used, even though the order of the attributes is different.
xmlns:tt="http://www.sap.com/transformation-templates">
tt:root name="ROOT1"/
tt:root name="ROOT2"/
<(><<)>tt:template>
<(><<)>X>
tt:attribute name="attr2" value-ref="ROOT2" /
tt:attribute name="attr1" value-ref="ROOT1" /
<(><<)>Y>...<(><<)>/Y>
<(><<)>/X>
<(><<)>/tt:template>
/tt:transform
Documentation extract taken from SAP system, � Copyright SAP AG. All rights reserved
