Übertragung (Migration) eines Projekts in eine Umgebung in Jitterbit Integration Studio

Einführung

Die Projektübertragung bewegt Projekte zwischen Umgebungen innerhalb einer einzigen Harmony-Organisation. Diese Funktion hilft Ihnen, Designänderungen durch Ihren Entwicklungslebenszyklus zu fördern. Verwenden Sie die Projektübertragung, um separate Entwicklungs-, Test- und Produktionsumgebungen aufrechtzuerhalten. Die Projektübertragung gewährleistet eine kontrollierte Bereitstellung von Änderungen.

Die Projektübertragung bietet eine kontrollierte Bereitstellung, indem sie Projekte oder Komponenten auf geplante Weise durch Entwicklungsphasen bewegt. Sie erhält die Umgebungsisolierung, indem sie Entwicklung, Test und Produktion getrennt hält. Die Projektübertragung erstellt eine Prüfspur, um die Übertragungshistorie für die Einhaltung von Vorschriften zu verfolgen.

Sie können die Projektübertragung verwenden, um Folgendes zu erreichen:

• Projekte oder Komponenten zwischen Umgebungen in derselben Organisation bewegen.
• Änderungen durch Entwicklungsphasen fördern.
• Umgebungs-spezifische Konfigurationen aufrechterhalten.
• Übertragungshistorie und Abhängigkeiten bewahren.

Sie können Projekte mit einer dieser beiden Optionen übertragen:

1. Vollständige Projektübertragung: Übertragen Sie das gesamte Projekt in eine Umgebung. (Diese Option erscheint als Migrieren in der aktuellen Benutzeroberfläche.)

2. Selektive Übertragung (Beta): Übertragen Sie nur bestimmte Komponenten in eine Umgebung.

Die folgende Tabelle vergleicht die wichtigsten Funktionen jeder Übertragungsoption:

Voraussetzungen

Bevor Sie ein Projekt oder eine Projektkomponente übertragen, erfüllen Sie diese Anforderungen:

• Stellen Sie sicher, dass Sie über den entsprechenden Zugriff in beiden Quell- und Zielumgebungen verfügen.

• Überprüfen Sie, ob die Zielumgebung den erforderlichen Agententyp (Cloud oder privat) hat, wenn Sie Funktionen verwenden, die auf einen bestimmten Agententyp beschränkt sind.

Übertragungsketten

Eine Übertragungskette ist eine verknüpfte Sequenz von Umgebungen, durch die ein Projekt während seines Lebenszyklus bewegt wird. Einmal eingerichtet, schaffen diese Ketten Abhängigkeiten, die Sie sorgfältig verwalten müssen.

Typischer Übertragungsfluss

Ein typischer Arbeitsablauf umfasst diese Schritte:

[Entwicklung] → [QA/Test] → [Produktion]
     ↓               ↓               ↓
  (Erstellen)      (Testen/Beheben)      (Live gehen)

1. Erstellen Sie ein Projekt in einer Entwicklungsumgebung.
2. Übertragen Sie es in eine QA (Qualitätssicherung) Umgebung zum Testen.
3. Beheben Sie alle Probleme in der Entwicklungsumgebung.
4. Übertragen Sie es erneut in die QA-Umgebung zum Retesten.
5. Übertragen Sie von QA in die Produktion, wenn Sie bereit sind.
6. Wiederholen Sie die Schritte 3-5 für laufende Änderungen.

Projektübertragungen basieren auf internen IDs, nicht auf Namen, sodass umbenannte Projekte ihre Übertragungsbeziehungen beibehalten.

Kettenabhängigkeiten

Der Projekttransfer erstellt diese dauerhaften Abhängigkeiten zwischen Projekten:

• Projekte können nicht gelöscht werden, wenn abhängige Projekte weiter unten in der Kette existieren.

• Ketten können nicht unterbrochen werden, ohne die Projekte weiter unten in der Kette zu löschen.

• Das Umbenennen von Projekten hat keinen Einfluss auf die Kettenbeziehungen.

Ein übertragenes Projekt hat eine Abhängigkeit von dem Projekt, von dem es übertragen wurde. Sie können ein Projekt am Anfang einer Transferkette nicht löschen, bis Sie alle Projekte weiter unten in der Kette gelöscht haben. Weitere Informationen finden Sie unter Projekt löschen in Projekt erstellen und konfigurieren.

Sie können eine Transferkette nur unterbrechen, indem Sie Projekte weiter unten in der Kette löschen oder das Projekt exportieren und importieren. Weitere Informationen finden Sie unter Projekt-Exporte und -Importe. Das Umbenennen eines übertragenen Projekts unterbricht die Kette nicht.

Beste Praktiken

Wir empfehlen diese besten Praktiken beim Entwerfen einer Transferkette:

• Nehmen Sie Designänderungen nur in der ersten Umgebung in der Kette vor. Im Beispiel des typischen Transferflusses ist dies die Entwicklungsumgebung. In späteren Umgebungen empfehlen wir, dass Sie nur die Werte der Projektvariablen ändern. Nehmen Sie diese Änderungen innerhalb der Integration Studio-Anwendung vor, damit sie in der Projektgeschichte erscheinen. Änderungen der Werte von Projektvariablen, die von der Management Console-Seite Projekte vorgenommen werden, erscheinen nicht in der Projektgeschichte. Während des Projekttransfers können Sie auswählen, ob Sie alle Projektvariablenwerte oder nur ausgewählte Projektvariablenwerte übertragen möchten (beschrieben im nächsten Abschnitt).

• Machen Sie die erste Umgebung in der Kette für diejenigen zugänglich, die im Laufe der Zeit Änderungen am Projekt vornehmen müssen. Wir empfehlen, dass nicht ein einzelner Entwickler das Projekt in einer persönlichen Organisation entwirft. Wenn dies geschieht, exportieren Sie zuerst das ursprüngliche Projekt und importieren Sie es dann in die Umgebung, die die Kette starten wird. Nehmen Sie zukünftige Änderungen am Projekt in der Umgebung vor, die die Kette startet.

Projektübertragung

Sie können Projekte mit einer der beiden folgenden Optionen übertragen:

1. Vollständige Projektübertragung: Übertragen Sie das gesamte Projekt in eine Umgebung. (Diese Option erscheint als Migrieren in der aktuellen Benutzeroberfläche.)
2. Selektive Übertragung (Beta): Übertragen Sie nur bestimmte Komponenten in eine Umgebung.

Vollständige Projektübertragung

Wenn Sie ein vollständiges Projekt mit der Option Migrieren übertragen, werden alle Projektkomponenten und Projektdaten übertragen.

Die Option Migrieren ist von diesen Orten aus zugänglich:

• Der Projekt-Toolbar. Weitere Informationen finden Sie im Projektaktionsmenü in der Projekt-Toolbar.
• Der Entwurfscanvas. Weitere Informationen finden Sie im Bereitstellungs-/Migrierungsaktionsmenü im Entwurfscanvas.

Wenn Sie Migrieren auswählen, öffnet sich ein Konfigurationsbildschirm. Sie können die Zielumgebung auswählen und ob die Werte einzelner Projektvariablen übertragen werden sollen:

• Organisation und Projekt: Die Harmony-Organisation, in der sich das Projekt befindet, und der Name des zu übertragenden Projekts, getrennt durch ein Komma.

• Aktuelle Umgebung und Zielumgebung: Die aktuelle Umgebung, in der sich das Projekt befindet, und die Zielumgebung, in die das Projekt übertragen wird, werden zusammen mit ihrem zugehörigen Agentgruppen-Typ (Cloud-Agent oder Privater Agent) aufgelistet.

  Wenn das Projekt übertragen wird, bleibt das bestehende Projekt in der aktuellen Umgebung unverändert. Wenn das Projekt bereits in die Zielumgebung übertragen wurde, wird das Projekt in der Zielumgebung mit den unten ausgewählten Werten für die Projektvariablen überschrieben.

  Vorsicht

  Wenn das Quellprojekt Connectoren verwendet, die nur auf privaten Agenten verfügbar sind, können Sie es nicht in eine Umgebung übertragen, die mit einer Cloud-Agent-Gruppe verbunden ist. Diese Umgebungen erscheinen weiterhin im Dropdown-Menü Zielumgebung, können jedoch nicht ausgewählt werden.

• Tag-Name der Projektgeschichte: Geben Sie ein Tag ein, um das Übertragungsevent zu kennzeichnen. Das Tag erscheint als Bezeichnung für das Übertragungsevent und wird in den Bereitstellungsdetails aufgezeichnet, die über die Projektgeschichte zugänglich sind. Es wird empfohlen, ein einzigartiges Tag einzugeben, dies ist jedoch nicht erforderlich.

• Globale Endpunkte: Alle globalen Endpunkte, die von dem zu übertragenden Projekt verwendet werden und in der Zielumgebung nicht existieren, werden aufgelistet. Wenn das Projekt übertragen wird, wird der globale Endpunkt zu dieser Umgebung hinzugefügt und muss nach der Übertragung konfiguriert werden.

• Alle Variablenwerte migrieren: Wählen Sie diese Option, um alle Werte der Projektvariablen zu übertragen. Wenn das Projekt bereits in der Zielumgebung existiert, werden die Werte aller Projektvariablen überschrieben. Beim ersten Übertragen eines Projekts ist diese Option standardmäßig ausgewählt. Spätere Übertragungen standardmäßig auf Variablenwerte zur Migration auswählen.

• Wählen Sie die zu migrierenden Variablenwerte aus: Wählen Sie diese Option, um alle Projektkomponenten und Projektdaten zu übertragen, mit Ausnahme der unter Ausschließen aufgeführten Werte der Projektvariablen. Wenn das Projekt bereits in der Zielumgebung existiert, werden alle Projektkomponenten, einschließlich der unter Einschließen aufgeführten Werte der Projektvariablen, überschrieben.

  Wenn Wählen Sie die zu migrierenden Variablenwerte aus ausgewählt ist, werden standardmäßig keine Projektvariablen für die Übertragung ausgewählt, es sei denn, das Projekt existiert bereits in der Zielumgebung. Wenn das Projekt bereits übertragen wurde, werden neu hinzugefügte oder umbenannte Projektvariablen standardmäßig für die Übertragung ausgewählt, jedoch werden Variablen, deren Werte geändert wurden, ausgeschlossen.

  • Suchen: Geben Sie einen Teil eines Projektvariablennamens ein, um die Liste der Projektvariablen in der aktuellen Umgebung zu filtern.
  • Aktuelle Umgebung: Wählen Sie Projektvariablen aus, deren Werte Sie in die Zielumgebung übertragen möchten. Wenn Sie Projektvariablen auswählen, erscheinen diese unter Einschließen. Die Links Alle auswählen und Alle abwählen fügen alle Projektvariablenauswahlen auf einmal hinzu oder löschen sie.
  • Ausschließen: Projektvariablen, deren Werte von der Übertragung ausgeschlossen sind. Wenn das Projekt bereits in der Zielumgebung existiert und die Projektvariable bereits enthält, bleibt ihr vorhandener Wert in der Zielumgebung erhalten. Wenn die Projektvariable noch nicht existiert, wird die Projektvariablenkomponente übertragen, jedoch wird ihr kein Wert zugewiesen.
  • Einschließen: Projektvariablen, deren Werte in die Übertragung einbezogen werden. Wenn das Projekt bereits in der Zielumgebung existiert und die Projektvariable bereits enthält, wird ihr vorhandener Wert in der Zielumgebung überschrieben.

• Migrieren: Klicken Sie, um das Projekt in die ausgewählte Umgebung zu übertragen. Wenn das Projekt bereits in die Zielumgebung übertragen wurde, wird eine Nachricht angezeigt, die Sie auffordert zu bestätigen, dass Sie die Übertragung durchführen möchten. Diese Übertragung überschreibt das vorhandene Projekt in der Zielumgebung unter Verwendung der oben genannten Auswahlen für die Werte der Projektvariablen.

  Dialogtext

  Bestätigen Sie die Migration
  Ein Projekt mit demselben Namen existiert bereits in der Zielumgebung. Sind Sie sicher, dass Sie es überschreiben möchten?

  Wenn Sie auf Weiter klicken, öffnet sich das übertragene Projekt im Projekt-Designer, sofern die Übertragung in die Zielumgebung erfolgreich ist.

Komponenten aus einem Projekt übertragen (Beta)

Die selektive Übertragung ermöglicht es Ihnen, nur bestimmte Komponenten aus einem Projekt zu übertragen. Diese Funktion hilft Ihnen, die Arbeit anderer Mitwirkender im selben Projekt und in derselben Umgebung nicht zu stören. Verwenden Sie die selektive Übertragung, wenn Sie Ihre Änderungen fördern möchten, ohne die Arbeit anderer Benutzer in der Zielumgebung zu überschreiben.

Um nur bestimmte Komponenten aus einem Projekt zu übertragen, verwenden Sie das Projektaktionsmenü oder das Aktionsmenü für Operationen in einem Projekt und klicken Sie auf Selektive Übertragung:

Auf dem Konfigurationsbildschirm wählen Sie die Zielumgebung und die zu übertragenden Komponenten aus:

Komponentenauswahl

Sie können einzelne Komponenten basierend auf Ihren Bedürfnissen auswählen. Wenn Sie Komponenten zur Übertragung auswählen, werden die erforderlichen Abhängigkeiten automatisch vom System eingeschlossen, mit Ausnahme von Zeitplänen. Sie müssen Zeitpläne manuell auswählen, wenn Sie diese übertragen möchten.

Das System gruppiert Komponenten basierend auf ihrem Status in den Quell- und Zielumgebungen:

• Erstellen: Komponenten, die im Quellprojekt existieren, aber nicht im Zielprojekt. Wenn diese ausgewählt werden, werden diese Komponenten im Zielprojekt erstellt.

• Überschreiben: Komponenten, die in beiden Projekten existieren, aber unterschiedliche Inhalte basierend auf dem Datum der letzten Änderung und dem Benutzervergleich haben. Wenn diese ausgewählt werden, werden diese Komponenten im Zielprojekt überschrieben.

• Löschen: Komponenten, die im Zielprojekt existieren, aber nicht im Quellprojekt. Wenn diese ausgewählt werden, werden diese Komponenten aus dem Zielprojekt entfernt.

• Unverändert: Komponenten, die in beiden Projekten existieren und denselben Inhalt basierend auf dem Datum der letzten Änderung und dem Benutzervergleich haben. Diese Komponenten können nicht ausgewählt werden.

Sie können Komponenten in den Kategorien Erstellen, Überschreiben und Löschen auswählen oder abwählen, um Ihren Transfer zu konfigurieren.

Konfigurationsoptionen

• Zielumgebung: Wählen Sie die Umgebung aus, in die Sie die ausgewählten Komponenten übertragen möchten.

  Warnung

  Wenn ein nicht verwandtes Projekt mit demselben Namen bereits in der Zielumgebung existiert (nicht Teil der Transferkette), kann der Transfer nicht fortgesetzt werden. Sie sehen einen leeren Bildschirm. In diesem Fall müssen Sie eines der Projekte umbenennen, bevor Sie den Transfer versuchen.

• Projektverlauf-Tagname: Geben Sie ein Tag ein, um das Transferereignis zur Verfolgung im Projektverlauf zu kennzeichnen. Bei nachfolgenden Transfers werden die Komponenten mit dem Projektverlauf-Tagname angezeigt. Dies hilft Ihnen zu erkennen, aus welcher Version jede Komponente stammt, wenn Sie entscheiden, ob Sie bei zukünftigen Transfers überschreiben möchten.

• Globale Endpunkte: Globale Endpunkte, die sich nicht in der Zielumgebung befinden, werden während des Transfers automatisch hinzugefügt. Die gleichen Konfigurationen wie in der aktuellen Umgebung werden verwendet.

• Projektvariablen und Werte einbeziehen: Wenn Sie eine Projektvariable auswählen, die in den Transfer einbezogen werden soll, können Sie entscheiden, welche Werte der Projektvariablen in den Transfer einbezogen oder ausgeschlossen werden sollen, indem Sie das Kontrollkästchen Wert einbeziehen verwenden. Ihre Auswahl wird für spätere Transfers in dieselbe Zielumgebung gespeichert.

• Anzeigen: Versteckte Daten für Zuletzt geändert anzeigen. Klicken, um diese Informationen anzuzeigen.

• Ausblenden: Sichtbare Daten für Zuletzt geändert ausblenden. Klicken, um diese Informationen auszublenden.

• Übertragen: Starten Sie den Übertragungsprozess mit Ihren ausgewählten Komponenten und Konfigurationen. Wenn die Übertragung abgeschlossen ist, erscheint ein Bestätigungsdialog mit der Option, das Projekt in der Zielumgebung zu öffnen.

• Abbrechen: Brechen Sie die Übertragung ab und kehren Sie zum Projekt zurück.