Zum Inhalt springen

Skripteditor im Jitterbit Integration Studio

Einführung

In einem Projekt wird der vollständige Skripteditor für Skripte angezeigt, die als Projektkomponente erstellt wurden. Der Inline-Skripteditor ist in Transformationen vorhanden und kann durch Klicken auf das Erweiterungssymbol in der oberen rechten Ecke eines Skripts auf den vollständigen Skripteditor erweitert werden.

Der vollständige Skripteditor enthält alle Optionen, die auf dieser Seite behandelt werden, während der Inline-Editor eine vereinfachte Version für schnelles Bearbeiten bietet.

Für weitere Informationen zu Skripttypen siehe Skripttypen und Erstellung.

Zugriff auf den Skripteditor

Der vollständige Skripteditor ist der Standard-Skripteditor für Skripte, die als Projektkomponente erstellt wurden:

vollständiger Skripteditor

Um auf den vollständigen Skripteditor von der Inline-Version innerhalb von Transformationen zuzugreifen, klicken Sie auf das Pop-out-Symbol in der oberen rechten Ecke des Skripts:

Inline-Skripteditor Pop-out

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

Inline-Skripteditor annotiert

Legende

① Skript umbenennen
② Notizen hinzufügen
③ Skriptsprache auswählen
④ Skriptmodi umschalten
⑤ Speicherstatus
⑥ Skriptvalidierung
⑦ Skriptkomponentenpalette
⑧ Skript

Skript umbenennen

Wenn Sie ein neues Skript erstellen, lautet der Standardname Neues Skript. Subsequent neue Skripte mit Standardnamen werden mit einer hochgezählten Zahl in Klammern ergänzt. Skriptnamen müssen eindeutig sein und dürfen keine Schrägstriche (/) oder Doppelpunkte (:) enthalten, um gültig zu sein.

Um ein Skript im Skripteditor umzubenennen, bearbeiten Sie das Feld oben links:

rename

Skripte können auch von diesen Orten aus umbenannt werden:

Notizen hinzufügen

Sie können benutzerdefinierte Notizen zu einem Skript hinzufügen, die als Dokumentation oder Erinnerungen für sich selbst oder Projektmitarbeiter dienen. Um eine Notiz hinzuzufügen, klicken Sie auf das Notikons neben dem Feld Skripttyp.

Ein bearbeitbarer Bereich öffnet sich, in dem Sie den Text Ihrer Notiz eingeben können. Klicken Sie auf Posten, um die Notiz zum Skript hinzuzufügen:

note post

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

note posted

Wählen Sie die Skriptsprache

Skripte, die als Projektkomponente erstellt wurden, öffnen sich standardmäßig in der Jitterbit Script Sprache. Die Sprache kann über das Menü Skripttyp in JavaScript geändert werden:

skripttyp

Skripte, die innerhalb einer Transformation erstellt werden, entweder auf einem Ziel-Feld oder auf einem Knoten, sind auf die Jitterbit Script Sprache beschränkt.

Skriptmodi umschalten

Skripte werden standardmäßig im Bearbeitungsmodus geöffnet. Um das Skript im Testmodus zu öffnen, verwenden Sie den Schalter oben rechts, um Test auszuwählen:

bearbeiten testen

Für weitere Details siehe Skript-Test.

Speicherstatus

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

Der Speicherstatus wird oben im Skript unter dem Skriptnamen angezeigt. Diese Status sind möglich:

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

Um mehr über die automatische Speicherung zu erfahren, siehe Integration Studio Berechtigungen, Zusammenarbeit und Speichern.

Skriptvalidierung

Die Validierung eines Skripts wird mit jedem Tastendruck überprüft.

Wenn ein Skript gültig ist, wird eine Skript ist gültig-Nachricht in grün angezeigt:

skript ist gültig

Wenn ein Fehler erkannt wird, wird eine verkürzte Fehlermeldung in rot angezeigt, wobei die Skriptzeile mit dem Fehler hervorgehoben ist:

verkürzte Fehlermeldung

Um die gesamte Fehlermeldung anzuzeigen, klicken Sie auf das Erweiterungssymbol . Die vollständige Fehlermeldung öffnet sich in einem Dialog.

Die Fehlermeldungsdialog kann durch Klicken und Ziehen der unteren linken Ecke des Dialogs in der Größe verändert werden:

Fehlermeldungsdialog ändern

Skriptkomponentenpalette

Die Skriptkomponentenpalette ist eine von zwei Arten von Komponentenpaletten. (Die andere Art ist die Design-Komponentenpalette.)

Die Registerkarten der Skriptkomponentenpalette bieten Zugriff auf verschiedene Komponenten, die innerhalb eines Skripts verwendet werden können:

Skriptkomponentenpalette

Um die Skriptkomponentenpalette zu minimieren, klicken Sie auf das Minimieren-Symbol in der oberen rechten Ecke der Palette. Wenn sie minimiert ist, können Sie die Skriptkomponentenpalette erweitern, indem Sie auf eine der Registerkarten der Palette klicken.

Um innerhalb einer Registerkarte zu suchen, verwenden Sie das Suchfeld, um ein einzelnes Schlüsselwort oder eine Schlüsselwortzeichenfolge einzugeben. Um die Suche zu löschen, klicken Sie auf das Entfernen-Symbol .

Jede Registerkarte der Skriptkomponentenpalette wird im Folgenden zusammengefasst, mit zusätzlichen Details in Jitterbit Script oder JavaScript, je nach Sprache.

Tab
 Beschreibung
Quellobjekte Die Registerkarte Quellobjekte ist nur für Skripte vorhanden, die innerhalb einer Transformation erstellt wurden. Da dieser Skripttyp auf solche beschränkt ist, die die Sprache Jitterbit Script verwenden, ist das Referenzieren von Quellobjekten in Skripten, die in JavaScript geschrieben sind, nicht anwendbar.

Innerhalb eines Transformationsskripts können Sie auf Quelldaten zugreifen, indem Sie den Referenzpfad eines Feldes einfügen, oder Sie können auf Quelldatenknoten zugreifen, indem Sie den Referenzpfad eines Knotens einfügen.

Um einen Feld- oder Knotenreferenzpfad zu einem Transformationsskript (nur Jitterbit Script) hinzuzufügen, verwenden Sie eine dieser Methoden:

  • Ziehen Sie das Objekt aus der Palette in das Skript, um den Referenzpfad des Objekts einzufügen.
  • Doppelklicken Sie auf das Objekt in der Palette, um den Referenzpfad des Objekts an der Cursorposition innerhalb des Skripts einzufügen.
  • Geben Sie manuell den Referenzpfad zum Quellobjekt ein.
Für zusätzliche Details siehe Quellobjekte in Jitterbit Script.
Funktionen Die Registerkarte Funktionen bietet eine Liste von Funktionen, die in einem Skript für die im Skript ausgewählte Sprache (entweder Jitterbit Script oder JavaScript) verwendet werden können. Innerhalb eines Skripts können Sie Funktionen verwenden, indem Sie die für die Skriptsprache geeignete Funktionssyntax einfügen.

Um die Funktionssyntax zu einem Skript (Jitterbit Script oder JavaScript) hinzuzufügen, verwenden Sie eine dieser Methoden:

  • Ziehen Sie die Funktion aus der Palette in das Skript, um die Funktionssyntax einzufügen.
  • Doppelklicken Sie auf die Funktion in der Palette, um die Funktionssyntax an Ihrer Cursorposition innerhalb des Skripts einzufügen. Beim Einfügen der Funktionssyntax wird das erste Funktionsargument hervorgehoben und der Cursor wird an das Ende des Arguments verschoben.
  • Beginnen Sie, den Funktionsnamen einzugeben, und drücken Sie dann Control+Space, um eine Liste von Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Funktion aus, um die Funktionssyntax einzufügen.
  • Geben Sie die Funktionssyntax manuell ein.
Für weitere Informationen siehe die Dokumentation für jede Funktion nach Kategorie unter Funktionen.
Variablen Die Registerkarte Variablen bietet Zugriff auf Variablen, die global im gesamten Projekt referenziert werden können, einschließlich globaler Variablen, Projektvariablen und Jitterbit-Variablen. Innerhalb eines Skripts können Sie Variablen verwenden, indem Sie die Variablensyntax einfügen.

Um die Variablensyntax zu einem Skript (Jitterbit Script oder JavaScript) hinzuzufügen, verwenden Sie eine dieser Methoden:

  • Ziehen Sie die Variable aus der Palette in das Skript, um die Variablensyntax einzufügen.
  • Doppelklicken Sie auf die Variable in der Palette, um die Variablensyntax an Ihrer Cursorposition innerhalb des Skripts einzufügen.
  • Beginnen Sie, den Variablennamen einzugeben, und drücken Sie dann Control+Space, um eine Liste von Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Variable aus, um die Variablensyntax einzufügen.
  • Geben Sie die Variablensyntax manuell ein.
Für zusätzliche Details siehe Variablen in Jitterbit Script oder Variablen in JavaScript.
Plugins Die Registerkarte Plugins bietet eine Liste von Plugins, die innerhalb eines Skripts ausgeführt werden können. Innerhalb eines Skripts können Sie ein Plugin als Argument für die Funktion RunPlugin verwenden, indem Sie den Plugin-Referenzpfad einfügen.

Um einen Plugin-Referenzpfad zu einem Skript (nur Jitterbit Script) hinzuzufügen, verwenden Sie eine dieser Methoden:

  • Ziehen Sie das Plugin aus der Palette in das Skript, um sowohl die Funktion RunPlugin als auch die Plugin-Referenz einzufügen.
  • Doppelklicken Sie auf das Plugin in der Palette, um die Plugin-Referenz an Ihrer Cursorposition innerhalb des Skripts einzufügen.
  • Beginnen Sie, den Plugin-Namen einzugeben, und drücken Sie dann Control+Space, um eine Liste von Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie ein Plugin aus, um die Plugin-Referenz einzufügen.
  • Geben Sie die Plugin-Referenz manuell ein.
Für zusätzliche Details siehe Plugins in Jitterbit Script.
Operationen Diese Registerkarte bietet eine Liste von Operationen im Projekt, die in einem Skript referenziert werden können. Innerhalb eines Skripts können Sie eine Operation als Argument für Funktionen verwenden, indem Sie den Operationsreferenzpfad einfügen.

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

  • Ziehen Sie die Operation aus der Palette in das Skript, um sowohl die Funktion RunOperation als auch die Operationsreferenz einzufügen.
  • Doppelklicken Sie auf die Operation in der Palette, um die Operationsreferenz an Ihrer Cursorposition innerhalb des Skripts einzufügen.
  • Beginnen Sie, den Operationsnamen einzugeben, und drücken Sie dann Control+Space, um eine Liste von Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Operation aus, um die Operationsreferenz einzufügen.
  • Geben Sie die Operationsreferenz manuell ein.
Für zusätzliche Details siehe Operationen in Jitterbit Script.
Benachrichtigungen Die Benachrichtigungen bieten eine Liste von Benachrichtigungen im Projekt, die in einem Skript referenziert werden können. Innerhalb eines Skripts können Sie eine Benachrichtigung als Argument für die Funktion SendEmailMessage verwenden, indem Sie den Benachrichtigungsreferenzpfad einfügen.

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

  • Ziehen Sie die Benachrichtigung aus der Palette in das Skript, um sowohl die Funktion SendEmailMessage als auch die Benachrichtigungsreferenz einzufügen.
  • Doppelklicken Sie auf die Benachrichtigung in der Palette, um die Benachrichtigungsreferenz an Ihrer Cursorposition innerhalb des Skripts einzufügen.
  • Beginnen Sie, den Benachrichtigungsnamen einzugeben, und drücken Sie dann Control+Space, um eine Liste von Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Benachrichtigung aus, um die Benachrichtigungsreferenz einzufügen.
  • Geben Sie die Benachrichtigungsreferenz manuell ein.
Für ein Beispiel siehe Benachrichtigungen in Jitterbit Script.
Skripte Die Registerkarte Skripte bietet eine Liste aller anderen eigenständigen Projektkomponenten-Skripte im Projekt — geschrieben in entweder Jitterbit Script oder JavaScript — die in einem Skript referenziert werden können. Innerhalb eines Skripts können Sie ein anderes Skript als Argument für die Funktion RunScript verwenden, indem Sie den Skriptreferenzpfad einfügen.

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

  • Ziehen Sie das Skript aus der Palette in das Skript, um sowohl die Funktion RunScript als auch die Skriptreferenz einzufügen.
  • Doppelklicken Sie auf das Skript in der Palette, um die Skriptreferenz an Ihrer Cursorposition innerhalb des Skripts einzufügen.
  • Beginnen Sie, den Skriptnamen einzugeben, und drücken Sie dann Control+Space, um eine Liste von Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie ein Skript aus, um die Skriptreferenz einzufügen.
  • Geben Sie die Skriptreferenz manuell ein.
Für ein Beispiel siehe Skripte in Jitterbit Script.

Hinweis

Während ein Jitterbit-Skript ein JavaScript aufrufen kann, ist das umgekehrt nicht möglich. Ein Jitterbit-JavaScript kann kein anderes Skript einer beliebigen Sprache aufrufen.
Endpunkte Die Registerkarte Endpunkte bietet eine Liste von Endpunkten im Projekt, die in einem Skript referenziert werden können. Innerhalb eines Skripts können Sie Endpunkte als Argument für Funktionen verwenden, indem Sie den Verbindungs- oder Aktivitätsreferenzpfad einfügen.

Um einen Verbindungs- oder Aktivitätsreferenzpfad zu einem Skript (Jitterbit Script oder JavaScript) hinzuzufügen, verwenden Sie eine dieser Methoden:

  • Ziehen Sie die Verbindung oder Aktivität aus der Palette in das Skript, um die entsprechende Referenz einzufügen.
  • Doppelklicken Sie auf die Verbindung oder Aktivität in der Palette, um die entsprechende Referenz an Ihrer Cursorposition innerhalb des Skripts einzufügen.
  • Beginnen Sie, den Verbindungs- oder Aktivitätsnamen einzugeben, und drücken Sie dann Control+Space, um eine Liste von 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.
Je nach Endpunkt können Sie dann die Registerkarte Funktionen verwenden, um Funktionen hinzuzufügen, für die die Verbindungs- oder Aktivitätsreferenz als Argument verwendet werden soll.

Für zusätzliche Details siehe Endpunkte in Jitterbit Script oder Endpunkte in JavaScript.

Skript

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

In Jitterbit Script müssen Skripte innerhalb eines <trans>-Öffnungstags und eines </trans>-Schlussstags eingeschlossen werden, es sei denn, es werden Funktionen verwendet, die speziell verlangen, dass Code außerhalb dieser Tags platziert wird, wie mehrere Datenbankfunktionen.

In JavaScript müssen Skripte innerhalb eines <javascript>-Öffnungstags und eines </javascript>-Schlussstags eingeschlossen werden.

Dies sind die Hauptmerkmale des Skriptbereichs:

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

  • Klammerhervorhebung: Wenn Sie den Cursor unmittelbar vor oder nach einer Klammer platzieren, die Teil eines Satzes von öffnenden und schließenden Klammern ist, wird jede Klammer des Satzes mit einem Rand um die Klammer hervorgehoben, um den Satz zu kennzeichnen. Diese Klammernsätze werden hervorgehoben: (), [], {}.

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

  • Automatische Validierung: Harmony bietet eine grundlegende Syntaxüberprüfung und hebt Zeilen mit Fehlern hervor. Wenn das Skript die grundlegende Syntaxvalidierung besteht, wird eine Zeile unter dem Skriptbereich angezeigt, die Skript ist gültig lautet. Wenn das Skript die grundlegende Syntaxvalidierung nicht besteht, werden hier spezifische Fehlermeldungen zeilenweise bereitgestellt. Das heißt, nachdem ein Fehler in einer Zeile behoben wurde, können zusätzliche Syntaxfehler für nachfolgende Zeilen gemeldet werden.

  • Drag-and-Drop: Ziehen Sie Komponenten aus der Palette und lassen Sie sie im Skriptbereich oder in ein Ziel-Feld fallen, um sie automatisch mit der richtigen Syntax einzufügen.

  • Automatische Vervollständigung: Während Sie tippen, können Sie Autovervollständigungsvorschläge anzeigen, die mit der eingegebenen Zeichenfolge beginnen, indem Sie Control+Space verwenden. Wenn nur ein Vorschlag verfügbar ist, wird er automatisch eingefügt. Wenn mehr als ein Vorschlag verfügbar ist, können Sie mit den Pfeiltasten der Tastatur durch die Liste navigieren und Enter oder Tab drücken, um den Vorschlag in den Skriptbereich einzufügen.

  • Blockeinrückung: Wenn eine komplette Zeile oder mehrere Zeilen ausgewählt sind, wird durch Drücken von Tab die ausgewählte(n) Zeile(n) um einen Tabulator nach rechts eingerückt. Ebenso verschiebt Shift+Tab die ausgewählten Zeilen um einen Tabulator nach links. Wenn kein Text ausgewählt ist, verschiebt Shift+Tab die Zeile nach links zu der Stelle, an der sich der Cursor befindet.

Darüber hinaus können die standardmäßigen Funktionen des Browsers zum Rückgängigmachen, zur Steuerung der Schriftgröße und zur Suche im Skript verwendet werden.