Beispiel-Message-Mappings 

Wenn Sie Strukturen aufeinander abbilden, gibt es einige Standardfälle, die immer wieder auftreten können. Um Entwicklern und Beratern die Umsetzung dieser Standardfälle zu erleichtern, liefert SAP Message-Mappings mit Testdaten über die Software-Komponentenversion SAP Basis aus. Die Beispiele finden Sie im Namensraum http://sap.com/xi/XI/System/Patterns.

Allgemeines

Für das Verständnis der Beispiel-Message-Mappings sollten Sie sich mit der Verarbeitung von Queues und Kontexten auskennen. Siehe auch: Strukturabbildungen durch Setzen des Kontexts, Verarbeiten von Eingabe-Queues und Erweiterte benutzerdefinierte Funktionen.

Message-Typen

Folgende Message-Typen werden in den jeweiligen Beispielen verwendet:

·        MapExampleFlatStructureMessage
Die Struktur dieses Message-Typs ist einfach gehalten. Message-Instanzen dieses Messages-Typs bestehen aus keinem oder mehreren Rekords des Elements Person:

Da eine Person mehrere Telefonnummern haben kann, ist es bei Verwendung dieser Struktur möglich, dass es mehrere Rekords in der Message für eine Person gibt, bei der die Id und der Name identisch sind, die Telefonnummer aber unterschiedlich.

·        MapExampleNestedTablesMessage
Die Struktur dieses Message-Typs berücksichtigt explizit, dass eine Person mehrere Telefonnummern haben kann:

Innerhalb eines Person-Rekords kann das Element TelephoneNumber mehrfach auftreten, so dass nicht mehrere Person-Rekords zur gleichen Person notwendig sind, um mehrere Telefonnummern dieser Person zu übergeben.

·        MapExampleTwoTablesMessage
Die Struktur dieses Message-Typs organisiert Informationen zu Personen und deren Telefonnummern in zwei getrennten Strukturen:

Die Telefonnummern lassen sich über das Element PersonId einer Person mit gleicher Id zuordnen.

In den Beispielen wird von folgenden Voraussetzungen ausgegangen:

·        Eine Person wird eindeutig über eine Id identifiziert. Der Wert dieser Id steht je nach Message-Typ entweder im Feld Id oder PersonId.

·        Zu jeder Id gibt es genau einen Namen. Namen treten niemals doppelt auf.

·        Eine Person kann mehrere Telefonnummern haben.

Übersicht

Das Message-Mapping MapExampleFilderRecordsByQualifier verwendet als Ausgangs- und Ziel-Message-Typ den gleichen Message-Typ MapExampleFlatStructureMessage. Bei allen anderen Message-Mappings erkennen Sie am technischen Namen des Message-Mappings, welcher Message-Typ der Ausgangs-Message-Typ und welcher der Ziel-Message-Typ ist.

Das Message-Mapping MapExampleFlatStructureToNestedTables referenziert folgende Message-Typen:
Ausgangs-Message-Typ: MapExampleFlatStructureMessage
Ziel-Message-Typ: MapExampleNestedTablesMessage.

Message-Mapping	Verwendung
MapExampleFilterRecordsByQualifier	Einfaches Filtern einzelner Person-Rekords. Das Beispiel veranschaulicht die Verwendung der Funktion createIf.
MapExampleFlatStructureToNestedTables
MapExampleNestedTablesToFlatStructure	Abbildung einer geschachtelten Struktur auf eine flache Struktur mit Hilfe der Standardfunktion useOneAsMany.
MapExampleTwoTablesToFlatStructure	Abbildung von zwei getrennten Rekords innerhalb einer Struktur auf eine flache Struktur mit Hilfe einer erweiterten benutzerdefinierten Funktion.
MapExampleTwoTablesToNestedTables	Abbildung von zwei getrennten Rekords innerhalb einer Struktur auf eine geschachtelte Struktur mit Hilfe einer erweiterten benutzerdefinierten Funktion.