Parent-Kontext
Einige Mapping-Komponenten haben ein optionales parent-context-Datenelement.
Das Argument parent-context ist ein optionales Argument in einigen MapForce Aggregatfunktionen der core-Bibliothek wie z.B. min, max, avg, count. Der parent-context bestimmt in einer Quellkomponente mit mehreren hierarchischen Sequenzen, an welcher Node-Gruppe die Funktion ausgeführt werden soll.
Mit Hilfe dieses Datenelements können Sie den Mapping-Kontext, in dem diese Komponente verwendet werden soll, beeinflussen und somit die Mapping-Ausgabe ändern. Die Komponenten, die einen optionalen Parent-Kontext haben, sind: Aggregatfunktionen, Variablen und Join-Komponenten.
Um ein Beispiel dafür zu sehen, wie Sie mit der Änderung des Parent-Kontexts arbeiten können, öffnen Sie das folgende Mapping: <Dokumente>\Altova\MapForce2025\MapForceExamples\ParentContext.mfd.
Die XML-Quelldatei im Mapping oben enthält einen einzigen Company-Node, der zwei Office-Nodes enthält. Jeder Office-Node enthält mehrere Department-Nodes und jeder Department-Node enthält mehrere Person-Nodes. Wenn Sie die XML-Datei in einem XML-Editor öffnen, sehen Sie folgende Aufteilung von Personen nach Büro (Office) und Abteilung (Department):
Office | Department | Personenzahl |
|---|---|---|
Nanonull, Inc. | Administration | 3 |
Marketing | 2 | |
Engineering | 6 | |
IT & Technical Support | 4 | |
Nanonull Partners, Inc. | Administration | 2 |
Marketing | 1 | |
IT & Technical Support | 3 |
Im Mapping werden alle Personen in allen Abteilungen gezählt. Dazu wird die count-Funktion aus der core-Bibliothek verwendet. Wenn Sie auf das Fenster Ausgabe klicken, um eine Vorschau auf das Mapping anzuzeigen, sehen Sie, dass als Ergebnis ein einziger Wert, nämlich 21, erzeugt wird, was der Gesamtanzahl aller Personen in der XML-Quelldatei entspricht.
Das Mapping funktioniert folgendermaßen:
•Wie gewöhnlich beginnt die Mapping-Ausführung beim obersten Node der Zielkomponente (in diesem Beispiel rows). rows hat keine eingehende Verbindung. Infolgedessen wird zwischen Company (oberstes Datenelement der Quellkomponente) und rows (oberstes Datenelement der Zielkomponente) ein impliziter Mapping-Kontext erstellt.
•Das Resultat der Funktion ist ein einziger Wert, da die Quelldatei nur eine Firma (Company) enthält.
•Um das Zieldatenelement col1 zu befüllen, führt MapForce die count-Funktion im oben erwähnten impliziten Parent-Kontext aus, d.h. es werden alle Person-Nodes aus allen Büros und allen Abteilungen gezählt.
Mit Hilfe des Arguments parent-context der Funktion können Sie den Mapping-Kontext ändern. Dadurch kann z.B. die Anzahl der Personen in jeder einzelnen Abteilung ermittelt werden. Ziehen Sie dazu, wie unten gezeigt, zwei weitere Verbindungen:
Im oben gezeigten Mapping wird durch die Verbindung A der Parent-Kontext der count-Funktion in Department geändert, wodurch die Funktion die Anzahl der Personen in jeder einzelnen Abteilung zählt. Beachten Sie, dass die Funktion nun eine Sequenz von Ergebnissen anstatt eines einzigen Ergebnisses zurückgibt, da in der Quelldatei mehrere Abteilungen (Department) vorhanden sind. Aus diesem Grund wurde die Verbindung B erstellt: Für jedes Datenelement in der erzeugten Sequenz wird in der Zieldatei eine neue Zeile (row) erstellt. Die Mapping-Ausgabe hat sich nun entsprechend geändert (Beachten Sie, dass die Zahlen genau der Anzahl der Personen in den einzelnen Abteilungen entspricht):
<rows> |
Da im aktuellen Mapping für jede Abteilung (Department) eine Zeile (row) erstellt wird, können Sie durch Ziehen der Verbindungen C und D den Office-Namen und den Abteilungsnamen ebenfalls in die Zieldatei kopieren:
Dadurch wird in der Ausgabe nicht nur die Anzahl der Personen, sondern auch der entsprechende Büro- und Abteilungsname angezeigt.
Wenn Sie die Anzahl der Personen in den einzelnen Büros (Office) zählen möchten, verbinden Sie den Parent-Kontext der count-Funktion mit dem Datenelement Office in der Quellkomponente.
Mit den oben gezeigten Verbindungen gibt die count-Funktion ein Ergebnis für jedes Büro zurück. Die Quelldatei enthält zwei Büros, daher gibt die Funktion nun zwei Sequenzen zurück. Infolgedessen enthält die Ausgabe zwei Zeilen (row), von denen jede die Anzahl der Personen in diesem Büro enthält:
<rows> |