Exportieren und Importieren eines Projekts in Jitterbit Integration Studio

Einführung

Auf dieser Seite wird beschrieben, wie Sie ein Projekt exportieren und importieren sowie einzelne Komponenten importieren aus einer JSON-Projektdatei in ein Projekt.

Gemeinsam ermöglichen Ihnen die Export- und Importfunktionen, Projekte und ihre Komponenten nach Bedarf in andere Organisationen zu migrieren.

Integration Studio Projektexporte erfolgen im Format einer JSON-Datei. Sobald Sie einen JSON-Projektexport haben, können Sie ihn in jede Organisation importieren.

Exportieren eines Projekts

Die Optionen Exportieren oder Projekt exportieren sind von diesen Orten aus zugänglich:

• Die Seite Projekte (siehe Kachel-Ansicht oder Listenansicht in Projekte).
• Die Projektsymbolleiste (siehe Aktionsmenü in der Projektsymbolleiste).

Darüber hinaus ist der Projektexport-Bildschirm über den Link Exportieren unten im Bildschirm Projekteinstellungen zugänglich (siehe Projekteinstellungen bearbeiten in Projekterstellung und -konfiguration).

Wenn Sie Exportieren oder Projekt exportieren auswählen, wird der Projektexportbildschirm geöffnet, wo Sie die Exportoptionen auswählen und das Projekt als JSON-Datei generieren:

• Anmeldeinformationen einschließen: Schließt die in den Anmeldeinformationenfeldern der Konfigurationsbildschirme der Projektkomponente angegebenen Werte in das exportierte Projekt ein.

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

  • "secret": "true": Gibt nur an, dass das Feld als Anmeldeinformationsfeld behandelt wird. Der Wert des Felds wird beim Projektexport verschlüsselt.

  • "widgetHint": "password": Gibt an, dass das Feld als Anmeldeinformationsfeld behandelt wird und maskiert auch den Wert im Integration Studio Benutzeroberfläche, indem jedes Zeichen durch einen schwarzen Aufzählungspunkt ersetzt wird. Der Wert des Felds wird beim Projektexport verschlüsselt.

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

  Wenn eine Projektvariable in einem Anmeldeinformationsfeld verwendet wird (unabhängig davon, ob Projektvariablenwerte einschließen ausgewählt ist), wird das Anmeldeinformationsfeld "value" ist der verschlüsselte Wert der Syntaxdarstellung in eckigen Klammern des Projektvariablennamens und aller anderen Eingaben, falls vorhanden.

  Wenn Anmeldeinformationen einschließen nicht ausgewählt ist, wird das Feld „Anmeldeinformationen“ "value"ist nicht im Projektexport enthalten, außer wenn eine Projektvariable in einem Anmeldeinformationsfeld verwendet wird. In diesem Fall ist die unverschlüsselte Klartexteingabe des Anmeldeinformationsfelds enthalten. Dies kann von Belang sein, wenn das Anmeldeinformationsfeld neben der Projektvariable auch andere Eingaben verwendet, obwohl dieser Anwendungsfall ungewöhnlich ist. Beispielsweise kann eine Feldeingabe von [pv_password]1234suffix wäre im Projektexport enthalten als [pv_password]1234suffix.

• Email Benachrichtigungen einschließen: Schließt Email Benachrichtigungen ein im exportierten Projekt. Diese Option gilt für alle Email Benachrichtigungen in einem Projekt, unabhängig davon, ob sie mit Operation konfiguriert sind bei Erfolg, Misserfolg oder SOAP Fehler ausgeführt werden oder wenn sie in einem Script referenziert werden.

• Projektvariablenwerte einschließen: Schließt Projektvariable ein Standardwerte im exportierten Projekt.

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

• Zeitpläne einschließen: Schließt Operation ein im exportierten Projekt.

• Export: Erstellt und lädt das Projekt als JSON-Datei herunter. Standardmäßig verwendet der JSON-Dateiname den Namen des Projekts.

  Hinweis

  Ein exportiertes Projekt behält den Projektverlauf nicht bei.

Import

Sobald ein Projekt exportiert, können Sie die JSON-Datei des Projekts mit einer dieser beiden Importoptionen importieren:

1. Projekt importieren: Diese Option (erreichbar über den Menüpunkt Projekte Seite) ermöglicht Ihnen, das gesamte Projekt in Ihre Organisation zu importieren.

2. Komponenten aus einem Projekt importieren (Beta): Diese Option (erreichbar über das Aktionsmenü in einem Projekt) ermöglicht Ihnen, nur bestimmte Komponenten aus der JSON-Projektdatei in ein bestehendes Projekt in Ihrer Organisation zu importieren.

Importieren eines Projekts

Sie können ein Projekt importieren, indem Sie auf Projekte auf Importieren klicken Seite:

Auf dem nächsten Bildschirm importieren Sie das Projekt:

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

  Tipp

  Wenn das Projekt benutzerdefinierte Konnektoren verwendet, müssen diese vor dem Importieren des Projekts in der Organisation vorhanden sein. Informationen zum Exportieren eines Connector Builder-Konnektors und Importieren in eine andere Organisation finden Sie unter Connector Builder-Exporte und-Importe. Informationen zum Installieren eines Connector-SDK-Connectors in einer anderen Organisation finden Sie unter Implementieren eines Harmony-Connectors.

  Wenn Sie eine Datei auswählen, werden diese Felder verfügbar:

  • Projektname: Der Projektname wird aus der JSON-Datei vorab ausgefüllt. Wenn Sie einen anderen Namen verwenden möchten, können Sie ihn hier bearbeiten. Der Projektname muss diese Kriterien erfüllen:

    • Für jede Umfeld eindeutig sein.

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

    Notiz

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

  • Organisation: Verwenden Sie das Dropdown-Menü, um die Organisation auszuwählen, in die Sie das Projekt importieren möchten. Wenn Sie nur eine Organisation haben, ist diese standardmäßig ausgewählt.

  • Umgebung: Verwenden Sie das Dropdown-Menü, um die Umfeld auszuwählen, in das Sie das Projekt importieren möchten.

    Achtung

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

  • Email Benachrichtigungen einschließen: Standardmäßig, wenn Email Benachrichtigungen beim Export als Teil des Projekts enthalten waren, werden sie beim Import des Projekts enthalten sein. Diese Option gilt für alle Email Benachrichtigungen in einem Projekt, unabhängig davon, ob sie mit Operation konfiguriert sind bei Erfolg, Misserfolg oder SOAP Fehler ausgeführt werden oder wenn sie in einem Script referenziert werden. Um Email Benachrichtigungen vom Import auszuschließen, deaktivieren Sie das Kontrollkästchen.

    Vorsicht

    Verweise auf eine Email Benachrichtigungskomponente in einem Script werden nicht entfernt, selbst wenn Email Benachrichtigungen ausgeschlossen werden. Daher müssen Sie nach dem Ausschluss von Emails möglicherweise alle fehlerhaften Verweise korrigieren.

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

  • Globale Endpoints: Alle globalen Endpoints, die vom importierten Projekt verwendet werden, werden aufgelistet und müssen mit einer der folgenden Optionen zur ausgewählten Umfeld hinzugefügt werden:

    

    • Vorhandenen globalen Endpoint verwenden: Nur sichtbar, wenn der globale Endpoint bereits in der Organisation vorhanden ist. Wählen Sie diese Option aus, um einem vorhandenen globalen Endpoint für die ausgewählte Umfeld einen Umfeld hinzuzufügen. Verwenden Sie das Menü, um den vorhandenen globalen Endpoint auszuwählen:

      

      Wenn der vorhandene globale Endpoint bereits einen Umfeld für die ausgewählte Umfeld hat, wird der Endpoint für das importierte Projekt verwendet. Endpoint Umfeld dem Endpoint Endpoint werden.

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

      

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

• Importieren: Klicken Sie hier, 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 über den Bereich Projekte verfügbar Seite.

  Nachdem das Projekt importiert wurde, ist es noch nicht bereitgestellt. Wenn Sie zur einsetzen bereit sind, lesen Sie Projektbereitstellung.

Komponenten aus einem Projekt importieren (Beta)

Um nur bestimmte Komponenten aus einer JSON-Projektdatei in ein Projekt zu importieren, verwenden Sie das Aktionsmenü in einem Projekt und klicken Sie auf Importieren (Beta):

Ein Dateiauswahldialog wird geöffnet. Wählen Sie eine exportierte JSON-Projektdatei aus. Auf dem Konfigurationsbildschirm wählen Sie die Komponenten aus, die in das aktuell aufgerufene Projekt importiert werden sollen:

• Aus Projekt importieren: Dieses Panel zeigt den Namen des Projekts aus der JSON-Projektdatei und die Komponenten an, die aus der JSON-Projektdatei importiert werden können.

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

• Projektkomponenten: Jedes Projekt Komponentenkategorie in einem Projekt verfügbar ist, wird neben einer Zahl in Klammern angezeigt, die angibt, wie viele Komponenten sich in der Kategorie befinden. Komponenten in einer Komponentenkategorie werden alphabetisch aufgelistet. Verwenden Sie im Bedienfeld Aus Projekt importieren die Kontrollkästchen, um die Komponenten auszuwählen, die in das aktuell aufgerufene Projekt importiert werden sollen.

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

• Suchen: Geben Sie in das Suchfeld ein einzelnes Schlüsselwort oder eine Schlüsselwortzeichenfolge ein. Die Schlüsselwortzeichenfolge wird im Namen der Komponente blau hervorgehoben:

  

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

  

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

  

  Wenn Konflikte vorhanden sind, müssen sie gelöst werden, um den Import abzuschließen. Verwenden Sie die Navigieren Sie mit den Auf- und Ab-Pfeilen zu den einzelnen Konflikten.

  Endpoints mit Konflikten haben diese Aktionen:

  

  • Vorhandenen Endpoint verwenden: Wählen Sie diese Option aus, um einen Endpoint zu verwenden, der im aktuell aufgerufenen Projekt konfiguriert ist. Verwenden Sie das Menü, um den vorhandenen Endpoint auszuwählen.

    • Komponente ersetzen oder kopieren: Wenn der vorhandene Endpoint des Projekts und der importierte Endpoint beide denselben Aktivitätstyp mit übereinstimmenden Namen haben, stehen diese Optionen zur Verfügung:

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

      • Beide behalten: Wählen Sie diese Option aus, um beide Endpoint als unabhängige Komponenten beizubehalten. Der Name der importierten Komponente wird mit einer erhöhten Nummer in Klammern angehängt.

  • Neuen Endpoint erstellen: Wählen Sie diese Option aus, um einen neuen Endpoint im aktuell aufgerufenen Projekt zu erstellen. Wählen Sie im Menü Global aus (siehe Globale Verbindungen) oder Projektebene.

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

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

    

  • Beide behalten: Behält beide Komponenten. Dem Namen der zu importierenden Komponente wird eine in Klammern erhöhte Zahl angehängt. Diese Komponenten werden optisch mit einem blauen Neu-Symbol gekennzeichnet:

    

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

  • Alle ersetzen: Klicken Sie, um Ersetzen (wie oben beschrieben) für alle Komponentenkonflikte gleichzeitig auszuwählen.

  • Alle behalten: Klicken Sie, um Beide behalten (wie oben beschrieben) für alle Komponentenkonflikte gleichzeitig auszuwählen.

  • Änderungen bestätigen: Nur aktiviert, wenn eine Aktion für alle Konflikte ausgewählt ist. Klicken Sie, um ausgewählte Konfliktaktionen zu speichern. Nach dem Klicken wird die Schaltfläche Fertigstellen aktiviert.

  • Änderungen bearbeiten: (Sichtbar nach dem Klicken auf Änderungen bestätigen.) Klicken Sie, um die Konfliktlösungen zu bearbeiten.

• Alles zurücksetzen: Setzt das Projekt auf seinen ursprünglichen Zustand zurück und entfernt alle neuen oder ersetzten Komponenten aus dem Bedienfeld In Projekt importieren.

• Fertig: Klicken Sie hier, um die Komponenten zu importieren und zum Projekt zurückzukehren.

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