Script in Transformations im Jitterbit Integration Studio
Einführung
Der Script bietet detaillierte Ansichten von Feldern und erweiterte Tools zum Hinzufügen von Scripts zum Mapping. Siehe auch Common mode elements für Elemente der Benutzeroberfläche, die von mehreren Anzeigemodi gemeinsam genutzt werden.
Zugriff auf den Script
Im Script können Sie bis zur Script jedes Zielfelds navigieren und haben mehr Kontrolle über die Zuordnung der einzelnen Felder. Sie können den Script von jedem einzelnen Zielfeld aus im Zuordnungsmodus aufrufen auf eine der folgenden Arten:
- Doppelklicken Sie auf den Namen eines Zielfelds.
- Bewegen Sie den Mauszeiger bei Zielfeldern, die noch keine Zuordnung haben, über das Zielfeld und klicken Sie dann auf Symbol „Hinzufügen“ und wählen Sie Script hinzufügen.
- Klicken Sie für Zielfelder, die bereits eine Zuordnung haben, auf das Script.
Im Script werden die Zielstruktur und die Zuordnungen auf der linken Seite angezeigt. Wenn sich der Cursorfokus im Script eines bestimmten Zielfelds befindet, wird um das Zielfeld ein violetter Rahmen angezeigt. Alle Komponenten, die in einem bestimmten Script verwendet werden können, werden in der Komponentenpalette auf der rechten Seite angezeigt:
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. Wenn Sie außerdem eine Transformation beenden, während sich der Cursorfokus in einem Script befindet, Integration Studio merkt sich das letzte Script, auf das Sie zugegriffen haben, und öffnet und scrollt automatisch dorthin, wenn Sie das nächste Mal auf die Transformation zugreifen.
Hinweis
Zurück zum Mapping-Modus Klicken Sie im Script auf den Pfeil auf der linken Seite des Bildschirms:
Zielknoten
Ein angegebenes Schema besteht aus Knoten, die Felder enthalten können, sowie aus anderen untergeordneten Knoten, die ebenfalls Felder enthalten können. Quelldaten können nicht den Zielknoten selbst zugeordnet werden, da sie nur den Feldern zugeordnet werden können, die die Zielknoten enthalten. Nachdem Sie ein Schema angegeben haben, können Sie auf die für jeden Knoten verfügbaren Optionen zugreifen, indem Sie den Mauszeiger über den Zielknoten bewegen und dann auf das 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 ( Ob ein doppelter Knoten an anderen Stellen im gesamten Projekt wiedergegeben wird, hängt davon ab, wie das Schema definiert wurde:
| |
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) ( 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), dessen Script derzeit nicht geöffnet ist, stehen folgende Optionen zur Verfügung:
-
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).