Mapping List

Use

You use the map attribute to declare a mapping list mapping_list for tt:value, tt:write, and tt:read. You do this to map a list of explicitly declared values to precisely one value when serializing or deserializing.

A mapping_list consists of a single mapping rule or a comma-delimited list of multiple mapping rules. The following mapping rules are possible:

val(a1, a2, ...) > xml(x)
This mapping rule is analyzed during serialization. If the value of the current data node corresponds to one of the specified values a1, a2, .., it is converted into the value x.
xml(x1, x2, ...) > val(a)
This mapping rule is analyzed during deserialization. If the value of the current data node corresponds to one of the specified values x1, x2, ..., it is converted into ABAP value a.
val(a) = xml(x) xml(x) = val(a)
These mapping rules both mean the same thing and are analyzed during both serialization and deserialization. If the value of the current node corresponds to the specified value a, it is converted into value x, and vice versa.

The values a, a1, a2, ... must be specified as described in the Appendix. The XML values x, x1, x2, .. must be put in quotation marks.

Note Note

If mapping rules with more than one argument are used, transformation is usually no longer symmetrical.

End of the note.

Example

Serialization of ABAP data using a mapping list:

Syntax Syntax

<tt:transform xmlns:tt="http://www.sap.com/transformation-templates">

```
  <tt:root name="ROOT1"/>
```
```
  <tt:root name="ROOT2"/>
```
```
  <tt:template>
```
```
    <X0>
```
```
      <X1>
```
```
        <tt:value  ref="ROOT1"
```

                   map="val(C('Woman'), C('Man')) > xml('Person')" />

```
      </X1>
```
```
      <X2>
```
```
        <tt:value  ref="ROOT2"
```

                   map="val(C('Woman'), C('Man')) > xml('Person')" />

```
      </X2>
```
```
    </X0>
```
```
  </tt:template>
```
```
</tt:transform>
```

End of the code.

The transformation is not symmetrical. In the following ABAP program, field1 and field2 contain the value "Person" after deserialization.

Syntax Syntax

```
DATA xml_string TYPE string.
```
```
DATA field1 TYPE string VALUE 'Woman'.
```
```
DATA field2 TYPE string VALUE 'Man'.
```
```
CALL TRANSFORMATION ...
```
```
  SOURCE root1 = field1
```
```
         root2 = field2
```
```
  RESULT XML xml_string.
```
```
CALL TRANSFORMATION ...
```
```
  SOURCE XML xml_string
```
```
  RESULT root1 = field1
```
```
         root2 = field2.
```

End of the code.