Endpunkte und Skripte in Jitterbit Studio wiederverwenden

Einführung

Dieser Leitfaden beschreibt Techniken zur Wiederverwendung von Arbeiten in Studio-Projekten: den Aufbau eines wiederverwendbaren Basisprojekts, die dynamische Konfiguration von Endpunkten mit Variablen, die Wiederverwendung von eigenständigen Skripten und das Importieren einzelner Komponenten aus einem bestehenden Projekt. Die Anwendung dieser Techniken reduziert die Duplizierung und hält die Konfiguration in Projekten und Umgebungen konsistent.

Basisprojekt

Ein typisches Szenario für die Wiederverwendung eines Projekts umfasst die Entwicklung eines Basisprojekts mit umfangreicher Nutzung von globalen Variablen und insbesondere von Projektvariablen.

Konfigurierbare Elemente (wie Endpunktanmeldeinformationen, optionale Feldzuordnungen, parametrisierte Abfragen, E-Mail-Adressen und Dateinamen) können als Projektvariablen bereitgestellt werden.

Das Basisprojekt kann auch allgemeine Funktionen wie Fehlerbehandlung oder die Verwendung von umgebungsweiten Caches enthalten.

Beim Exportieren eines Basisprojekts wählen Sie Projektvariablenwerte einbeziehen, um die Standardwerte aller Projektvariablen im Export zu erhalten. Dies ist wichtig für ein Basisprojekt, das auf parametrisierter Konfiguration basiert. Sie können auch wählen, ob Anmeldeinformationen, E-Mail-Benachrichtigungen und Betriebspläne einbezogen werden sollen. Siehe Projekt exportieren für die vollständige Liste der Exportoptionen.

Die exportierte JSON-Datei kann dann in jeder Umgebung oder Organisation als neues Projekt importiert werden. Das importierte Projekt wird nach dem Import nicht automatisch bereitgestellt; konfigurieren Sie die umgebungsspezifischen Projektvariablenwerte, bevor Sie bereitstellen.

Wiederverwendung von Endpunkten

Endpunkte, die durch die Konfiguration einer Verbindung und zugehöriger Aktivitäten mit Konnektoren erstellt werden, werden häufig in Operationen verwendet. Ein einzigartiger Endpunkt muss jedoch nicht unbedingt für jede Operation erstellt werden. Da Aktivitätskonfigurationen Variablen für Pfade und Dateinamen akzeptieren, können generische Endpunkte einmal erstellt und dann dynamisch mit globalen und Projektvariablen konfiguriert werden.

Zum Beispiel, nehmen wir an, dass eine HTTP v2 Verbindung und eine zugehörige Aktivität erstellt werden, und die Aktivitätskonfiguration einen Pfad angibt, der durch eine globale Variable definiert ist, wie gv_http_path. Ein Steuerungsskript kann verwendet werden, um gv_http_path nach Bedarf zu befüllen.

Ein weiteres Beispiel ist eine Datenbank Abfrage-Aktivität mit einer Bedingung. Ihre WHERE-Bedingung kann einer globalen Variable zugewiesen werden, wie gv_database_condition.

Die meisten Endpunkte können mithilfe von Variablen konfiguriert werden.

Skriptwiederverwendung

Eigenständige Skripte, die eine spezifische Funktion ausführen, wie das Zurückgeben einer Datenbankabfrage oder das Berechnen eines Ergebnisses aus einer Reihe von Argumenten, können Kandidaten für die Wiederverwendung sein, insbesondere wenn sie in mehreren Operationen verwendet werden.

Wenn ein Skript beispielsweise die DBLookup Funktion gegen eine Datenbanktabelle verwendet und diese Funktion im gesamten Projekt verwendet wird, kann ein eigenständiges Skript (getrennt von einer Operation) erstellt werden. Mithilfe der ArgumentList Funktion oder einfacher globaler Variablen kann das Skript Argumente akzeptieren und ein Ergebnis zurückgeben. Da jede Operationenkette einen anderen Geltungsbereich hat, kann dasselbe Skript sicher aus mehreren gleichzeitigen Operationen aufgerufen werden.

Für Hinweise zur sicheren Speicherung von Anmeldeinformationen in Projektvariablen siehe Verwalten von Endpunktanmeldeinformationen. Für Benennungsrichtlinien, die Projektvariablen in einem Basisprojekt konsistent halten, siehe Verwenden einer Benennungsrichtlinie für Variablen.

Selektiver Komponentenimport

Anstatt ein ganzes Basisprojekt zu importieren, können Sie spezifische Komponenten (wie einzelne Endpunkte oder Skripte) aus einem bestehenden Projekt oder einer Projekt-JSON-Datei in ein bestehendes Projekt importieren. Dies ist nützlich, wenn Sie einen gut getesteten Endpunkt oder ein gemeinsames Skript wiederverwenden möchten, ohne den Rest eines Basisprojekts zu importieren.

Um Komponenten selektiv zu importieren, öffnen Sie das Projektaktionsmenü und klicken Sie auf Importieren aus Projekt. Der Import erfolgt in zwei Schritten:

1. Importoptionen: Wählen Sie zwischen dem Hochladen einer lokalen Projekt-JSON-Datei oder dem Auswählen eines vorhandenen Projekts in derselben Umgebung wie das Zielprojekt.

2. Komponenten auswählen: Durchsuchen Sie die Komponenten nach Kategorien und wählen Sie die zu importierenden aus. Standardmäßig ist Abhängigkeiten automatisch auswählen aktiviert, was alle erforderlichen Abhängigkeiten einer ausgewählten Komponente automatisch einbezieht.

   Wenn eine importierte Komponente denselben Namen wie eine vorhandene Komponente desselben Typs hat, muss der Konflikt gelöst werden, bevor der Import abgeschlossen werden kann. Für Endpunkte können Sie einen vorhandenen Endpunkt verwenden oder einen neuen erstellen. Für andere Komponenten können Sie die vorhandene Komponente ersetzen oder beide behalten (die importierte Komponente wird mit einer numerischen Endung umbenannt).

   Importierte Komponenten werden in einem benutzerdefinierten Ordner mit der Bezeichnung Importiert gruppiert, der das Datum und die Uhrzeit des Imports trägt.

Für vollständige Details siehe Selektiver Import in Projekt exportieren und importieren.