Mapping-Modus in Transformations im Jitterbit Integration Studio

Einführung

Der Mapping-Modus bietet einen Überblick über ein Transformation und die grundlegenden Werkzeuge zur Durchführung des Mappings. Siehe Script für erweiterte Mapping-Tools und Common Mode-Elemente für Elemente der Benutzeroberfläche, die von mehreren Anzeigemodi gemeinsam genutzt werden.

Zugriffszuordnungsmodus

Der Mapping-Modus ist der Standardanzeigemodus beim Öffnen einer Transformation zur Konfiguration.

Im Mapping-Modus enthält die linke Seite die Quellstruktur und die Variablen, die für das Mapping der Zielstruktur auf der rechten Seite verwendet werden können:

Beim Zugriff auf eine Transformation, die Sie zuvor geöffnet haben, scrollt Integration Studio automatisch zu der Stelle im Schema, auf die Sie zuletzt zugegriffen haben.

So kehren Sie im Script zum Zuordnungsmodus zurück, klicken Sie auf den Pfeil links auf dem Bildschirm:

Quell- und Zielschemata

Im Mapping-Modus wird auf der linken Seite der Transformation das Schema angezeigt, während auf der rechten Seite das Schema angezeigt wird. Diese Schemata können entweder in einer Aktivität, die sich neben der Transformation befindet, oder direkt in einer Transformation. Wenn noch kein Schema angegeben wurde, werden Ihnen die folgenden Optionen für die Quell- bzw. Zielseite angezeigt.

Notiz

Bevor eine Transformation konfiguriert werden kann, muss ein Schema angegeben werden.

Keine Quelle angegeben

Es ist nicht erforderlich, ein Schema anzugeben (siehe Schemaverwendung). Wenn Sie nicht möchten, dass ein Schema verwendet wird, müssen Sie auf der Quellseite der Transformation nichts tun.

Wenn Sie kein Schema angegeben haben und eines angeben möchten, können Sie zum Workflow zurückkehren, um in einer Aktivität ein Schema bereitzustellen. neben der Transformation oder wählen Sie eine dieser Optionen:

• Variablen verwenden: Dadurch wird zur Tab Variablen gewechselt, wo Sie Variablen hinzufügen können, wie unter Variablen zuordnen beschrieben.
• Schema definieren: Hiermit wird ein zusätzliches Menü mit Optionen wie Flach erstellen, Hierarchisch erstellen und Beispieldatei verwenden geöffnet. Wenn eine Option ausgewählt ist, öffnet sich das Flach oder hierarchisch benutzerdefinierter Schema Editor oder eine Schnittstelle zum Bereitstellen einer Beispieldatei wie unter Schemas beschrieben.
• Zielschema spiegeln: Kopiert das Schema wie unter Schemas beschrieben. Diese Option ist nur verfügbar, wenn (1) ein angegebenes Schema vorhanden ist und (2) die Quelle der Transformation keine benachbarte Aktivität mit einem [vom Connector generierten Schema] ist.

Kein Ziel angegeben

Bevor eine Transformation konfiguriert werden kann, muss ein Schema angegeben werden (siehe Schemaverwendung).

Wenn Sie kein Schema angegeben haben, können Sie zum Workflow zurückkehren, um in einer Aktivität ein Schema bereitzustellen neben der Transformation oder wählen Sie eine dieser Optionen:

• Schema definieren: Dies bietet ein zusätzliches Menü mit Optionen wie Flach erstellen, Hierarchisch erstellen und Beispieldatei verwenden. Wenn eine Option ausgewählt ist, öffnet sich das flache oder hierarchisch benutzerdefinierter Schema Editor oder eine Schnittstelle zum Bereitstellen einer Beispieldatei wie unter Schemas beschrieben.
• Quellschema spiegeln: Kopiert das Schema wie unter Schemas beschrieben. Diese Option ist nur verfügbar, wenn (1) ein angegebenes Schema vorhanden ist und (2) das Ziel der Transformation keine benachbarte Aktivität mit einem [vom Connector generierten Schema] ist.

Zielknoten

Ein angegebenes Schema besteht aus Knoten, die entweder Felder oder untergeordnete Knoten enthalten (die wiederum weitere Felder und untergeordnete Knoten enthalten können). Quelldaten können nicht den Zielknoten selbst zugeordnet werden, sondern nur den darin enthaltenen Feldern. Nachdem Sie ein Schema angegeben haben, bewegen Sie den Mauszeiger über den Zielknoten, um die für jeden Knoten verfügbaren Optionen anzuzeigen. Klicken Sie anschließend auf Aktionsmenü. Jede mögliche Aktion wird unten beschrieben.

Menüpunkt	Beschreibung
	Schleifenknoten entfernen entfernt die Schleifenknotendefinition. Diese Aktion ist nur für Knoten verfügbar, die einen manuell definierten Schleifenknoten haben. Hinweis Wenn Sie alle direkten Blattzuordnungen eines manuell definierten Schleifenknotens entfernen, bleibt die Schleifenknotendefinition bestehen.
	Loop-Knoten und Zuordnungen entfernen entfernt die Loop-Knotendefinition aufgrund von Zuordnungen, die direkte untergeordnete Blattknoten sind, die mit dem Schleifenknoten verknüpft sind, und entfernt diese Zuordnungen. Alle anderen Zuordnungen innerhalb untergeordneter Schleifenknoten unterhalb des übergeordneten Schleifenknotens bleiben erhalten, und der Knoten behält seine Schleifenknotendefinition bei, wenn mindestens ein untergeordneter Knoten zugeordnet ist. Diese Aktion ist nur für Knoten verfügbar, für die ein Schleifenknoten definiert ist (entweder manuell oder durch automatische Generierung).
	Alle Zuordnungen unterhalb dieses Knotens entfernen entfernt alle Zuordnungen von Feldern innerhalb dieses Knotens sowie alle Zuordnungen von Feldern in untergeordneten Knoten dieses Knotens. Wenn Sie diese Aktion auf einen Stammknoten anwenden, werden alle Zuordnungen in einer Transformation entfernt. Wenn Sie diese Aktion auswählen, werden Sie in einer Meldung aufgefordert, das Entfernen der Zuordnungen zu bestätigen.
	Alle ungültigen Zuordnungen entfernen entfernt alle ungültigen Zuordnungen von Feldern, die im Knoten enthalten sind, sowie alle ungültigen Zuordnungen von Feldern, die in untergeordneten Knoten dieses Knotens enthalten sind. Weitere Informationen zu ungültigen Zuordnungen finden Sie unter Gültigkeit der Transformation.
	Alle Knoten unter diesem Knoten erweitern erweitert alle untergeordneten Knoten unter dem übergeordneten Knoten. (Standardmäßig werden Knoten für Schemata mit 750 oder weniger Knoten bis zu 8 Ebenen tief erweitert und für Schemata mit mehr als 750 Knoten bis zu 5 Ebenen tief.)
	Knoten duplizieren dupliziert den Knoten und seine Felder sowie alle untergeordneten Knoten und deren Felder. Zuordnungen werden nicht dupliziert. Diese Aktion ist für Stammknoten in flachen Schemata und für Knoten verfügbar, deren Kardinalität(/de/integration-studio/design/transformations/basics/nodes-and-fields#nodesandfields-cardinalitykey) gibt an, dass Elemente mehr als einmal vorkommen können. Der Knoten darf nicht bereits ein Duplikat eines anderen Knotens sein. Nur zur Anzeige während des Entwurfs wird dem Namen des Duplikatknotens ein Hash angehängt.und eine erhöhte Zahl. Wenn Sie beispielsweise einen Knoten mit dem Namen transaction wird das erste Duplikat des Knotens als transaction#1 Wenn Sie dann die transaction Knoten erneut, das zweite Duplikat wird angezeigt als transaction#2. Während der Laufzeit wird der ursprüngliche Knotenname sowohl für den ursprünglichen Knoten als auch für die Duplikatknoten verwendet. Beispielsweise werden die Knoten angezeigt als transaction, transaction#1, Und transaction#2 werden jeweils mit dem ursprünglichen Knotennamen verarbeitet transaction. Doppelte Knoten können nicht umbenannt werden. Ob ein doppelter Knoten an anderen Stellen im gesamten Projekt widergespiegelt wird, hängt davon ab, wie das Schema definiert wurde: In einer Aktivität definiert: Wenn das Schema, in dem der Knoten dupliziert wird, in einer Aktivität definiert, dann wird der doppelte Knoten im Schema der Aktivität widergespiegelt. Wenn das Schema der Aktivität später aufgrund einer geänderten Aktivitätskonfiguration oder einer Schema vom Endpoint aus Änderungen erfährt, hängt die Beibehaltung doppelter Knoten davon ab, ob der ursprüngliche Knoten, der dupliziert wurde, noch vorhanden ist: Wenn der ursprüngliche Knoten vorhanden ist, bleiben alle zuvor duplizierten Knoten erhalten. Wenn der ursprüngliche Knoten nicht mehr vorhanden ist, werden alle als Duplikate dieses Knotens erstellten Knoten entfernt. In einer Transformation definiert: Wenn das Schema, in dem der Knoten dupliziert wird, in einer Transformation definiert, dann wird der doppelte Knoten nicht im Schema der Aktivität widergespiegelt, da das Schema der Aktivität nicht Teil der Transformation ist.
	Duplizierten Knoten entfernen entfernt den doppelten Knoten und seine Felder sowie alle doppelten untergeordneten Knoten und ihre Felder. Diese Aktion ist nur für Knoten verfügbar, die mit Duplizierter Knoten erstellt wurden.
	Duplizierten Knoten umbenennen ermöglicht Ihnen, einen duplizierten Zielknoten umzubenennen. Der neue Name dient nur zur Anzeige während der Designzeit. Zur Laufzeit wird der ursprüngliche Name des duplizierten Knotens (der Knotenname mit einem angehängten Hash) verwendet. (#)und eine inkrementierte Zahl) verwendet wird. Diese Aktion ist nur für Knoten verfügbar, die mit Knoten duplizieren erstellt wurden.
	Bedingung zu Knoten hinzufügen dient dazu, eine Zuordnung bedingt auf die Felder eines Knotens anzuwenden. Diese Aktion ist nur für Knoten verfügbar, auf die noch keine Bedingung angewendet wurde. Wenn Sie diese Aktion auswählen, öffnet sich der Script, in dem Sie die Bedingung erstellen können. Weitere Informationen zum Erstellen der Bedingung finden Sie unter Bedingte Zuordnung.
	Bedingung bearbeiten öffnet den Script zum Bearbeiten der vorhandenen Bedingung. Diese Aktion ist nur für Knoten verfügbar, auf die bereits eine Bedingung angewendet wurde. Weitere Informationen finden Sie unter Script Mapping.
	Bedingung entfernen entfernt die Bedingung. Diese Aktion ist nur für Knoten verfügbar, auf die bereits eine Bedingung angewendet wurde.

Zielfelder

Damit aus einer Transformation Ausgabedaten aus der Transformation resultieren, müssen Sie mindestens ein Feld im Schema zuordnen. Nachdem Sie ein Schema angegeben haben, können Sie die Zielfelder auf eine der unten beschriebenen Arten zuordnen, z. B. durch Zuordnen von Quellobjekten, Variablen, Scripts oder benutzerdefinierten Werten zu den Zielfeldern oder durch Hinzufügen anderer Script:

• Automatische Zuordnung
  Mit der automatischen Zuordnung werden Quell- und Zielfelder, deren Namen innerhalb identischer Datenstrukturen exakt übereinstimmen, automatisch zugeordnet. Sie können die automatische Zuordnung für die gesamte Datenstruktur oder für ausgewählte Quell- und Zielknoten durchführen.
• Zuordnung von Quellobjekten
  Zusätzlich zur automatischen Zuordnung können Quellfelder manuell einem Zielfeld zugeordnet werden. Beim Zuordnen eines Quellfelds zu einem Zielfeld wird der Referenzpfad des Quellobjekts in ein Script im Zielfeld eingefügt.
• Mapping-Variablen
  Wenn Sie eine Variable zuordnen, wird die Variablenreferenz in ein Script im Zielfeld eingefügt. Variablenreferenzen werden mit einem Dollarzeichen ($) vor dem Variablennamen.
• Zuordnung benutzerdefinierter Werte
  Benutzerdefinierte Werte sind Werte (einschließlich fest codierter Werte) und Ausdrücke, die einem Zielfeld zugeordnet werden können.
• Mapping mit Scripts
  Alle Transformation bestehen aus Scripts für einzelne Knoten und Felder innerhalb eines Schema. Auf dieser Seite erfahren Sie, wie Sie Transformation öffnen und darin auf Projektkomponenten und -funktionen verweisen. Sie können jedoch jede gültige Script verwenden.

Visuelle Indikatoren für zugeordnete Felder

Beim Anzeigen zugeordneter Objekte auf den Registerkarten Quelle oder Variablen gibt eine Zahl in Klammern und die Farbe Orange an, wie oft auf jedes Objekt auf der Zielseite der Transformation verwiesen wird.

Wenn Sie mit der Maus über ein Quellobjekt fahren, werden außerdem Linien angezeigt, die das Quellfeld mit den zugeordneten Zielfeldern oder referenzierten Knoten verbinden. Klicken Sie direkt auf die Zahl, um die referenzierten Zielfelder oder Knoten anzuzeigen. Klicken Sie, um automatisch zum Objekt oder Knoten in der Zielstruktur zu scrollen.

Beim Anzeigen zugeordneter Objekte in der Ziel-Struktur wird beim Bewegen des Mauszeigers über das Feld eine Linie angezeigt, die das zugeordnete Zielfeld mit seinen Ursprüngen in den Registerkarten Quelle oder Variablen verbindet (sofern zutreffend). Klicken Sie auf das zugeordnete Quellobjekt, um automatisch zum Objekt in der Tab zu gelangen.

Wenn Sie auf den Namen eines zugeordneten Zielobjekts klicken, wird es ausgeblendet, sodass die zugeordneten Objekte nicht mehr sichtbar sind.

Wenn ein reduzierter Knoten Zielfeldzuordnungen enthält, wird dieser fett dargestellt, um darauf hinzuweisen, dass er Zuordnungen enthält:

Bearbeiten oder Entfernen einer Zuordnung

Sie können Zielfeldzuordnungen einzeln bearbeiten oder entfernen oder alle in einem Knoten enthaltenen Feldzuordnungen entfernen.

Bearbeiten oder Entfernen einer einzelnen Feldzuordnung

Wenn Sie mit der Maus über ein zugeordnetes Zielfeld fahren (angezeigt durch eine violette vertikale Linie und ein Script im Block des Felds), werden diese Optionen verfügbar:

• Bearbeiten: Öffnet den Script Editor für das Feld.

• Zuordnung entfernen: Entfernt die Zuordnung für das Feld.

Entfernen mehrerer Feldzuordnungen

Für Zuordnungen auf hierarchischen Schemata stehen Optionen zum Entfernen mehrerer Zielfeldzuordnungen im Aktionsmenü eines Knotens zur Verfügung (siehe oben unter Zielknoten).