Mapping-Modus in Transformations im Jitterbit Integration Studio

Einführung

Der Mapping-Modus bietet einen Überblick über ein Transformation-Mapping und die grundlegenden Tools zum Durchführen 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 zur Verfügung stehen:

Wenn Sie auf eine Transformation zugreifen, die Sie zuvor geöffnet haben, Integration Studio automatisch zu der Stelle im Schema gescrollt, auf die Sie zuletzt zugegriffen haben.

So kehren Sie im Script zum Zuordnungsmodus zurück, klicken Sie auf den Pfeil auf der linken Seite des Bildschirms:

Quell- und Zielschemas

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 jeweils für die Quell- oder Zielseite angezeigt.

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 anzugeben 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: Dies bietet ein zusätzliches Menü mit Optionen, darunter Flach erstellen, Hierarchisch erstellen und Beispieldatei verwenden. 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 angrenzende 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, darunter Flach erstellen, Hierarchisch erstellen und Beispieldatei verwenden. 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.
• 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 angrenzende Aktivität mit einem vom Connector generierten Schema ist.

Zielknoten

Ein angegebenes Schema besteht aus Knoten, die entweder Felder oder untergeordnete Knoten enthalten (die 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 auf die für jeden Knoten verfügbaren Optionen zuzugreifen, und klicken Sie dann auf Aktionsmenü. Jede mögliche Aktion wird unten beschrieben.

Menüelement	Beschreibung
	Loop-Knoten entfernen entfernt die Loop-Knotendefinition. Diese Aktion ist nur bei Knoten verfügbar, die einen manuell definierten Loop-Knoten haben. Hinweis Wenn Sie alle direkten Blattzuordnungen eines manuell definierten Loop-Knotens entfernen, bleibt die Loop-Knotendefinition bestehen.
	Loop-Knoten und Zuordnungen entfernen entfernt die Loop-Knotendefinition aufgrund von Zuordnungen, die direkte untergeordnete Blattknoten sind, die mit dem Loop-Knoten verknüpft sind, und entfernt diese Zuordnungen. Alle anderen Zuordnungen innerhalb untergeordneter Loop-Knoten unterhalb des übergeordneten Loop-Knotens bleiben erhalten, und der Knoten behält seine Loop-Knotendefinition, wenn mindestens ein untergeordneter Knoten zugeordnet ist. Diese Aktion ist nur für Knoten verfügbar, für die ein Loop-Knoten definiert ist (entweder manuell oder durch automatische Generierung).
	Alle Zuordnungen unter diesem Knoten entfernen entfernt alle Zuordnungen von Feldern, die innerhalb des Knotens enthalten sind, sowie alle Zuordnungen von Feldern, die innerhalb von untergeordneten Knoten dieses Knotens enthalten sind. Wenn Sie diese Aktion auf einem Stammknoten anwenden, werden alle Zuordnungen in einer Transformation entfernt. Wenn Sie diese Aktion auswählen, werden Sie in einer Meldung aufgefordert, zu bestätigen, dass Sie die Zuordnungen entfernen möchten.
	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 bei Schemata mit 750 oder weniger Knoten bis zu 8 Ebenen tief erweitert und bei 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 gibt an, dass Elemente mehr als einmal vorkommen können. Der Knoten darf nicht bereits ein Duplikat eines anderen Knotens sein. Ausschließlich zur Anzeige während des Entwurfs wird dem Namen des Duplikatknotens ein Hash angehängt (#) und eine erhöhte Nummer. Wenn Sie beispielsweise einen Knoten mit dem Namen transaction wird das erste Duplikat des Knotens angezeigt 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 doppelte Knoten 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 wiedergegeben 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 ist, 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 Entwurfszeit. Zur Laufzeit wird der ursprüngliche Name des duplizierten Knotens (der Knotenname mit einem angehängten Hash) verwendet. (#)und eine erhöhte Zahl) verwendet. Diese Aktion ist nur für Knoten verfügbar, die mit Knoten duplizieren erstellt wurden.
	Bedingung zu Knoten hinzufügen wird verwendet, um eine Zuordnung bedingt auf die in einem Knoten enthaltenen Felder anzuwenden. Diese Aktion ist nur für Knoten verfügbar, auf die noch keine Bedingung angewendet wurde. Wenn Sie diese Aktion auswählen, wird der Script geöffnet, damit Sie die Bedingung erstellen können. Einzelheiten zum Erstellen der Bedingung finden Sie unter Bedingte Zuordnung.
	Bedingung bearbeiten öffnet den Script zum Bearbeiten der vorhandenen Bedingung im Script. Diese Aktion ist nur für Knoten verfügbar, auf die bereits eine Bedingung angewendet wurde. Weitere Einzelheiten finden Sie unter Bedingte Zuordnung.
	Bedingung entfernen entfernt die Bedingung. Diese Aktion ist nur auf Knoten verfügbar, auf die bereits eine Bedingung angewendet wurde.

Zielfelder

Damit eine Transformation Ausgabedaten aus der Transformation ergibt, 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. indem Sie Quellobjekte, Variablen, Scripts oder benutzerdefinierte Werte den Zielfeldern zuordnen oder andere Script hinzufügen:

• Automatische Zuordnung
  Automapping wird verwendet, um Quell- und Zielfelder, deren Namen innerhalb identischer Datenstrukturen exakt übereinstimmen, automatisch zuzuordnen. Sie können Automapping mit der gesamten Datenstruktur oder innerhalb ausgewählter Quell- und Zielknoten durchführen.
• Zuordnen von Quellobjekten
  Zusätzlich zur automatischen Zuordnung können Quellfelder manuell einem Zielfeld zugeordnet werden. Wenn Sie ein Quellfeld einem Zielfeld zuordnen, 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.
• Benutzerdefinierte Werte zuordnen
  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 wird beschrieben, wie Scripts Transformation öffnen und darin auf Projektkomponenten und -funktionen verweisen, obwohl jede gültige Script verwendet werden kann.

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).