Erstellen Sie ein Script im Jitterbit Integration Studio

Einführung

In Jitterbit Script oder JavaScript geschriebene Scripts bieten die Flexibilität und Leistung, Daten zu transformieren, Berechnungen durchzuführen oder logische Validierungen vorzunehmen, die über die einfache Feldzuordnung hinausgehen.

Scripts können an vielen Stellen verwendet werden, unter anderem auf der Design-Canvas als Schritte einer Operation sowie in Transformations, um bestimmte Logik oder Bedingungen auf die Daten anzuwenden. Die Schritte zum Erstellen eines Script und zum Ausführen weiterer Aktionen für ein Script sind je nach Script unterschiedlich, wie auf dieser Seite beschrieben.

Script

Es gibt drei verschiedene Scripts, die sich in der Art ihrer Erstellung und Verwendung unterscheiden:

• Script als Projektkomponente
  Dieser Script kann als Schritt in einer Operation verwendet und/oder mit dem RunScript Funktion. Dieser Script wird als Projektkomponente in der Skriptkomponentenpalette sowie im Projektfenster angezeigt. Die Script kann entweder Jitterbit Script oder JavaScript.

• Script auf einem Zielfeld in einer Transformation
  Dieser Script kann für ein Feld in einer Transformation erstellt werden, um die angegebene Logik auf die Transformation anzuwenden. Der letzte im Script zurückgegebene Wert wird als Wert für das Zielfeld verwendet. Dieser Script ist nur für Zielfelder in einer Transformation verfügbar. Die Script muss Jitterbit Script sein.

• Script auf einem Zielknoten in einer Transformation
  Diese Art von Script kann auf einen Knoten in einer Transformation angewendet werden, um zu bestimmen, ob der verarbeitete Quelldatensatz an das Ziel ausgegeben werden soll. Wenn das Script ausgewertet wird als true, dann wird der Datensatz ausgegeben. Wenn das Script als false, dann wird der Datensatz übersprungen. Dieser Script ist nur auf Zielknoten in einer Transformation verfügbar. Die Script muss Jitterbit Script sein.

Script als Projektkomponente

Bei diesem Script handelt es sich um eine Projektkomponente, die als Schritt in einer Operation verwendet oder von einem anderen Script aufgerufen werden kann. Dazu wird RunScript Funktion. Sie können beispielsweise ein Script als Schritt in einem Operation vor oder nach einer Aktivität verwenden, um Daten abzurufen und dann die Script zu verarbeiten, oder Sie können ein Script ausführen, bevor Sie mit einer Transformation fortfahren.

Erstellen eines Script

An diesen Stellen kann ein neues Script als Projektkomponente erstellt werden:

• Die Tab Komponenten des Projektbereichs mithilfe der Option Neu erstellen in der Kategorie Scripts (siehe Aktionsmenü der Tab **Komponenten im Projektbereich Tab Komponenten).
• Die Design-Canvas mit einer Drop-Zone (siehe Dropzone-Aktionsmenü in Entwurfsfläche).

Neue Scripts werden mit dem Standardnamen Neues Skript erstellt. Nachfolgende neue Transformations mit Standardnamen werden mit einer in Klammern angehängten Nummer versehen.

Beim Erstellen eines neuen Script öffnet sich der Script Editor, in dem Sie das Script konfigurieren können (siehe Script Editor).

Aktionsmenü „Script “

Nachdem ein Script als Projektkomponente erstellt wurde, sind die Menüaktionen für dieses Script von diesen Orten aus zugänglich:

• 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 Aktionsmenü in Entwurfsfläche).

Jede dieser Menüaktionen ist verfügbar:

Menüelement	Beschreibung
	Anzeigen/Bearbeiten öffnet den Script, in dem Sie das Script erstellen können (siehe Script).
	Ausschneiden legt eine Kopie des Script in Ihre Zwischenablage und löscht das Script aus dem Projekt (siehe Komponentenwiederverwendung).
	Kopieren legt eine Kopie des Script in Ihre Zwischenablage (siehe Komponentenwiederverwendung).
	Duplicate erstellt ein neues, nicht referenziertes Script mit der gleichen Konfiguration wie das Script (siehe Komponentenwiederverwendung).
	Umbenennen positioniert den Cursor auf den Script, damit Sie bei Bedarf Änderungen vornehmen können.
	Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um alle anderen Teile des Projekts anzuzeigen, von denen das jeweilige Script abhängig ist (siehe Komponentenabhängigkeiten, Löschen und Entfernen).
	Zur Gruppe hinzufügen öffnet einen Dialog zum Erstellen einer neuen benutzerdefinierten Gruppe oder zum Hinzufügen des Script zu einer vorhandenen Gruppe (siehe Komponentengruppen).
	Löschen löscht das Script dauerhaft (siehe Komponentenabhängigkeiten, Löschen und Entfernen).
	Entfernen entfernt Verweise auf das Script als Operation Schritt auf der Design-Canvas (siehe Komponentenabhängigkeiten, Löschen und Entfernen).

Script für ein Zielfeld in einer Transformation

Diese Art von Script kann einem Feld in einer Transformation hinzugefügt werden, um die angegebene Logik auf die Transformation anzuwenden. Der letzte im Script zurückgegebene Wert wird als Wert für das Zielfeld verwendet. Sie können beispielsweise Skripts verwenden, um Felddaten von einem string zu einem integer, Werte verketten oder eine Datenbanksuche für ein Feld verwenden.

Das Erstellen eines neuen Script für ein Zielfeld erfolgt während der Transformation entweder im Zuordnungsmodus oder Script und ist beschränkt auf Jitterbit Script Sprache.

Um ein neues Script in einem Zielfeld hinzuzufügen, doppelklicken Sie entweder auf den Feldnamen oder zeigen Sie mit der Maus auf das Zielfeld und klicken Sie auf das 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:

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.

Diese öffnen im Script den editierbaren Script auf dem Zielfeld, wo Sie die Script für das Mapping eingeben oder bearbeiten können:

Um den vollständigen Script mit allen verfügbaren Optionen für das Script anzuzeigen, klicken Sie auf das Popout-Symbol oben rechts. Weitere Einzelheiten finden Sie unter Script. Schließen Sie den vollständigen Script Editor, um zu diesem Bildschirm zurückzukehren.

Um das Script zu entfernen, löschen Sie einfach den Text des Script. Weitere Informationen zu diesem Script finden Sie unter Mapping mit Scripts.

Script auf einem Zielknoten in einer Transformation

In einer Transformation wird auf einem Zielknoten ein Script erstellt, um zu bestimmen, ob der verarbeitete Quelldatensatz basierend auf einer definierten Bedingung an das Ziel ausgegeben werden soll. Die Bedingung bestimmt (ja oder nein), ob der Datensatz zugeordnet wird. Als Teil dieser Bestimmung können Sie eine Logik einschließen, um festzulegen, welche Werte bei der Zuordnung verwendet werden. Beispielsweise kann ein Datensatz nur verwendet werden, wenn die Größe eines Textfelds kleiner als ein angegebenes Maximum ist.

Das Erstellen eines neuen Script auf einem Zielknoten erfolgt während der Transformation entweder im Zuordnungsmodus oder Script und ist beschränkt auf Jitterbit Script Sprache. Bedingungen können als Scripts auf Zielknoten auf jeder Ebene einer Datenstruktur hinzugefügt werden.

Um ein neues Script auf einem Zielknoten hinzuzufügen, bewegen Sie den Mauszeiger über den Knotennamen und klicken Sie auf das Klicken Sie auf das Symbol für das Aktionsmenü, um das Aktionsmenü zu öffnen. Wählen Sie im Menü Bedingung zum Knoten hinzufügen:

Dadurch wird der bearbeitbare Script auf dem Zielknoten im Script geöffnet, wo Sie die Script nach Bedarf eingeben oder bearbeiten können. Das folgende Script erfordert beispielsweise, dass das Quellobjekt CleanStatus wertet aus zu true damit der Datensatz verarbeitet werden kann. Wenn CleanStatus wertet aus false, dann wird der Knoten übersprungen und dieser bestimmte Datensatz wird nicht verarbeitet.

Um den vollständigen Script mit allen verfügbaren Optionen für das Script anzuzeigen, klicken Sie auf das Popout-Symbol oben rechts. Weitere Einzelheiten finden Sie unter Script. Schließen Sie den vollständigen Script Editor, um zu diesem Bildschirm zurückzukehren.

Um die Bedingung zu bearbeiten oder zu entfernen, bewegen Sie den Mauszeiger über den Knotennamen und klicken Sie auf das Symbol für das Aktionsmenü, um das Aktionsmenü zu öffnen. Wählen Sie im Menü Bedingung bearbeiten oder Bedingung entfernen:

Weitere Informationen zu diesem Script finden Sie unter Bedingtes Mapping.