Altova MapForce 2024 Professional Edition

In diesem Kapitel werden verschiedene Szenarien beschrieben, in denen sich Standardwerte und Node-Funktionen als nützlich erweisen können. Um diese Szenarien auszuprobieren, benötigen Sie das folgende Beispielmapping: Tutorial\MissingFields.mfd. Unsere Ausgangsbasis bildet das unten gezeigte Mapping.

Einige der Nodes in der Quelldatei sind leer. Zu diesem Zeitpunkt sieht die Ausgabedatei folgendermaßen aus:

In den unten beschriebenen Szenarien wird gezeigt, wie Sie für alle Nodes vom Typ string einen Standardwert definieren, Standardwerte für verschiedene Datentypen festlegen, Regeln für bestimmte Nodes blockieren, geerbte Regeln außer Kraft setzen, eine Node-Funktion definieren und diese Funktion auf Basis von Bedingungen auf die entsprechenden Nodes anwenden und Standardwerte auf nicht verbundene Nodes anwenden.

Szenario 1: Definieren eines Standardwerts für alle String-Nodes

Einige der Nodes vom Typ string sind in unserem Mapping leer. Wir möchten nun anstelle der leeren Strings den Standardwert n/a definieren. Gehen Sie folgendermaßen vor:

1.Klicken Sie mit der rechten Maustaste auf das Element Article und wählen Sie im Kontextmenü die Option Node-Funktionen und Standardwerte | Output-Node-Funktionen und Standardwerte.

2.Klicken Sie im Node-Funktionsfenster auf die Option und geben Sie in das Feld Standardwert n/a ein (siehe Abbildung unten).

Die Elemente Name und Description haben in der Komponente ArticlesOfClothing den Typ string, weshalb der Standardwert für beide davon verwendet werden kann. Daher wird nun neben diesen Nodes das Symbol angezeigt. Da Standardwerte nur auf leere Werte angewendet werden, haben nur zwei Field4-Nodes in der Ausgabe den Wert n/a erhalten (unten gelb markiert).

Szenario 2: Definieren der Standardwerte für unterschiedliche Datentypen

Sie können nicht nur für einen einzigen bestimmten Typ einen Standardwert definieren, sondern zusätzlich auch einen weiteren Standardwert für einige andere Datentypen definieren. So hat etwa einer der Artikel in Price und ItemsInStock leere Werte, wobei beide den Typ "Zahl" haben. Wir möchten nun diese leeren Werte durch den Wert 0 ersetzen. Gehen Sie folgendermaßen vor:

1.Wiederholen Sie die Schritte aus Szenario 1. Dadurch wird für alle Nodes vom Typ string, die einen leeren Wert haben, ein Standardwert hinzugefügt.

2.Fügen Sie einen weiteren Standardwert hinzu und wählen Sie als Datentyp numeric aus.

3.Geben Sie in das Feld Standardwert 0 ein (siehe Abbildung unten).

Die Ausgabe sieht nun folgendermaßen aus (Beachten Sie die markierten Bereiche):

Szenario 3: Blockieren von Regeln für bestimmte Nodes

In diesem Szenario sollen auf alle Nodes vom Typ "string" und "numeric" Standardwerte angewendet werden, aber für das Datenelement Price soll kein Standardwert definiert werden. Wiederholen Sie zu diesem Zweck die Schritte aus Szenario 2, klicken Sie anschließend auf das Element Price und deaktivieren Sie das Kontrollkästchen Regeln von Vorfahren erben Das Datenelement Price erbt im Mapping unten nun nicht mehr die Regeln von seinem übergeordneten Datenelement Article. Daher wird neben dem Element Price das Symbol angezeigt (siehe Abbildung unten).

In der Ausgabe unten sehen Sie, dass der leere Wert des Elements Price, für den die Regel blockiert wurden, auf Field2 gemappt wurde (Beachten Sie die markierten Bereiche).

Szenario 4: Außerkraftsetzen von geerbten Regeln

In diesem Szenario sollen für alle Nodes vom Typ "string" und "numeric" Standardwerte definiert werden. Nur für das Element Price soll jedoch ein Standardwert von 100 definiert werden. Wiederhole Sie dazu die Schritte aus Szenario 2, klicken Sie in der Komponente ArticlesOfClothing auf Price, fügen Sie einen neuen Standardwert hinzu und geben Sie 100 ein, wie in der Abbildung unten gezeigt. Die geerbten Regeln haben einen a gelben Hintergrund.

Die direkt für einen Node definierte Regel hat Vorrang vor Regeln, die auf einer übergeordneten Ebene erstellt wurden. Die Ausgabe sieht daher folgendermaßen aus (Beachten Sie den markierten Bereich):

Wenn Sie für ein und denselben Node mehr als eine Regel definiert haben, wird die oberste Regel des Rasters auf den aktuellen Node angewendet. Sie können die Reihenfolge dieser Regeln ändern, indem Sie die Regeln im Raster an eine andere Stelle ziehen.

Szenario 5: Erstellen einer Node-Funktion und Anwendung dieser Funktion auf Basis von Bedingungen

In diesem Szenario wird erläutert, wie Sie eine Node-Funktion erstellen und diese auf Basis von Bedingungen anwenden. Mit Hilfe der Funktion concat werden wir Text zu Nodes vom Typ string hinzufügen. Gehen Sie folgendermaßen vor:

1.Klicken Sie mit der rechten Maustaste auf das Element Article und wählen Sie im Kontextmenü die Option Node-Funktionen und Standardwerte | Output-Node-Funktionen und Standardwerte.

2.Fügen Sie durch Klick auf das Symbol eine Node-Funktion hinzu und erstellen Sie die unten gezeigte Funktion.

Wir haben die Nodes zu diesem Zeitpunkt noch nicht gefiltert. Die Ausgabe sieht folgendermaßen aus (Beachten Sie die markierten Bereiche):

In der Ausgabe sehen Sie, dass unsere Regel auf beide Elemente vom Typ string angewendet wurde: Name und Description. Die Regel soll nun nur auf das Element Name angewendet werden. Gehen Sie dazu zum Node-Funktionsfenster und klicken Sie in der Spalte Datentyp und Filter auf das Symbol . Daraufhin wird das Dialogfeld Node-Funktionen und Standardwerte filtern, in dem Sie die Datentypen ändern und Filteroptionen definieren können, aufgerufen. Definieren Sie den Filter, wie in der Abbildung unten gezeigt.

Die Ausgabe sieht nun folgendermaßen aus:

Filtern nach Node-Typ

Mit Hilfe dieser Option können Sie den im Dialogfeld Node-Funktionen und Standardwerte filtern ausgewählten Datentyp einschränken. Sie haben z.B. ausgewählt, dass Ihre Node-Funktion auf numerische Nodes angewendet wird. Anschließend können Sie einen Subtyp (z.B. Filtern nach/Node-Name: xs:decimal) definieren.

Filtern mittels Regular Expressions

Für komplexere Filteroptionen können Regular Expressions verwendet werden (z.B. für Entsprechungen mit mehreren Node-Namen oder Typnamen). Nähere Informationen dazu finden Sie unter Regular Expressions. Beachten Sie die folgenden Punkte:

•Die Anker ^ und $ sind implizit und dürfen nicht in das Feld Suchen nach eingegeben werden.

•Die Berücksichtigung der Groß- und Kleinschreibung kann über das Kontrollkästchen GROSS/klein beachten definiert werden. Das i-Flag wird daher nicht unterstützt.

•Dass Übereinstimmungen über mehrere Zeilen erfolgen, ist bei der Filterung von Nodes nicht sinnvoll. Das m-Flag wird daher nicht unterstützt.

Szenario 6: Erstellen von Standardwerten für nicht verbundene Nodes

Sie können in MapForce Standardwerte auf nicht verbundene Nodes anwenden, jedoch nur, wenn der übergeordnete Node und/oder ein gleichrangiger Node verbunden ist. Betrachten Sie dazu das folgende Beispiel:

Wir haben im obigen Mapping in der Komponente ArticlesInfo einen Standardwert für den Node Field4 definiert. Field4 hat zu diesem Zeitpunkt keine Input-Verbindung. Deer übergeordnete Node und gleichrangige Nodes sind verbunden. Wenn Field4 unverbunden bleibt, werden alle Description-Werte in der Ausgabe durch den Standardwert überschrieben (siehe unten). Wenn Sie Description und Field4 verbinden, wird der Standardwert nur auf leere Sequenzen angewendet.