Mapping mit Scripts in Transformations im Jitterbit Integration Studio

Einführung

Alle Transformation bestehen aus Scripts auf einzelnen Knoten und Feldern innerhalb eines Schema.

Sie müssen diese Scripts nicht unbedingt manuell erstellen, um die Zuordnung zu erstellen. Viele Zuordnungen werden visuell erstellt, z. B. durch Ziehen und Ablegen von Quellobjekten oder Variablen auf ein Zielfeld, sie führen jedoch dazu, dass im Hintergrund ein Script erstellt wird. Unabhängig von der Methode, mit der die Zuordnung erstellt wurde, ist das Ergebnis immer dasselbe: ein Script auf einem Zielknoten oder Zielfeld.

Auf dieser Seite wird beschrieben, wie Scripts Transformation öffnen und darin auf Projektkomponenten und -funktionen verweisen. Beachten Sie jedoch, dass jede gültige Script verwendet werden kann.

Öffnen Sie ein Script

Bevor Sie Script hinzufügen können, müssen Sie die Ansicht aufrufen, in der Sie das Script für ein einzelnes Feld oder einen Knoten bearbeiten können. Das Hinzufügen eines Script zu einem Knoten wird separat unter Bedingte Zuordnung behandelt.

Hinzufügen eines Script

Das Hinzufügen eines Script zu einem Feld kann entweder im Mapping-Modus oder Script. Um einem Zielfeld ein neues Script hinzuzufügen, führen Sie einen der folgenden Schritte aus:

• Doppelklicken Sie auf den Feldnamen.

• Bewegen Sie den Mauszeiger über das Zielfeld und klicken Sie auf Klicken Sie oben rechts in einem Zielfeld auf das Symbol „Hinzufügen“, um ein Aktionsmenü zu öffnen. Wählen Sie im Menü Script hinzufügen aus:

  

Dadurch wird der editierbare Script im Zielfeld im Script geöffnet, wo Sie die Script eingeben oder bearbeiten für die Zuordnung.

Bearbeiten eines Script

Um ein Script für ein Zielfeld zu bearbeiten, das bereits eine Zuordnung hat, doppelklicken Sie entweder auf den Feldnamen oder klicken Sie auf das Script oben rechts in einem Zielfeld.

Dadurch wird der editierbare Script im Zielfeld im Script geöffnet, wo Sie die Script eingeben oder bearbeiten für die Zuordnung.

Script eingeben oder bearbeiten

Beim Hinzufügen oder Bearbeiten eines Script öffnet sich im Zielfeld im Script der editierbare Script, in dem Sie die Script für das Mapping eingeben oder bearbeiten können:

Unter dem Script zeigt ein Text an, ob das Script gültig ist. Informationen zur Script finden Sie unter Jitterbit Script.

Umschalten des Script

Um den Script wieder auf die ursprüngliche Blockanzeige umzuschalten, klicken Sie auf das Symbol zum Zusammenklappen.

Öffnen Sie den vollständigen Script Editor

Um in einem größeren Script zu arbeiten, klicken Sie auf das Popout-Symbol oben rechts im Zielfeld, um den vollständigen Script Editor zu öffnen. Nachdem Sie den vollständigen Script geöffnet haben, klicken Sie auf das Zurück-Symbol, um zu diesem Bildschirm zurückzukehren.

Entfernen des Script

Um das Script zu entfernen, löschen Sie einfach den Text des Script.

Hinzufügen eines Quellobjekts

Innerhalb der Komponentenpalette finden Sie eine Liste der Funktionen, die in einem Script verwendet werden können, im Tab Quellobjekte.

Innerhalb eines Transformation können Sie auf Quelldaten verweisen, indem Sie den Referenzpfad eines Felds einfügen, oder Sie können auf Quelldatenknoten verweisen, indem Sie den Referenzpfad eines Knotens einfügen.

So fügen Sie einem Transformation einen Feld- oder Knotenreferenzpfad hinzu (Jitterbit Script), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie das Objekt aus der Palette in das Script, um den Referenzpfad des Objekts einzufügen.
• Doppelklicken Sie auf das Objekt in der Palette, um den Referenzpfad des Objekts an der Cursorposition im Script einzufügen.
• Geben Sie den Referenzpfad zum Quellobjekt manuell ein.

Siehe Quellobjekte zuordnen für detaillierte Informationen zum Zuordnen von Quellobjekten, einschließlich des Hinzufügens eines Quellobjekts zum Script. Weitere Einzelheiten finden Sie unter Quellobjekte in Jitterbit Script.

Hinzufügen einer Funktion

Innerhalb der Komponentenpalette finden Sie eine Liste der Funktionen, die in einem Script verwendet werden können, im Tab Funktionen.

Innerhalb eines Script können Sie Funktionen verwenden, indem Sie die für die Script entsprechende Funktionssyntax einfügen.

So fügen Sie die Funktionssyntax zu einem Script hinzu (Jitterbit Script oder JavaScript), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie die Funktion aus der Palette in das Script, um die Funktionssyntax einzufügen.
• Doppelklicken Sie auf die Funktion in der Palette, um die Funktionssyntax an der Cursorposition im Script einzufügen. Beim Einfügen der Funktionssyntax wird das erste Funktionsargument hervorgehoben und der Cursor an das Ende des Arguments verschoben.
• Beginnen Sie mit der Eingabe des Funktionsnamens und drücken Sie dann Control+Space um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Funktion aus, um die Funktionssyntax einzufügen.
• Geben Sie die Funktionssyntax manuell ein.

Weitere Informationen finden Sie in der Dokumentation für jede Funktion nach Kategorie unter Funktionen.

Hinzufügen einer Variable

Innerhalb der Komponentenpalette finden Sie eine Liste der in einem Script verwendbaren Variablen im Tab Variablen.

Innerhalb eines Script können Sie Variablen verwenden, indem Sie die Variablensyntax einfügen.

So fügen Sie die Variablensyntax zu einem Script hinzu (Jitterbit Script oder JavaScript), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie die Variable aus der Palette in das Script, um die Variablensyntax einzufügen.
• Doppelklicken Sie auf die Variable in der Palette, um die Variablensyntax an der Cursorposition im Script einzufügen.
• Beginnen Sie mit der Eingabe des Variablennamens und drücken Sie dann Control+Space um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Variable aus, um die Variablensyntax einzufügen.
• Geben Sie die Variablensyntax manuell ein.

Siehe Variablen zuordnen für detaillierte Informationen zum Zuordnen von Variablen, einschließlich des Hinzufügens einer Variable zum Script. Weitere Einzelheiten finden Sie unter Variablen in Jitterbit Script.

Plugin hinzufügen

Innerhalb der Komponentenpalette finden Sie eine Liste der Plugins, die in einem Script verwendet werden können. Tab Plugins.

Innerhalb eines Script können Sie ein Plugin als Argument für die RunPlugin Funktion durch Einfügen des Plugin-Referenzpfads.

So fügen Sie einem Script einen Plugin-Referenzpfad hinzu (Jitterbit Script), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie das Plugin aus der Palette in das Script, um sowohl die RunPlugin Funktion und die Plugin-Referenz.
• Doppelklicken Sie auf das Plugin in der Palette, um die Plugin-Referenz an der Cursorposition im Script einzufügen.
• Beginnen Sie mit der Eingabe des Plugin-Namens und drücken Sie dann Control+Space um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie ein Plugin aus, um die Plugin-Referenz einzufügen.
• Geben Sie die Plugin-Referenz manuell ein.

Weitere Einzelheiten finden Sie unter Plugins in Jitterbit Script.

Hinzufügen eines Operation

Innerhalb der Komponentenpalette finden Sie eine Liste der in einem Script verwendbaren Operationen im Tab Operationen.

Innerhalb eines Script können Sie eine Operation als Argument für Funktionen verwenden, indem Sie den Operation einfügen.

So fügen Sie einem Script einen Operation hinzu (Jitterbit Script), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie die Operation aus der Palette in das Script, um sowohl die RunOperation Funktion und Operation.
• Doppelklicken Sie auf die Operation in der Palette, um die Operation an der Cursorposition im Script einzufügen.
• Beginnen Sie mit der Eingabe des Operation und drücken Sie dann Control+Space, um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Operation aus, um die Operation einzufügen.
• Geben Sie die Operation manuell ein.

Weitere Einzelheiten finden Sie unter Operationen in Jitterbit Script.

Hinzufügen einer Benachrichtigung

Innerhalb der Komponentenpalette finden Sie eine Liste der Benachrichtigungen, die in einem Script verwendet werden können. Tab Benachrichtigungen.

Innerhalb eines Script können Sie auf eine Benachrichtigung als Argument für verweisen SendEmailMessage-Funktion durch Einfügen des Benachrichtigungsreferenzpfads.

So fügen Sie einem Script einen Benachrichtigungsreferenzpfad hinzu (Jitterbit Script), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie die Benachrichtigung aus der Palette in das Script, um sowohl die SendEmailMessage-Funktion und die Benachrichtigungsreferenz.
• Doppelklicken Sie auf die Benachrichtigung in der Palette, um den Benachrichtigungsverweis an der Cursorposition im Script einzufügen.
• Beginnen Sie mit der Eingabe des Benachrichtigungsnamens und drücken Sie dann Control+Space um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Benachrichtigung aus, um die Benachrichtigungsreferenz einzufügen.
• Geben Sie die Benachrichtigungsreferenz manuell ein.

Ein Beispiel finden Sie unter Benachrichtigungen in Jitterbit Script.

Hinzufügen eines Script

Innerhalb der Komponentenpalette finden Sie eine Liste weiterer Scripts, die in einem Script verwendet werden können, im Tab Scripts.

Innerhalb eines Script können Sie auf ein anderes Script als Argument für verweisen RunScript-Funktion durch Einfügen des Script.

So fügen Sie einem Script einen Script hinzu (Jitterbit Script), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie das Script aus der Palette in das Script, um sowohl die RunScript-Funktion und die Script.
• Doppelklicken Sie auf das Script in der Palette, um die Script an der Cursorposition innerhalb des Script einzufügen.
• Beginnen Sie mit der Eingabe des Script und drücken Sie dann Control+Space, um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie ein Script aus, um die Script einzufügen.
• Geben Sie die Script manuell ein.

Ein Beispiel finden Sie unter Scripts in Jitterbit Script.

Endpoints hinzufügen

Innerhalb der Komponentenpalette finden Sie eine Liste der Endpoints, die für die Verwendung in einem Script verfügbar sind. Tab Endpoints.

Innerhalb eines Script können Sie Endpoints als Argument für Funktionen referenzieren, indem Sie den Verbindungs- oder Aktivitätsreferenzpfad einfügen.

So fügen Sie einem Script einen Verbindungs- oder Aktivitätsreferenzpfad hinzu (Jitterbit Script oder JavaScript), verwenden Sie eine der folgenden Methoden:

• Ziehen Sie die Verbindung oder Aktivität aus der Palette in das Script, um die entsprechende Referenz einzufügen.
• Doppelklicken Sie auf die Verbindung oder Aktivität in der Palette, um die entsprechende Referenz an der Cursorposition im Script einzufügen.
• Beginnen Sie mit der Eingabe des Verbindungs- oder Aktivitätsnamens und drücken Sie dann Control+Space, um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Verbindung oder Aktivität aus, um die entsprechende Referenz einzufügen.
• Geben Sie die Verbindungs- oder Aktivitätsreferenz manuell ein.

Abhängig vom Endpoint können Sie dann die Tab Funktionen verwenden, um Funktionen hinzuzufügen, für die die Verbindung oder die Aktivitätsreferenz als Argument verwendet werden soll.

Weitere Einzelheiten finden Sie unter Endpoints in Jitterbit Script.

Bearbeiten oder Entfernen einer Zuordnung

Im Mapping-Modus oder Script, können Sie Zielfeldzuordnungen einzeln bearbeiten oder entfernen oder alle in einem Knoten enthaltenen Feldzuordnungen entfernen:

• Bearbeiten oder entfernen eine Zuordnung im Zuordnungsmodus.
• Bearbeiten oder entfernen eine Zuordnung im Script.