Eine Map-Anweisung enthält Eigenschaften, die Sie zum Anpassen der Anweisung konfigurieren können. Sie können die Eingabe, Ausgabe und eine Bedingung für das Zuordnen eines Eingabeelements zu einem Ausgabeelement konfigurieren.
Eine Map-Anweisung hat die folgenden Eigenschaften:
Bedingung
Optional. Ein XPath-Ausdruck, der eine Bedingung für das Zuordnen des Elements definiert. Eine Bedingung ähnelt einem Prädikatsausdruck in der Eingabespalte. Wenn Sie einen Eingabe-XPath-Ausdruck und einen Bedingungs-XPath-Ausdruck für dieselbe Mapping-Anweisung definieren, wendet die Datenprozessor-Umwandlung den Bedingungs-XPath auf das Ergebnis des Eingabe-XPath an.
Default
Optional. Der zu verwendende Standardwert, wenn ein Element bei der Eingabe fehlt. Sie können zum Beispiel einen Standardwert festlegen, um einen Zähler zu initialisieren.
Eingabe
Erforderlich. Ein XPath-Ausdruck, der das Eingabeelement definiert. Der Ausdruck kann ein Knoten oder Wert sein.
Modus
Erforderlich. Legt fest, ob die Datenprozessor-Umwandlung ein Ausgabeelement hinzufügt oder ein vorhandenes Element mit einem Wert aus der Mapping-Anweisung abgleicht. Wählen Sie eine der folgenden Optionen aus:
Hinzufügen. Erstellt ein Element im Ausgabehierarchiedokument. Wenn das Element nicht mehrmals vorkommt und derselbe Wert in der Ausgabe vorhanden ist, schlägt die Mapping-Anweisung fehl.
Match. Die Anweisung erwartet, ein Match für das Element in den Ausgabeelementen zu finden. Die Anweisung schlägt fehl, wenn das Element im Ausgabehierarchiedokument nicht vorhanden ist.
Match oder Hinzufügen. Wenn sich im Ausgabehierarchiedokument ein übereinstimmendes Dokument befindet, fügt die Datenprozessor-Umwandlung kein Ausgabeelement hinzu. Wenn sich das Dokument nicht im Ausgabehierarchiedokument befindet, erstellt die Umwandlung ein Ausgabeelement.
Name
Optional. Ein Name für die Anweisung. Sie können den Namen jederzeit ändern. Namen kennzeichnen die Anweisungen, damit Sie sie im Mapping-Gitter oder in einem Ereignisprotokoll wiederfinden. Anweisungsnamen brauchen nicht eindeutig zu sein.
Bei Versagen
Erforderlich. Bestimmt die Aktion, die beim Fehlschlagen der Anweisung durchgeführt wird. Wählen Sie eine der folgenden Optionen aus:
Überspringen. Wenn die Anweisung fehlschlägt, überspringen Sie die Anweisung.
Verteilen. Wenn die Anwendung fehlschlägt, erzwingen Sie ebenfalls das Fehlschlagen der übergeordneten Anweisung.
Ausgabe
Erforderlich. Ein XPath-Ausdruck, der den Wert des Elements in der Ausgabe-XML auf der Grundlage der Ergebnisse des Eingabe-XPath-Ausdrucks definiert.
Fehlende Eingabe überspringen
Optional. Legt fest, ob die Anweisung übersprungen werden soll, wenn für den Eingabewert kein Match vorhanden ist. Wählen Sie eine der folgenden Optionen aus:
Aktiviert. Wenn sich das Element nicht im Eingabehierarchiedokument befindet, überspringt die Datenprozessor-Umwandlung die Anweisung ohne Fehler.
Deaktiviert. Die Anweisung schlägt fehl, wenn sich das Element nicht im Eingabehierarchiedokument befindet.
Anweisungstyp
Erforderlich. Identifiziert die Anweisung als Map-Anweisung.