Zum Inhalt springen

Knoten und Felder im Jitterbit Integration Studio

Einführung

Knoten und Felder sind in den Schemata enthalten, die entweder während der Aktivitätskonfiguration oder in der Transformation angegeben werden. Während der Konfiguration einer Transformation werden Knoten und Felder unabhängig vom Transformation gleich angezeigt.

Knoten- und Feldnotation

Jeder Knoten oder jedes Feld wird mit diesen Komponenten angezeigt:

Beispielsweise hat das folgende Feld einen Kardinalitätsschlüssel von [0, 1], ein Name von id und einem Datentyp von string:

Quellfeldnotation

Kardinalitätsschlüssel

Kardinalitätsschlüssel notieren die Beziehung zwischen Knoten und (sofern der Schlüssel vorhanden ist) Feldern. Die Notation leitet sich vom Konzept der Multiplizität ab, wie es in der Unified Modeling Language (UML) verwendet wird.

Kardinalitätsschlüssel Verwendung Definition
[1] Nur Knoten Ein und nur ein Element ist gültig.
[1+] Nur Knoten Ein oder mehrere Elemente sind gültig.
[0,1] Knoten oder Felder Null oder ein Element, Wert oder Attribut ist gültig. Dieser Schlüssel bedeutet, dass ein bestimmter Knoten oder ein bestimmtes Feld praktisch optional ist.
[0+] Nur Knoten Null oder mehr Elemente sind gültig.

Name

Jeder Knoten oder jedes Feld hat einen Namen, der direkt aus dem Schema stammt.

Datentyp

Jedes Feld hat einen zugehörigen Datentyp, wie zum Beispiel integer, float, double, long, string, boolean, oder binary.

Attribut- und Wertindikatoren

Einige Strukturtypen, wie XML oder SOAP, können zusätzliche Symbole haben, die angeben, ob ein Feld ein Wert oder ein Attribut ist. Elemente, die durch Knoten dargestellt werden, haben keine visuellen Indikatoren. Elemente können ein oder mehrere andere Elemente, Attribute, Werte, eine Kombination davon oder keines davon haben, abhängig vom Kardinalitätsschlüssel.

Visueller Indikator Definition
@ Attribut, dargestellt durch ein Feld. Dieses Feld wird verwendet, um anzuzeigen, dass ein Knoten ein Attribut hat und möglicherweise auch einen Wert hat. Für jeden Knoten kann es auch mehr als ein Attribut geben.
# Wert, wie er durch ein Feld dargestellt wird. Das Feld wird verwendet, um anzuzeigen, dass ein Knoten einen Wert und null oder mehr Attribute hat.

Knoten- und Feldbeispiel

Dieses Beispiel zeigt einen Knoten (color_swatch) mit einer Kardinalität von null oder mehr Elementen, das sowohl ein Wertefeld (text), das erforderlich ist, und ein Attributfeld (image), das optional ist:

Zielfeldwertattribut

Referenzpfadnotation

Wenn ein Quellobjekt zugeordnet wird, wird sein individueller Referenzpfad in ein Script im Zielfeld eingefügt. Da diese Pfade in den meisten Anwendungsfällen automatisch erstellt werden, ist es nicht erforderlich, zu wissen, wie man sie manuell erstellt. Diese Informationen werden als Referenz bereitgestellt, um das Verständnis der Erstellung dieser Pfade zu erleichtern.

In manchen Fällen müssen Sie wissen, wie diese Pfade aufgebaut sind, beispielsweise bei der Verwendung von Referenzpfaden mit Instanzfunktionen. In Fällen, in denen ein erforderlicher Eingabeparameter für eine Instanzfunktion ein Array ist, wird ein Hash-Symbol (#) kann in den Referenzpfad eines Datenelements eingefügt werden, um ein Array von Daten statt eines einzelnen Felds zurückzugeben. Weitere Informationen finden Sie unter Einfügen eines Hashs zum Zurückgeben eines Arrays unter Instanzfunktionen.

Zur Referenz: Die für den Pfad des Objekts verwendete Syntax verwendet diese Symbole:

Kategorie Symbol Bedeutung
Pfade [ ] Square Klammern werden verwendet, um einen Knotenpfad einzuschließen.
Ein Pfad ohne eckige Klammern ist ein Wert- oder Attributfeld.
Trennzeichen . Ein Punkt nach einem Knotennamen zeigt an, dass es sich um einen Schleifenknoten handelt.
$ Ein Dollarzeichen nach einem Knotennamen zeigt an, dass Once Only oder [E] Element. Dieser Knoten kann kein Schleifenknoten sein.
Schleifenknoten #. Ein Rautezeichen-Punkt nach einem Knotennamen gibt an, dass ein Array für die Datensatzwertfelder zurückgegeben wird. Diese Notation kann nur für Schleifenknotennamen verwendet werden.
#<n>. Ein Rautezeichen gefolgt von einer Ganzzahl gibt das einsbasierte Indexelement eines Arrays zurück.
Komplexe CSV-Strukturen _ Ein Unterstrich vor Root wird verwendet, um in einer komplexen CSV auf die Wurzel zu verweisen. Dies ist für andere Datenstrukturen nicht vorhanden. Ein Unterstrich kann auch einfach ein Unterstrich sein, der bereits in einem Knoten- oder Feldnamen vorhanden ist.

Die folgende Tabelle enthält als Beispiel Beispielpfade für eine komplexe CSV-Datenstruktur. Die Pfade für andere Strukturen folgen demselben Format, außer dass _Root ist für andere Datenstrukturen nicht vorhanden.

Knotenpfade werden mit blauem Hintergrund angezeigt, während der Rest Feldpfade sind. Eine Quelle kann einem Attribut oder Wertefeld eines Ziels zugeordnet werden. Zielknoten können jedoch Bedingungen haben auf sie angewendet, Quellen können ihnen nicht zugeordnet werden. Quellknoten- und Feldpfade können in Zielknotenbedingungen und Zielfeldzuordnungen verwendet werden.

Datenstruktur
 Qualifizierter Pfad Bedeutung
_Root (Nur einmal) [_Root$] Die _Root ist in einer CSV-Datenstruktur immer ein Knoten und erscheint daher in Klammern [ ]Das Dollarzeichen am Ende zeigt eine Once Only Element.
    Header (Nur einmal) [E] [_Root$Header$] Unterknoten verwenden die Referenz aller vorhergehenden Knoten, gefolgt vom Knotennamen. Das abschließende Dollarzeichen zeigt einen Once Only oder [E] Element.
        Value [V] _Root$Header$Value Ein Wertefeld ist nicht in eckige Klammern eingeschlossen, verwendet aber dennoch die Referenz aller vorhergehenden Knoten, gefolgt vom Wertenamen.
    Detail (Eins oder mehrere) [_Root$Header$Detail.] Unterknoten verwenden die Referenz aller vorhergehenden Knoten, gefolgt vom Knotennamen. Der abschließende Punkt zeigt einen Schleifenknoten an.
        Attribute [A] _Root$Header$Detail.Attribute Ein Attributfeld ist nicht in eckige Klammern eingeschlossen, verwendet aber dennoch die Referenz aller vorhergehenden Knoten, gefolgt vom Attributnamen.
        Value [V] _Root$Header$Detail#.Value Ein Wertefeld ist nicht in eckige Klammern eingeschlossen, verwendet aber dennoch die Referenz aller vorhergehenden Knoten, gefolgt vom Wertnamen. In diesem speziellen Beispiel wird vor dem Punkt des Schleifenknotens ein Rautezeichen angezeigt, das angibt, dass ein Array der „Detail“-Datensatzwerte zurückgegeben wird.
        Value [V] _Root$Header$Detail#1.Value Ein Wertefeld ist nicht in eckige Klammern eingeschlossen, verwendet aber dennoch die Referenz aller vorhergehenden Knoten, gefolgt vom Wertnamen. Dieses spezielle Beispiel zeigt ein indexiertes Rautezeichen vor dem Punkt des Schleifenknotens, das angibt, dass das erste Element eines Arrays der „Detail“-Datensatzwerte zurückgegeben wird.

Weitere Informationen zu Datenstrukturen, zugeordneten Feldern, Schleifenknoten sowie Instanz- und Mehrfachzuordnung finden Sie unter Datenstrukturen.