Ein Projekt in Jitterbit Studio exportieren und importieren

Einführung

Studio ermöglicht den Import von Projektkomponenten zwischen Organisationen und Umgebungen. Sie können Projekte als JSON-Dateien exportieren oder direkt mit Projekten in derselben Umgebung arbeiten.

Zusammen ermöglichen die Export- und Importfunktionen den Transfer von Projekten und deren Komponenten in andere Organisationen nach Bedarf.

Studio-Projektexporte liegen im JSON-Dateiformat vor. Nach dem Export eines Projekts als JSON-Datei können Sie dieses in jede beliebige Organisation importieren.

Ein Projekt exportieren

Die Optionen Export oder Projekt exportieren sind an diesen Stellen verfügbar:

• Die Seite Projekte (siehe Kartenansicht oder Listenansicht unter Projekte).
• Die Projekt-Symbolleiste (siehe Menü „Projektaktionen" unter Projekt-Symbolleiste).

Darüber hinaus ist der Projektexport-Bildschirm über den Link Export am unteren Ende des Bildschirms Projekteinstellungen erreichbar (siehe Projekteinstellungen bearbeiten unter Projekterstellung und -konfiguration).

Nach Auswahl von Export oder Projekt exportieren öffnet sich der Projektexport-Bildschirm, auf dem Sie die Exportoptionen wählen und das Projekt als JSON-Datei generieren:

• Anmeldedaten einschließen: Schließt die in Anmeldedatenfeldern von Projektkomponentenkonfigurationsbildschirmen angegebenen Werte in das exportierte Projekt ein.

  Hinweis

  Diese Option kann je nach Organisationsrichtlinie Anmeldedaten dürfen exportiert werden deaktiviert sein.

  Die spezifischen Konfigurationsfelder, die als Anmeldedatenfelder behandelt werden, variieren je nach Projektkomponente. Sie enthalten häufig Felder wie Passwörter oder Sicherheitstoken. Entwickler von benutzerdefinierten Connectoren, die das Connector SDK verwenden, können solche Felder mit einem dieser Attribute kennzeichnen:

  • "secret": "true": Kennzeichnet nur, dass das Feld als Anmeldedatenfeld behandelt wird. Der Wert des Feldes wird im Projektexport verschlüsselt.

  • "widgetHint": "password": Kennzeichnet, dass das Feld als Anmeldedatenfeld behandelt wird, und maskiert den Wert in der Studio-Benutzeroberfläche, indem jedes Zeichen durch einen schwarzen Punkt ersetzt wird. Der Wert des Feldes wird im Projektexport verschlüsselt.

  Die Werte von Projektvariablen selbst werden nicht als Anmeldedaten behandelt, auch wenn die Option Wert ausblenden in der Benutzeroberfläche ausgewählt ist (siehe Projektvariablen). Stattdessen wird durch die Auswahl Projektvariablenwerte einschließen gesteuert, ob Projektvariablenwerte eingeschlossen werden.

  Wenn eine Projektvariable in einem Anmeldedatenfeld verwendet wird (unabhängig davon, ob Projektvariablenwerte einschließen ausgewählt ist), ist der "value" des Anmeldedatenfeldes der verschlüsselte Wert der Darstellung der Projektvariablennamen in Klammersyntax und aller anderen Eingaben, falls vorhanden.

  Wenn Anmeldedaten einschließen nicht ausgewählt ist, ist der "value" des Anmeldedatenfeldes nicht im Projektexport enthalten, außer wenn eine Projektvariable in einem Anmeldedatenfeld verwendet wird. In diesem Fall wird die unverschlüsselte Klartexteingabe des Anmeldedatenfeldes eingeschlossen. Dies kann problematisch sein, wenn das Anmeldedatenfeld neben der Projektvariable noch andere Eingaben verwendet, obwohl dieser Anwendungsfall ungewöhnlich ist. Beispielsweise würde eine Feldeingabe von [pv_password]1234suffix im Projektexport als [pv_password]1234suffix eingeschlossen.

• E-Mail-Benachrichtigungen einschließen: Schließt E-Mail-Benachrichtigungen in das exportierte Projekt ein. Diese Option gilt für alle E-Mail-Benachrichtigungen in einem Projekt, unabhängig davon, ob sie mit Operationsaktionen konfiguriert sind, um bei Erfolg, Fehler oder SOAP-Fehler ausgeführt zu werden, oder ob sie in einem Skript referenziert sind.

• Projektvariablenwerte einschließen: Schließt Projektvariablen-Standardwerte in das exportierte Projekt ein.

  Die Werte von Projektvariablen, die mit der Option Wert ausblenden konfiguriert sind (siehe Projektvariablen), werden im Projektexport verschlüsselt.

• Zeitpläne einschließen: Schließt Operationszeitpläne in das exportierte Projekt ein.

• Exportieren: Generiert und lädt das Projekt als JSON-Datei herunter. Standardmäßig verwendet der Name der JSON-Datei den Namen des Projekts.

  Hinweis

  Ein exportiertes Projekt behält den Projektverlauf nicht bei.

Import

Projekte und Komponenten lassen sich mit einer dieser beiden Optionen importieren:

1. Projekt importieren: Diese Option (zugänglich über die Seite Projekte) ermöglicht den Import eines gesamten Projekts aus einer JSON-Datei in die Organisation.

2. Selektiver Import: Diese Option (zugänglich über das Projektaktionsmenü in einem Projekt) ermöglicht den Import bestimmter Komponenten aus einem anderen Projekt in derselben Umgebung oder aus einer Projekt-JSON-Datei in ein vorhandenes Projekt.

Projekt importieren

Ein Projekt lässt sich durch Klicken auf Importieren auf der Seite Projekte importieren:

Auf dem nächsten Bildschirm wird das Projekt importiert:

• Projektdatei: Verwenden Sie die Schaltfläche Durchsuchen, um zu einer Projekt-JSON-Datei zu navigieren, die aus Studio exportiert wurde.

  Tipp

  Falls das Projekt benutzerdefinierte Konnektoren verwendet, müssen diese vor dem Projektimport in der Organisation vorhanden sein. Um einen Connector Builder-Konnektor zu exportieren und in einer anderen Organisation zu importieren, siehe Connector Builder-Exporte und -Importe. Um einen Connector SDK-Konnektor in einer anderen Organisation zu installieren, siehe Implementing a Harmony Connector.

  Nach Auswahl einer Datei werden diese Felder verfügbar:

  • Projektname: Der Projektname wird aus der JSON-Datei vorausgefüllt. Um einen anderen Namen zu verwenden, können Sie ihn hier bearbeiten. Der Projektname muss diese Kriterien erfüllen:

    • Eindeutig für jede Umgebung sein.

    • Darf nicht bereits als Design Studio-Projektname in derselben Umgebung verwendet werden.

    Hinweis

    Falls ein Projekt mit demselben Namen bereits in der Harmony-Cloud vorhanden ist, gehen Sie zur Seite Management Console > Projekte, um das bereitgestellte Projekt zu verwalten.

  • Organisation: Verwenden Sie das Dropdown-Menü, um die Organisation auszuwählen, in die das Projekt importiert werden soll. Falls nur eine Organisation vorhanden ist, wird diese standardmäßig ausgewählt.

  • Umgebung: Verwenden Sie das Dropdown-Menü, um die Umgebung auszuwählen, in die das Projekt importiert werden soll.

    Vorsicht

    Falls das Quellprojekt Konnektoren verwendet, die nur auf privaten Agenten verfügbar sind, können Sie es nicht in eine Umgebung importieren, die einer Cloud-Agent-Gruppe zugeordnet ist. Diese Umgebungen werden weiterhin im Dropdown-Menü Umgebung angezeigt, können aber nicht ausgewählt werden.

  • E-Mail-Benachrichtigungen einschließen: Standardmäßig werden E-Mail-Benachrichtigungen, die beim Export des Projekts enthalten waren, beim Import des Projekts eingeschlossen. Diese Option gilt für alle E-Mail-Benachrichtigungen in einem Projekt, unabhängig davon, ob sie mit Operationsaktionen konfiguriert sind, um bei Erfolg, Fehler oder SOAP-Fehler ausgeführt zu werden, oder ob sie in einem Skript referenziert sind. Um E-Mail-Benachrichtigungen vom Import auszuschließen, deaktivieren Sie das Kontrollkästchen.

    Vorsicht

    Verweise auf eine E-Mail-Benachrichtigungskomponente in einem Skript werden nicht entfernt, auch wenn E-Mail-Benachrichtigungen ausgeschlossen sind. Möglicherweise müssen Sie fehlerhafte Verweise nach dem Ausschließen von E-Mails korrigieren.

  • Zeitpläne einschließen: Standardmäßig werden Operationszeitpläne beim Importieren des Projekts eingeschlossen, wenn sie beim Exportieren des Projekts enthalten waren. Um Zeitpläne vom Import auszuschließen, deaktivieren Sie das Kontrollkästchen.

  • Globale Endpunkte: Alle globalen Endpunkte, die vom importierten Projekt verwendet werden, werden aufgelistet und müssen der ausgewählten Umgebung mit einer dieser Optionen hinzugefügt werden:

    

    • Vorhandenen globalen Endpunkt verwenden: Wird nur angezeigt, wenn der globale Endpunkt bereits in der Organisation vorhanden ist. Wählen Sie diese Option, um einen Umgebungsendpunkt zu einem vorhandenen globalen Endpunkt für die ausgewählte Umgebung hinzuzufügen. Verwenden Sie das Menü, um den vorhandenen globalen Endpunkt auszuwählen:

      

      Wenn der vorhandene globale Endpunkt bereits einen Umgebungsendpunkt für die ausgewählte Umgebung hat, wird dieser Umgebungsendpunkt für das importierte Projekt verwendet. Wenn der vorhandene globale Endpunkt keinen Umgebungsendpunkt für die ausgewählte Umgebung hat, werden die im importierten Projekt bereitgestellten Anmeldedaten verwendet (falls zutreffend). Andernfalls muss der Umgebungsendpunkt nach dem Import konfiguriert werden.

    • Neuen globalen Endpunkt erstellen: Wählen Sie diese Option, um einen neuen globalen Endpunkt für die Organisation zu erstellen:

      

      Wenn das Projekt importiert wird, wird der globale Endpunkt der ausgewählten Umgebung hinzugefügt und muss nach dem Import konfiguriert werden.

• Importieren: Klicken Sie, um das Projekt zu importieren. Wenn das Projekt erfolgreich importiert wurde, wird das importierte Projekt auf der Design-Canvas geöffnet. Darüber hinaus ist das neue Projekt auf der Seite Projekte verfügbar.

  Nach dem Importieren des Projekts ist es noch nicht bereitgestellt. Wenn Sie bereit sind, es bereitzustellen, siehe Projektbereitstellung.

Selektiver Import

Um nur bestimmte Komponenten in ein vorhandenes Projekt zu importieren, verwenden Sie das Projektaktionsmenü und klicken Sie auf Aus Projekt importieren. Sie können Komponenten entweder aus einer Projekt-JSON-Datei oder aus einem anderen Projekt in derselben Umgebung importieren.

Schritt 1: Importoptionen

Wählen Sie ein Projekt aus oder laden Sie es hoch:

• Wählen Sie, um eine lokale Datei hochzuladen: Sie können eine Projekt-JSON-Datei aus der Upload-Zone bereitstellen. Sie können eine Projekt-JSON-Datei in die Upload-Zone ziehen und ablegen oder eine Datei manuell auswählen.

  Wenn Sie darauf klicken, wird ein Dateiauswahldialog geöffnet. Wählen Sie die Datei aus und klicken Sie dann auf Hochladen:

  

• Oder wählen Sie ein vorhandenes Projekt aus Ihrer Umgebung aus: Wählen Sie ein vorhandenes Projekt aus der Umgebung des aktuell aufgerufenen Projekts aus.

• Weiter: Klicken Sie, um zum nächsten Schritt zu gehen.

• Abbrechen: Klicken Sie, um den Importvorgang abzubrechen und zum Projekt zurückzukehren.

Schritt 2: Komponenten auswählen

Wählen Sie die zu importierenden Komponenten aus:

• Aus Projekt importieren: Dieses Fenster zeigt den Namen des Quellprojekts und die verfügbaren Komponenten zum Importieren an.

• In Projekt importieren: Dieses Fenster zeigt den Namen des Projekts, auf das zugegriffen wird, und alle Komponenten im Projekt an.

  • Betroffene Elemente anzeigen / Ausblenden: Zeigt (Standard) oder verbirgt Komponenten, die vom Import nicht betroffen sind.

• Projektkomponenten: Jede Komponentenkategorie eines Projekts wird neben einer Zahl in Klammern angezeigt, die angibt, wie viele Komponenten sich in der Kategorie befinden. Komponenten in einer Komponentenkategorie werden alphabetisch aufgelistet. Verwende im Fenster Aus Projekt importieren die Kontrollkästchen, um die Komponenten auszuwählen, die in das aktuell zugängliche Projekt importiert werden sollen.

• Abhängigkeiten automatisch auswählen: Aktiviere diese Option, um zu steuern, wie Komponentenabhängigkeiten während des Imports behandelt werden. Wenn diese Option aktiviert ist (Standard), werden beim Auswählen einer Komponente automatisch alle erforderlichen Abhängigkeiten ausgewählt, die nicht einzeln abgewählt werden können. Wenn diese Option deaktiviert ist, kannst du einzelne Komponenten auswählen, ohne ihre Abhängigkeiten automatisch einzubeziehen.

• Suche: Verwende das Suchfeld, um ein einzelnes Schlüsselwort oder eine Schlüsselwortzeichenfolge einzugeben. Die Schlüsselwortzeichenfolge wird im Namen der Komponente blau hervorgehoben:

  

• Alle Kategorien erweitern / Reduzieren: Erweitert oder reduziert alle Projektkomponentenkategorien.

• In Projekt verschieben: Aktiviert, wenn eine Komponente im Fenster Aus Projekt importieren ausgewählt ist. Nach dem Klicken werden die ausgewählten Komponenten und ihre Abhängigkeiten zum Fenster In Projekt importieren hinzugefügt. Zum Projekt hinzugefügte Komponenten werden mit einem blauen Symbol Neu gekennzeichnet:

  

• Importierte Komponenten zu einem neuen Workflow hinzufügen: Wähle diese Option, um Vorgänge in einen neuen Workflow zu importieren. Der Workflow heißt Imported und enthält das Datum und die Uhrzeit des Imports im Format YYYY-MM-DD HH:MM:SS (z. B. Imported 2025-10-15 08:30:00). Diese Option ist nicht verfügbar, bis du mindestens einen Vorgang zum Importieren auswählst.

• Konflikte: Wenn eine importierte Komponente denselben Namen wie eine Komponente in derselben Komponentenkategorie hat, tritt ein Konflikt auf:

  

  Falls vorhanden, müssen Konflikte gelöst werden, um den Import abzuschließen. Verwende die Pfeile nach oben und unten, um zu jedem Konflikt zu navigieren.

  Endpunkte mit Konflikten haben diese Aktionen:

  

  • Vorhandenen Endpunkt verwenden: Wähle diese Option, um einen Endpunkt zu verwenden, der im aktuell zugänglichen Projekt konfiguriert ist. Verwende das Menü, um den vorhandenen Endpunkt auszuwählen.

    • Komponente ersetzen oder kopieren: Wenn der vorhandene Endpunkt des Projekts und der importierte Endpunkt denselben Aktivitätstyp mit übereinstimmenden Namen haben, werden diese Optionen verfügbar:

      • Ersetzen: Wähle diese Option, um den vorhandenen Aktivitätstyp durch den importierten Aktivitätstyp zu ersetzen.

      • Beide behalten: Wähle diese Option, um beide Endpunkt-Aktivitätstypen als unabhängige Komponenten zu behalten. Der Name der importierten Komponente wird mit einer inkrementellen Zahl in Klammern ergänzt.

  • Neuen Endpunkt erstellen: Wähle diese Option, um einen neuen Endpunkt im aktuell zugänglichen Projekt zu erstellen. Verwende das Menü, um Global (siehe Globale Endpunkte) oder Projektebene auszuwählen.

  Alle Komponenten mit Konflikten (außer Endpunkten) haben diese Aktionen:

  • Ersetzen: Ersetzt die vorhandene Komponente durch die importierte Komponente. Importierte Komponenten, die als Ersatz verwendet werden, werden mit einem violetten Symbol Ersetzen gekennzeichnet:

• Beide behalten: Behält beide Komponenten. Der Name der importierten Komponente wird mit einer inkrementellen Nummer in Klammern ergänzt. Diese Komponenten sind visuell mit einem blauen Symbol Neu gekennzeichnet:

  

Bei konfliktierenden Komponenten mit Inhalts- oder Konfigurationsunterschieden wird neben dem Konflikt eine Schaltfläche Änderungen anzeigen angezeigt. Klicken Sie auf Änderungen anzeigen, um eine Diff-Ansicht zu öffnen, die den Inhalt oder die Konfiguration der Komponente im aktuell zugegriffenen Projekt mit der eingehenden Komponente vergleicht. Die Diff-Ansicht bleibt vor und nach der Bestätigung von Konfliktlösungen zugänglich und ist erneut verfügbar, wenn Sie auf Änderungen bearbeiten klicken. Die Schaltfläche wird nur angezeigt, wenn Unterschiede vorhanden sind.

Die Titelleiste der Diff-Ansicht zeigt den Komponententyp und -namen an (z. B. „Decision: Decision" oder „Operation: Bulk Insert"). Die folgenden Steuerelemente sind in der Titelleiste verfügbar:

• Ausklappen: Öffnet die Diff-Ansicht in einem neuen Popup-Fenster. Klicken Sie erneut, um sie in die Inline-Position zurückzubringen.
• Maximieren / Wiederherstellen: Erweitert die Diff-Ansicht, um den verfügbaren Bildschirmbereich auszufüllen, oder stellt sie auf ihre Standardgröße zurück.
• Schließen: Schließt die Diff-Ansicht.

Sie können die Diff-Ansicht an ihrer Titelleiste ziehen, um sie an einer beliebigen Stelle auf dem Bildschirm zu positionieren, und ihre Größe ändern, indem Sie ihre Kanten oder Ecken ziehen. Eine vertikale Bildlaufleiste ist verfügbar, wenn die Diff viele Änderungen enthält.

Die Diff-Ansicht verwendet eines der folgenden Formate, je nach Komponententyp:

• Code-Diff-Ansicht: Wird für Skripte und Transformationen verwendet. Zeigt zwei Bereiche nebeneinander:

  • Linker Bereich: Zeigt den Inhalt der Komponente im aktuell zugegriffenen Projekt. Entfernte Zeilen sind rot hervorgehoben.

  • Rechter Bereich: Zeigt den Inhalt der eingehenden Komponente. Hinzugefügte Zeilen sind grün hervorgehoben.

  Bei Transformationen wird jede geänderte Zuordnungsregel als ausklappbarer Abschnitt angezeigt, der mit dem Feldpfad gekennzeichnet ist (z. B. „Mapping rule json/isActive"). Klicken Sie auf das Caret-Symbol, um einzelne Abschnitte zu erweitern oder zu reduzieren.

• Feldvergleichs-Diff-Ansicht: Wird für Tools, E-Mail-Benachrichtigungen, Operationen (einschließlich ihrer Zeitpläne, Aktionen und Optionen), Projektvariablen, Connector-Endpunkte und Connector-Aktivitäten verwendet. Zeigt eine Tabelle mit den Spalten Name, Vorher und Nachher, die jedes geänderte Feld auflistet:

  

  Eine geänderte Zeile ist in der Spalte Vorher rot und in der Spalte Nachher grün getönt, und die spezifischen Zeichen oder Wörter, die sich innerhalb eines Werts geändert haben, sind stärker hervorgehoben. Verwandte Felder werden unter Abschnittsüberschriften gruppiert, z. B. die einzelnen Bedingungen eines Decision-Tools, die verschachtelten Optionsgruppen eines Connector-Endpunkts oder die Schritte einer Operation. Ein Feld, dessen Wert auf eine Projektvariable oder globale Variable verweist, wird als verknüpfte Referenz angezeigt, die den Variablennamen statt des Literalwerts zeigt. Ein Anmeldeinformationsfeld, z. B. ein Passwort oder Sicherheitstoken, ist in den Spalten Vorher und Nachher maskiert.

  Ein Feld, dessen Name oder Wert zu lang für die Anzeige in der Tabelle ist, oder dessen Wert ein Objekt oder Array ist (als JSON-String angezeigt), enthält ein Symbol zum Erweitern. Klicken Sie auf das Symbol, um eine Inline-Diff dieses Feldsinhalts zu öffnen, die als Code-Diff mit rot hervorgehobenen entfernten Zeilen und grün hervorgehobenen hinzugefügten Zeilen angezeigt wird.

  Bei einer Connector-Aktivität, die Daten abfragt oder abruft, kann ein Feld Response das Antwortschema als erweiterbaren Baum anzeigen. Zum Schema hinzugefügte Felder sind grün hervorgehoben.

  Bei einem Connector-Endpunkt-Konflikt ist diese gleiche Feldvergleichs-Diff-Ansicht über die Schaltfläche Änderungen anzeigen neben der unter Komponente ersetzen oder kopieren aufgelisteten Aktivität verfügbar (siehe oben).

Ein Steps-Zeile listet die von einem Vorgang verwendeten Aktivitäten auf, und eine Operation-Zeile listet den Vorgang auf, auf den ein Decision- oder Invoke Operation-Tool verweist. Wenn eine referenzierte Aktivität oder ein Vorgang denselben Namen wie eine Komponente im aktuell zugegriffenen Projekt hat, wird "(source project)" an seinen Namen in der Spalte After angehängt, um die eingehende Komponente von der vorhandenen Komponente mit demselben Namen zu unterscheiden.

Wenn eine referenzierte Aktivität oder ein Vorgang selbst ein Konflikt ist und Sie ihn so auflösen, dass die vorhandene Komponente im Projekt wiederverwendet wird, aktualisiert sich die Spalte After, um den Namen anzuzeigen, den die eingehende Komponente nach dem Import tatsächlich haben wird.

Diese Aktionen sind nur aktiviert, wenn Änderungen an Konflikten vorgenommen werden:

• Replace All: Klicken Sie, um Replace (oben beschrieben) für alle Komponentenkonflikte in Massen auszuwählen.

• Keep All: Klicken Sie, um Keep both (oben beschrieben) für alle Komponentenkonflikte in Massen auszuwählen.

• Confirm changes: Nur aktiviert, wenn für alle Konflikte eine Aktion ausgewählt ist. Klicken Sie, um die ausgewählten Konfliktaktionen zu speichern. Nach dem Klicken wird die Schaltfläche Finish aktiviert.

• Edit changes: (Sichtbar nach dem Klicken auf Confirm changes.) Klicken Sie, um die Konfliktauflösungen zu bearbeiten.

• Reset all: Setzt das Projekt auf seinen ursprünglichen Zustand zurück und entfernt alle neuen oder ersetzten Komponenten aus dem Panel Import to project.

• Cancel: Klicken Sie, um den Importvorgang abzubrechen und zum Projekt zurückzukehren.

• Prev / Next:

• Import: Klicken Sie, um die Komponenten zu importieren und zum Projekt zurückzukehren. Importierte Komponenten werden in eine benutzerdefinierte Gruppe mit dem Namen Imported kategorisiert, an die das Datum und die Uhrzeit des Imports angehängt werden (im Format YYYY-MM-DD HH:MM:SS):