Hierarchische Entity-Pfadnotation im Jitterbit Design Studio

Beim Anzeigen oder Bearbeiten einer Transformation können Sie den Instanzcode für jeden Knoten oder jedes Feld sehen, wie er in der Quell- oder Zielstruktur definiert ist, um eine genaue Zuordnung der Felder zu ermöglichen. Abhängig von Ihrer Quell- und/oder Zieldatenstruktur werden Instanzcodes, die aus Elementen, Werten und Attributen bestehen, zusammen mit allen Modifikatoren neben jedem Knoten- oder Feldnamen angezeigt.

Elemente, Werte und Attribute

Die verschiedenen [E] Knoten werden alle durch Ordner in den Quell- oder Zielzuordnungsstrukturen dargestellt. Der Benutzer führt eine Zuordnung zu oder von den [V], [A], oder [EV] Felder.

XML, JSON, NetSuite, Salesforce	Bedeutung
`[E]`	Element. In Jitterbit werden Elemente durch Knoten dargestellt. Elemente können je nach Modifikatoren ein oder mehrere andere Elemente, Attribute, Werte, eine Kombination davon oder keines davon haben.
`[V]`	Wert. In Jitterbit werden Werte durch Felder dargestellt. Wenn ein Knoten einen Wert hat, hat er auch mindestens ein Attribut. Wenn er kein Attribut hat, wird er dargestellt als `[EV]`.
`[A]`	Attribut. In Jitterbit werden Attribute durch Felder dargestellt. Wenn ein Knoten ein Attribut hat, kann er ein Wertefeld haben oder nicht. Es kann mehr als ein Attribut pro Knoten geben.
`[EV]`	Elementwert. In Jitterbit sind dies Elemente, die einen Wert, aber keine Attribute haben und daher durch Felder und nicht durch Knoten dargestellt werden.

Hinweis

Die Buchstabencodes in der obigen Tabelle werden nicht innerhalb von Text- oder Datenbankstrukturen verwendet.

Modifikatoren

Modifikatoren notieren die Beziehung für Knoten und manchmal Felder, wie in der folgenden Tabelle beschrieben.

XML, JSON, NetSuite, Salesforce	Komplexer Text oder Datenbank	Bedeutung
(kein Modifikator)	`Once Only`	Ein und nur ein [1]-Element ist gültig. Nur Knoten können diesen Modifikator haben.
`+`	`One or More`	Ein oder mehrere [1+]-Elemente sind gültig. Nur Knoten können diesen Modifikator haben.
`?`	`Zero or One`	Null oder ein [0,1]-Element, -Wert, -Attribut oder-Elementwert ist gültig. Sowohl Knoten als auch Felder können diesen Modifikator haben, was effektiv bedeutet, dass der Knoten oder das Feld optional ist.
*``**	`Zero or More`	Null oder mehr [0+] Elemente sind gültig. Nur Knoten können diesen Modifikator haben.

Beispiele

Wenn Modifikatoren mit Elementen, Werten und Attributen verwendet werden, beachten Sie die folgenden Beispiele:

Beispiel 1

Nehmen wir an, dass es ein optionales Element namens „Zeit“ gibt. Nehmen wir dann an, dass dieses Element einen Wert vom Typ Zeichenfolge hat und keine Attribute besitzt. Dann wird es als Feld wie folgt angezeigt:

[EV?] Time (String)

Der Benutzer kann dann direkt von der [EV?] Feld.

Beispiel 2

Wenn das Element „Zeit“ auch ein Attribut namens „Zeitzone“ hat, wird das Element durch einen Knoten dargestellt, wobei Wert- und Attributfelder innerhalb des Knotens angezeigt werden:

[E?] Time

[V] (String)

[A] Timezone (String)

In diesem Fall [E?] Knoten erscheint als Ordner im Baum und der Benutzer führt eine Zuordnung zu oder von dem [V] Und [A] Felder.

Referenz in einem Script

Beim Verweisen auf Elemente, Werte und/oder Attribute innerhalb eines Script werden qualifizierte Pfade verwendet. Der qualifizierte Pfad ist das, was innerhalb des <trans> </trans> Tags in einem Jitterbit Script, wenn auf den spezifischen Knoten oder das Feld verwiesen wird. Die folgenden Symbole werden in der Notation verwendet, um Folgendes zu kennzeichnen:

Symbol	Bedeutung
`[ ]`	Square Klammern werden verwendet, um Knoten einzuschließen. Beachten Sie jedoch, dass Knotenpfade nicht direkt zugeordnet werden können; es können nur Felder zugeordnet werden.
`.`	Ein Punkt nach einem Knotennamen weist auf einen Schleifenknoten hin.
`$`	Ein Dollarzeichen nach einem Knotennamen zeigt an, dass `Once Only` oder `[E]` Element. Dieser Knoten kann kein Schleifenknoten sein.
`#`	Ein Rautezeichen nach einem Knotennamen gibt an, dass ein Array für die Datensatzwertfelder zurückgegeben wird. Diese Notation kann nur nach einem Schleifenknoten vor dem Punkt verwendet werden.
`_`	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 folgenden Beispielpfade gelten für eine komplexe CSV-Datenstruktur. Die qualifizierten Pfade für andere Strukturen folgen demselben Format, außer dass _Root ist für andere Datenstrukturen nicht vorhanden.

Hinweis

Es werden nicht alle möglichen Kombinationen angezeigt, sie können jedoch anhand der obigen Tabelle erstellt 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. Knotenpfade können nicht zugeordnet werden.
`Header` (nur einmal)	`[_Root$Header$]`	Unterknoten verwenden die Referenz aller vorhergehenden Knoten, gefolgt vom Knotennamen. Das abschließende Dollarzeichen zeigt einen `Once Only` oder `[E]` Element. Knotenpfade können nicht zugeordnet werden.
`Value` [V]	`_Root$Header$Value`	Ein Wertefeld ist nicht in eckige Klammern eingeschlossen, verwendet aber dennoch die Referenz aller vorhergehenden Knoten, gefolgt vom Wertenamen. Dieser Feldpfad kann für die Zuordnung verwendet werden.
`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. Knotenpfade können nicht zugeordnet werden.
`Attribute` [A]	`_Root$Header$Detail.Attribute`	Ein Attributfeld wird nicht in eckige Klammern eingeschlossen, verwendet aber dennoch die Referenz aller vorhergehenden Knoten, gefolgt vom Attributnamen. Dieser Feldpfad kann für die Zuordnung verwendet werden.
`Value` [V]	`_Root$Header$Detail#.Value`	Ein Wertefeld ist nicht in eckige Klammern eingeschlossen, verwendet aber dennoch die Referenz aller vorhergehenden Knoten, gefolgt vom Wertenamen. In diesem speziellen Beispiel wird vor dem Punkt des Schleifenknotens ein Rautezeichen angezeigt, das angibt, dass ein Array der „Detail“-Datensatzwerte zurückgegeben wird. Dieser Feldpfad kann für die Zuordnung verwendet werden.