Script im Jitterbit Integration Studio

Einführung

In einem Projekt wird der vollständige Script für Scripts angezeigt, die als Projektkomponente erstellt wurden. Der Inline Script ist in Transformations vorhanden und kann durch Klicken auf das Symbol zum Erweitern zum vollständigen Script 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 zum schnellen Bearbeiten 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 zuzugreifen, die in Transformations vorhanden ist, klicken Sie auf das Popout-Symbol oben rechts im Script:

Popout des Inline-Script Editors

Die Tools 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 in Klammern angehängten Nummer versehen. Script müssen eindeutig sein und dürfen keine Schrägstriche enthalten (/) oder Doppelpunkte (:) um gültig zu sein.

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

umbenennen

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

Die Tab Workflows im Projektbereich (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).
Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
Die Design-Canvas (siehe Umbenennen von Workflows, Operationen und Operation in Entwurfsfläche).

Notizen hinzufügen

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

Es öffnet sich ein editierbarer Bereich, in dem Sie den Text Ihrer Notiz eingeben können. Klicken Sie auf Posten, um die Notiz dem 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 Teil 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 zur automatischen Speicherung 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, die den Fehler enthält, hervorgehoben ist:

abgeschnittene Fehlermeldung

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

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

Größe des Fehlermeldungsdialogs ändern

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 in das Suchfeld ein einzelnes Schlüsselwort oder eine Schlüsselwortzeichenfolge ein. Um die Suche zu löschen, klicken Sie auf das Symbol „Entfernen“ .

Nachfolgend finden Sie eine Zusammenfassung der einzelnen Tab der Skriptkomponentenpalette. 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 vorhanden, die innerhalb einer Transformation erstellt werden. Da dieser Script auf diejenigen beschränkt ist, die Jitterbit Script verwenden Sprache, die Quellobjekte in Scripts referenziert, 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. So fügen Sie 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 Position Ihres Cursors 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 enthält 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 geeignete 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 Position Ihres Cursors im Script einzufügen. Beim Einfügen der Funktionssyntax wird das erste Funktionsargument hervorgehoben und Ihr Cursor wird 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.
Variablen	Die Tab Variablen bietet Zugriff auf Variablen, auf die im gesamten Projekt global verwiesen werden kann, darunter globale 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 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. 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 das `RunPlugin` Funktion durch Einfügen des Plugin-Referenzpfads. Um einem Script (Jitterbit Script einen Plugin-Referenzpfad hinzuzufügen), verwenden Sie eine dieser Methoden: Ziehen Sie das Plugin aus der Palette in das Script, um sowohl das `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.
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), verwenden Sie eine dieser Methoden: Ziehen Sie die Operation aus 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 Position Ihres Cursors 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 bieten 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), 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 enthält 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 ein anderes Script als Argument für das referenzieren `RunScript`-Funktion durch Einfügen des Script. Um einem Script einen Script hinzuzufügen (Jitterbit Script), 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, gilt das Gegenteil nicht. 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. 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 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 den 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: Durch unterschiedliche Farben werden die verschiedenen Teile eines Ausdrucks, wie etwa Funktionsnamen, Zeichenfolgen und Variablen, unterschieden.
Klammern hervorheben: Wenn Sie den Cursor unmittelbar vor oder nach einer Klammer platzieren, die Teil eines Satzes öffnender und schließender Klammern ist, wird jede Klammer des Satzes mit einem Rahmen um die Klammer herum angezeigt, um den Satz hervorzuheben. Die folgenden Klammersätze werden hervorgehoben: (), [], {}.
Zeilennummerierung: Zeilennummern werden am linken Rand des Script angezeigt.
Automatische Validierung: Harmony bietet eine grundlegende Syntaxprüfung und hebt Zeilen mit Fehlern hervor. Wenn das Script die grundlegende Syntaxprüfung besteht, wird in einer Zeile unter dem Script Skript ist gültig angezeigt. Wenn das Script die grundlegende Syntaxprüfung nicht besteht, werden hier zeilenweise spezifische Fehlerinformationen bereitgestellt. Das heißt, nach der Behebung eines Fehlers in einer Zeile werden möglicherweise weitere zu behebende Syntaxfehler für nachfolgende Zeilen gemeldet.
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 mehr als ein Vorschlag verfügbar ist, 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 komplette Zeilen ausgewählt sind, drücken Sie Tab rückt die ausgewählten Zeilen einen Tab nach rechts ein. Ebenso Shift+Tab verschiebt die markierten Zeilen um einen Tabulator nach links. Wenn kein Text markiert ist, Shift+Tab verschiebt die Zeile nach links zur Position des Cursors.

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