useOneAsMany
Verwendung
Die Funktion useOneAsMany() brauchen Sie immer dann, wenn ein Feld mit einfacher Häufigkeit so oft repliziert werden soll, wie ein weiteres Feld in der Ausgangs-Message auftritt, so dass die Felder paarweise als Rekord in die Zielstruktur geschrieben werden können.
Beispiel
In der folgenden Test-Instanz, in der Bestellungen verschickt werden, gibt es zwei Beispiele für die Verwendung von useOneAsMany():
· Die Bestellungen (Strukturknoten order) in der Message werden zunächst nach ihrem Typ (external oder internal) unterschieden. Das Feld type darf nur ein Mal in der order-Struktur auftreten. Danach kann es mehrere itemGroup-Unterstrukturen geben, in der verschiedene Items über deren Namen (Feld name) aufgelistet werden, die alle zu einer Kategorie gehören. In der Zielstruktur soll der Bestelltyp und der Name des Items allerdings paarweise abgelegt werden (<external, Fender Strat V1>, <external, Ovation Light>, <external, Sticks (Standard)>).
· Zugleich kann es innerhalb einer itemGroup nur eine Kategorie (Feld category), aber mehrere benannte Items (Feld name) geben. Die Kategorie soll ebenfalls in den gleichen Rekord geschrieben werden wie der Wert der Felder name und type (<external, Guitars, Fender Strat V1>, <external, Guitars, Ovation Light>, <external, Percussion, Sticks (Standard)>).
Die Struktur der Ausgangs- und Ziel-Message sind über folgende XSD-Definitionen beschrieben:
Ausgangs- und Zielstruktur
Feldname |
Häufigkeit |
Feldname |
Häufigkeit |
OrdersByType |
1..1 |
OrdersByRecords |
1..1 |
order |
0..unbounded |
record |
0..unbounded |
type |
1..1 |
orderType |
1..1 |
itemGroup |
1..unbounded |
itemCategory |
1..1 |
category |
1..1 |
itemName |
1..1 |
name |
1..unbounded |
|
|
Bevor wir uns die Verwendung von useOneAsMany() genauer ansehen, werfen wir einen Blick auf das gesamte Message-Mapping:
Message-Mapping mit useOneAsMany()
Zielfeld-Mapping (und Erläuterung) |
/OrdersByRecords/record= (Es soll für jedes Auftreten von name ein Rekord in der Zielstruktur entstehen) |
/OrdersByRecords/record/orderType= (siehe unten) |
/OrdersByRecords/record/itemCategory= (siehe unten) |
/OrdersByRecords/record/itemName= (In der Ausgangsstruktur können noch mehrere Werte von name in einem Kontext stehen. In der Zielstruktur soll an jeden record-Kontext ein Wert übergeben werden. Mit SplitByValue() fügen wir daher zusätzliche Kontextwechsel ein. |
Beispiel-Testfall
Ausgangs-Instanz |
Ergebnis |
<?xml version="1.0" encoding="UTF-8"?> <ns0:OrdersByType xmlns:ns0="http://com.sap/b"> <order> <order> <order> </ns0:OrdersByType> |
<?xml version="1.0" encoding="UTF-8"?> <ns0:OrdersByRecords xmlns:ns0="http://com.sap/b"> <record> <record> <record> <record> <record> <record> </ns0:OrdersByRecords> |
Anpassen der Queues mit useOneAsMany()
Anhand des Zielfeld-Mappings zum Zielfeld orderType soll nun die Verwendung von useOneAsMany() verdeutlicht werden:
Die Funktion useOneAsMany() hat drei Eingangsparameter:
- Als erster Parameter wird das Feld erwartet, dessen Häufigkeit 1..1 ist, in unserem Fall ist dies type.
- Als dritter Parameter wird das Feld erwartet, das mehrfach auftreten kann. In unserem Fall ist dies name. Um Paare von type und name zu bilden, muss useOneAsMany() die jeweiligen Werte aus der type-Queue so oft replizieren bis genügend Werte vorhanden sind, die 1:1 den Werten aus der name-Queue zugeordnet werden können. Die Kontextwechsel übernimmt useOneAsMany() aus der name-Queue.
- Schließlich muss useOneAsMany() noch ermitteln, wie oft unterschiedliche Werte aus der type-Queue jeweils repliziert werden müssen. Sie geben dies über den zweiten Parameter von useOneAsMany() an, indem Sie für jede Bestellung (die ja jeweils entweder den Typ external oder internal hat) alle Itemnamen aller itemGroups in den Order-Kontext stellen. Beispielsweise hat die erste Bestellung vom Typ external zwei itemGroups. Zum Wert external gehören also die Namen „Fender Strat V1“, „Ovation Light“ und „Sticks (Standard)“. Anhand des zweiten Parameters wird der Wert von type bestimmt, anhand des dritten Parameters die nötigen Kontextwechsel.
Um für jeden Rekord jeweils einen Wert aus der Ergebnisqueue von useOneAsMany() übernehmen zu können, verwenden Sie die Funktion SplitByValue(). Sie fügt nach jedem Wert der Ergebnisqueue einen Kontextwechsel ein.
Die Verwendung von useOneAsMany() für die Paarbildung von category und name funktioniert analog.