Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

Script Editor im Jitterbit Integration Studio

Einführung

In einem Projekt wird der vollständige Script Editor für Scripts angezeigt, die als Projektkomponente erstellt wurden. Der Inline Script Editor ist in Transformations vorhanden und kann durch Klicken auf das Symbol zum Erweitern zum vollständigen Script Editor erweitert werden. oben rechts in einem Script.

Der vollständige Script Editor enthält alle auf dieser Seite behandelten Optionen, während der Inline-Editor eine abgespeckte Version für die schnelle Bearbeitung bietet.

Weitere Informationen zu Scripts finden Sie unter Script und -erstellung.

Zugriff auf den Script Editor

Der vollständige Script Editor ist der Standard Script Editor für Scripts, die als Projektkomponente erstellt werden:

vollständiger Script Editor

Um auf den vollständigen Script innerhalb der Inline-Version innerhalb der Transformations zuzugreifen, klicken Sie auf das Popout-Symbol oben rechts im Script:

Popout des Inline Script Editors

Die Werkzeuge und Bereiche der Seite werden auf der gesamten Seite erwähnt. Sie sind im folgenden Bild gekennzeichnet:

Inline Script Editor mit Anmerkungen versehen

Legende

Ein Script umbenennen
Notizen hinzufügen
Wählen Sie die Script aus
Script umschalten
Status speichern
Script
Komponentenpalette Script
Script "> Script

Umbenennen eines Script

Wenn Sie ein neues Script erstellen, lautet sein Standardname „Neues Skript“. Nachfolgende neue Scripts mit Standardnamen werden mit einer fortlaufenden Nummer in Klammern versehen. Script müssen eindeutig sein und dürfen keine Schrägstriche enthalten (/) oder Doppelpunkte (:) gültig zu sein.

Um ein Script im Script Editor umzubenennen, bearbeiten Sie das Feld oben links:

umbenennen

Scripts können auch an diesen Orten umbenannt werden:

Notizen hinzufügen

Sie können einem Script benutzerdefinierte Notizen hinzufügen, die Ihnen oder Projektmitarbeitern als Dokumentation oder Erinnerung dienen. Um eine Notiz hinzuzufügen, klicken Sie auf das Notizsymbol neben dem Feld Script.

Es öffnet sich ein Bearbeitungsbereich, in dem Sie den Text Ihrer Notiz eingeben können. Klicken Sie auf Posten, um die Notiz zum Script hinzuzufügen:

Beitrag beachten

Ihre gepostete Notiz wird zusammen mit Ihrem Namen und einem Zeitstempel angezeigt. Jeder mit Bearbeitungszugriff auf das Script kann Notizen entfernen, indem er auf das Symbol „Entfernen“ klickt. Um die Notiz zu schließen, klicken Sie auf einen anderen Bereich der Benutzeroberfläche. Wenn eine oder mehrere Notizen vorhanden sind, wird auf dem Notizsymbol ein orangefarbener Punkt angezeigt:

Notiz gepostet

Wählen Sie die Script

Als Projektkomponente erstellte Scripts öffnen sich in Jitterbit Script Sprache standardmäßig. Die Sprache kann auf JavaScript geändert werden mithilfe des Menüs Script:

Script

Scripts, die innerhalb einer Transformation erstellt werden, entweder auf einem Zielfeld oder auf einem Knoten, sind beschränkt auf Jitterbit Script Sprache.

Script umschalten

Scripts werden standardmäßig im Bearbeitungsmodus geöffnet. Um das Script im Testmodus zu öffnen, wählen Sie mit dem Schalter oben rechts Test aus:

Test bearbeiten

Weitere Einzelheiten finden Sie unter Script.

Status speichern

Nachdem Sie Änderungen an einem Script vorgenommen haben, speichern Sie das Script mit Control+S (Windows oder Linux) oder Command+S (macOS).

Der Speicherstatus wird oben im Script unter dem Script angezeigt. Folgende Status sind möglich:

  • Gespeichert
  • Sie haben nicht gespeicherte Änderungen
  • Speichern...
  • Script aufgrund eines Konflikts mit einem anderen Benutzer nicht gespeichert

Weitere Informationen zum automatischen Speichern finden Sie unter Integration Studio Berechtigungen, Zusammenarbeit und Speichern.

Script

Die Validierung eines Script wird bei jedem Tastendruck überprüft.

Wenn ein Script gültig ist, wird die Meldung Script ist gültig in Grün angezeigt:

Script ist gültig

Wenn ein Fehler erkannt wird, wird eine gekürzte Fehlermeldung in Rot angezeigt, wobei die Script mit dem Fehler hervorgehoben ist:

abgeschnittene Fehlermeldung

Um die gesamte Fehlermeldung anzuzeigen, klicken Sie auf das Symbol „Erweitern“ Die vollständige Fehlermeldung wird in einem Dialogfeld geöffnet.

Die Größe des Dialogfelds lässt sich durch Klicken und Ziehen der unteren linken Ecke anpassen:

Fehlermeldungsdialogfeld vergrößern

Script

Die Skriptkomponentenpalette ist einer von zwei Typen von Komponentenpaletten. (Der andere Typ ist die Design-Komponentenpalette.)

Über die Registerkarten der Script haben Sie Zugriff auf verschiedene Komponenten, die in einem Script verwendet werden können:

Skriptkomponentenpalette

Um die Skriptkomponentenpalette auszublenden, klicken Sie auf das Symbol zum Ausblenden befindet sich oben rechts in der Palette. Wenn die Skriptkomponentenpalette ausgeblendet ist, können Sie sie erweitern, indem Sie auf eine der Registerkarten der Palette klicken.

Um innerhalb einer Tab zu suchen, geben Sie im Suchfeld ein einzelnes Schlüsselwort oder eine Schlüsselwortfolge ein. Um die Suche zu löschen, klicken Sie auf das Symbol „Entfernen“ .

Die einzelnen Tab der Skriptkomponentenpalette werden unten zusammengefasst. Weitere Einzelheiten finden Sie in Jitterbit Script oder JavaScript abhängig von der Sprache.

Tab
Beschreibung
Quellobjekte Die Tab Quellobjekte ist nur für Scripts verfügbar, die innerhalb einer Transformation erstellt wurden. Da dieser Script auf diejenigen beschränkt ist, die Jitterbit Script Sprache, die auf Quellobjekte in Scripts verweist, die in JavaScript geschrieben sind ist nicht anwendbar.

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

Um einem Script einen Feld- oder Transformation Script (Jitterbit Script), verwenden Sie eine dieser 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.
Weitere Einzelheiten finden Sie unter Quellobjekte in Jitterbit Script.

Funktionen Die Tab Funktionen bietet eine Liste der Funktionen, die in einem Script für die im Script ausgewählte Sprache verwendet werden können (entweder Jitterbit Script oder JavaScript). Innerhalb eines Script können Sie Funktionen verwenden, indem Sie die für die Script passende Funktionssyntax einfügen.

Um die Funktionssyntax zu einem Script hinzuzufügen (Jitterbit Script oder JavaScript), verwenden Sie eine dieser 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 zu jeder Funktion nach Kategorie unter Funktionen.

Variablen Die Tab Variablen bietet Zugriff auf Variablen, die im gesamten Projekt global referenziert werden können, einschließlich globaler Variablen, Projektvariablen und Jitterbit-Variablen. Innerhalb eines Script können Sie Variablen verwenden, indem Sie die Variablensyntax einfügen.

Um die Variablensyntax zu einem Script hinzuzufügen (Jitterbit Script oder JavaScript), verwenden Sie eine dieser 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.
Weitere Einzelheiten finden Sie unter Variablen in Jitterbit Script oder Variablen in JavaScript.

Plugins Die Tab Plugins enthält eine Liste von Plugins, die in einem Script ausgeführt werden können. Innerhalb eines Script können Sie ein Plugin als Argument für die RunPlugin Funktion durch Einfügen des Plugin Referenzpfads.

Um einem Plugin ( Jitterbit Script nur), verwenden Sie eine dieser 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 Informationen finden Sie unter Plugins in Jitterbit Script.

Operationen Diese Tab enthält eine Liste der Operationen im Projekt, die in einem Script referenziert werden können. Innerhalb eines Script können Sie eine Operation als Argument für Funktionen verwenden, indem Sie den Operation einfügen.

Um einem Script einen Operation hinzuzufügen ( Jitterbit Script nur), verwenden Sie eine dieser Methoden:

  • Ziehen Sie die Operation von der Palette in das Script, um sowohl die RunOperation Funktion und die 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.

Benachrichtigungen Die Benachrichtigungen enthalten eine Liste der Benachrichtigungen im Projekt, die in einem Script referenziert werden können. Innerhalb eines Script können Sie eine Benachrichtigung als Argument für referenzieren.SendEmailMessage Funktion durch Einfügen des Benachrichtigungsreferenzpfads.

Um einem Script (Jitterbit Script nur), verwenden Sie eine dieser 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 die Benachrichtigungsreferenz 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.

Scripts Die Tab Scripts bietet eine Liste aller anderen eigenständigen Scripts im Projekt - geschrieben entweder in Jitterbit Script oder JavaScript - die in einem Script referenziert werden können. Innerhalb eines Script können Sie auf ein anderes Script als Argument für verweisen.RunScript Funktion durch Einfügen des Script.

Um einem Script ( Jitterbit Script nur), verwenden Sie eine dieser Methoden:

  • Ziehen Sie das Script aus der Palette in das Script, um sowohl das 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.

Hinweis

Während ein Jitterbit Script ein JavaScript aufrufen kann, ist der umgekehrte Fall nicht der Fall. Ein Jitterbit-JavaScript kann kein anderes Script irgendeiner Sprache aufrufen.

Endpoints Die Tab Endpoints enthält eine Liste der Endpoints im Projekt, die in einem Script referenziert werden können. Innerhalb eines Script können Sie Endpoints als Argument für Funktionen referenzieren, indem Sie den Verbindungs- oder Aktivitätsreferenzpfad einfügen.

Um einem Script einen Verbindungs- oder Aktivitätsreferenzpfad hinzuzufügen (Jitterbit Script oder JavaScript), verwenden Sie eine dieser 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 Verbindungs- oder Aktivitätsreferenz als Argument verwendet werden soll.

Weitere Einzelheiten finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.

Script

Der Script ist der Textbereich, in dem Sie ein Script in der entsprechenden Sprache eingeben: Jitterbit Script oder JavaScript.

In Jitterbit Script, müssen Scripts in einem <trans> öffnender Tag und </trans> schließendes Tag, es sei denn, Sie verwenden Funktionen, die ausdrücklich erfordern, dass Code außerhalb dieser Tags platziert wird, wie beispielsweise mehrere Datenbankfunktionen.

In JavaScript, müssen Scripts in einem <javascript> öffnender Tag und </javascript> schließendes Tag.

Dies sind die Hauptfunktionen des Script:

  • Syntaxhervorhebung: Verschiedene Farben werden verwendet, um die verschiedenen Teile eines Ausdrucks, wie Funktionsnamen, Zeichenfolgen und Variablen, zu unterscheiden.

  • Klammern hervorheben: Wenn Sie den Cursor direkt vor oder nach einer Klammer platzieren, die Teil einer Klammernfolge ist, wird jede Klammer mit einem Rahmen hervorgehoben. Folgende Klammernfolgen werden hervorgehoben: (), [], {}.

  • Zeilennummerierung: Zeilennummern werden am linken Rand des Script angezeigt.

  • Automatische Validierung: Harmony bietet eine grundlegende Syntaxprüfung und hebt fehlerhafte Zeilen hervor. Wenn das Script die grundlegende Syntaxprüfung besteht, wird unterhalb des Script der Hinweis „Skript ist gültig“ angezeigt. Wenn das Script die grundlegende Syntaxprüfung nicht besteht, werden hier zeilenweise spezifische Fehlerinformationen bereitgestellt. Das bedeutet, dass nach der Behebung eines Fehlers in einer Zeile möglicherweise weitere zu behebende Syntaxfehler für die folgenden Zeilen gemeldet werden.

  • Drag-and-Drop: Wenn Sie ein Element aus der Komponentenpalette in den Script ziehen, wird das Element automatisch in der entsprechenden Syntax zur Verwendung im Script eingefügt.

  • Autovervollständigung: Während der Eingabe können Sie Autovervollständigungsvorschläge anzeigen, die mit der eingegebenen Zeichenfolge beginnen, indem Sie Control+Space. Wenn nur ein Vorschlag verfügbar ist, wird dieser automatisch eingefügt. Wenn mehrere Vorschläge verfügbar sind, können Sie mit den Pfeiltasten der Tastatur durch die Liste navigieren und drücken Enter oder Tab um den Vorschlag in den Script einzufügen.

  • Blockeinrückung: Wenn eine oder mehrere vollständige Zeilen ausgewählt sind, drücken Sie Tab rückt die ausgewählten Zeilen um einen Tab nach rechts ein. Ähnlich verhält es sich mit Shift+Tab verschiebt die markierten Zeilen um einen Tabulator nach links. Wenn kein Text markiert ist, Shift+Tab verschiebt die Zeile nach links zur Cursorposition.

Darüber hinaus können Standardbrowserfunktionen zum Rückgängigmachen, Steuern der Schriftgröße und Suchen innerhalb des Script verwendet werden.