Projekthistorie in Jitterbit Studio

Einführung

Diese Seite beschreibt, wie man die Projekthistorie ansieht, Snapshots verwaltet und Projekte wiederherstellt. Die Projekthistorie wird maximal 180 Tage lang gespeichert. Snapshots bleiben unbegrenzt verfügbar. Beim Exportieren eines Projekts werden sowohl die Projekthistorie als auch die Snapshots aus der exportierten Version gelöscht.

Zugriff auf Projekthistorie und Snapshots

Die Schublade Projekthistorie kann von folgenden Stellen aus aufgerufen werden:

• Die Design-Canvas (siehe Design-Canvas-Aktionsmenü).
• Die Seite Projekte (siehe Kartenansicht oder Listenansicht).

Die Schublade enthält zwei Registerkarten:

• Projekthistorie: Zeigt eine Liste von Projektänderungen und Bereitstellungen. Jeder Eintrag enthält das Datum, die Uhrzeit und den Benutzer, der jede Aktion ausgeführt hat.
• Snapshots: Zeigt eine Liste von Snapshots, die automatisch oder manuell erstellt wurden.

Projekthistorie ansehen

Projekthistorie-Ereignisse werden nach Datum in umgekehrter chronologischer Reihenfolge gruppiert. Jedes Ereignis wird einzeln mit seinem Zeitstempel angezeigt und zeigt den Vornamen und die Anfangsbuchstaben des Nachnamens des Benutzers.

Komponentenänderungsereignisse zeigen ein Symbol an, das den Komponententyp identifiziert. Bewegen Sie den Cursor über das Symbol, um eine Tooltip anzuzeigen, die den Typ anzeigt (beispielsweise „Script", „Globale Variable" oder „Transformation").

Chronik filtern

Die folgenden Steuerelemente sind verfügbar, um die Historiendarstellung zu filtern:

• Suchfeld: Geben Sie ein einzelnes Schlüsselwort oder eine Schlüsselwortzeichenkette ein. Nur Ereignisse, die die Schlüsselwortzeichenkette enthalten, werden angezeigt, und die Schlüsselwortzeichenkette wird blau hervorgehoben.

  

• Zeitraummenü: Wählen Sie Letzte 30 Tage, Letzte 60 Tage, Letzte 90 Tage oder Letzte 180 Tage.

• Ereignistypmenü: Wählen Sie, welche Ereignistypen angezeigt werden sollen. Die folgenden Optionen sind verfügbar:

  • Alle Ereignisse: Zeigt alle Projekthistorie-Ereignisse mit beliebigen Tags an.
  • Bereitstellungen: Zeigt nur Bereitstellungsereignisse an.
  • Migrationen: Zeigt nur vollständige Projektübertragungen an.
  • Importe: Zeigt nur Importereignisse an.
  • Übertragungen: Zeigt nur selektive Übertragungsereignisse an.
  • Gekennzeichnet: Zeigt Ereignisse an, die gekennzeichnet wurden.

Ereignisdetails ansehen

Um Ereignisdetails anzuzeigen oder auszublenden, klicken Sie auf das Häkchen neben einem Tagesheader, um alle Ereignisse für diesen Tag zu erweitern oder auszublenden.

Die folgenden zusätzlichen Steuerelemente sind verfügbar:

• Alle erweitern / Alle ausblenden: Erweitert oder blendet alle Ereignisdetails auf einmal aus.
• Zuletzt bereitgestellte Version wiederherstellen: Stellt das Projekt auf die letzte Bereitstellung wieder her.
• Als CSV herunterladen: Lädt aktuelle gefilterte Historiendaten herunter.

Ereignistypen

Die folgende Tabelle beschreibt jeden Ereignistyp:

Detaillierte Änderungsinformationen

Für Script-, Transformations-, Tool-, E-Mail-Benachrichtigungs-, Vorgangs-, Projektvariablen- und Connector-Endpunkt- sowie Activity-Konfigurationskomponenten werden detaillierte Änderungsinformationen standardmäßig als verschachtelte Aufzählungspunkte unter dem Änderungsereigniseintrag angezeigt:

Die detaillierten Änderungen können folgende umfassen:

• Script-Typänderungen (beispielsweise „Script-Typ wurde von JavaScript zu Jitterbit Script geändert").
• Script-Inhaltsänderungen (angezeigt als „Script-Text wurde geändert").
• Transformationszuordnungsänderungen.
• Tool-Konfigurationsänderungen, wie z. B. Bedingungsfelder, Operatoren und Werte eines Decision-Tools.
• E-Mail-Benachrichtigungsfeldänderungen, wie z. B. Empfänger-, Betreff- oder Nachrichtenänderungen.
• Vorgangskonfigurationsänderungen, wie z. B. Zeitplan-, Aktions- oder Optionsänderungen.
• Projektvariablenfeldänderungen, wie z. B. Standardwert- oder Beschreibungsänderungen.
• Connector-Endpunkt- und Activity-Konfigurationsfeldänderungen, einschließlich Authentifizierungsfeldänderungen (beispielsweise „Authentifizierungstyp geändert").
• Sonstige direkte Konfigurationsupdates.

Änderungen vergleichen

Bei Änderungsereignissen, die Inhalts- oder Konfigurationsupdates enthalten, wird neben dem Änderungsdetaileintrag ein Änderungen anzeigen-Symbol angezeigt. Klicken Sie auf Änderungen anzeigen, um eine Diff-Ansicht zu öffnen, die den Inhalt oder die Konfiguration der Komponente vor und nach der Änderung anzeigt.

Die Titelleiste der Diff-Ansicht zeigt den Ereigniszeitstempel, den Komponententyp und den Komponentennamen an (beispielsweise „7:06 Uhr Script: Fine Tune Data"). In der Titelleiste sind folgende Steuerelemente verfügbar:

• Pop-out: Öffnet die Diff-Ansicht in einem neuen Popup-Fenster.

• Maximieren / Wiederherstellen: Erweitert die Diff-Ansicht, um den verfügbaren Bildschirmplatz auszufüllen, oder setzt sie auf ihre Standardgröße zurück.

• Schließen: Schließt die Diff-Ansicht.

Sie können die Diff-Ansicht über ihre Titelleiste ziehen, um sie überall auf dem Bildschirm zu positionieren, und die 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 je nach Komponententyp eines der folgenden Formate:

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

  • Linker Bereich: Zeigt die vorherige Version des Inhalts an. Gelöschte Zeilen sind rot hervorgehoben.

  • Rechter Bereich: Zeigt die aktualisierte Version des Inhalts an. Hinzugefügte Zeilen sind grün hervorgehoben.

  Bei Transformationen wird jede geänderte Zuordnungsregel als ausklappbarer Abschnitt mit dem Feldpfad angezeigt (beispielsweise „Zuordnungsregel json/isActive"). Klicken Sie auf den Caret, um einzelne Abschnitte zu erweitern oder auszublenden.

• Feldvergleichs-Diff-Ansicht: Wird für Tools, E-Mail-Benachrichtigungen, Vorgänge (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, in der jedes geänderte Feld aufgelistet ist:

  

  Eine geänderte Zeile ist in der Spalte Vorher rot und in der Spalte Nachher grün gefärbt, und die spezifischen Zeichen oder Wörter, die sich in einem Wert geändert haben, sind stärker hervorgehoben. Zugehörige Felder sind unter Abschnittsüberschriften gruppiert, wie z. B. die einzelnen Bedingungen eines Decision-Tools, die verschachtelten Optionsgruppen eines Connector-Endpunkts oder die Schritte einer Connector-Aktivität. Ein Feld, dessen Wert auf eine Projektvariable oder globale Variable verweist, wird als verlinkte Referenz angezeigt, die den Variablennamen anstelle des Literalwerts anzeigt. Ein Anmeldeinformationsfeld, wie z. B. ein Passwort oder Sicherheitstoken, wird in den Spalten Vorher und Nachher maskiert.

Ein Feld, dessen Name oder Wert zu lang ist, um in der Tabelle angezeigt zu werden, oder dessen Wert ein Objekt oder Array ist (als JSON-String angezeigt), enthält ein Expand-Symbol. Klicken Sie auf das Symbol, um einen Inline-Diff des Feldinhalts zu öffnen. Der Diff wird als Code-Diff angezeigt, wobei gelöschte Zeilen rot und hinzugefügte Zeilen grün hervorgehoben sind.

Für eine Connector-Aktivität, die Daten abfragt oder abruft, kann ein Response-Feld das Response-Schema als erweiterbare Struktur anzeigen. Zum Schema hinzugefügte Felder sind grün hervorgehoben.

Snapshots verwalten

Snapshots erfassen den Projektzustand zu bestimmten Zeitpunkten. Automatische Snapshots werden bei Bereitstellungen, Übertragungen und Importen erstellt. Sie können auch manuelle Snapshots erstellen.

Manuellen Snapshot erstellen

Um einen Snapshot zu erstellen, führen Sie die folgenden Schritte aus:

1. Öffnen Sie die Registerkarte Snapshots in der Schublade für die Projekthistorie.

2. Klicken Sie auf das Symbol Snapshot erstellen.

3. Der Dialog Neuer Snapshot enthält die folgenden Felder:

   

   • Tag: Geben Sie ein eindeutiges Tag ein, um den Snapshot zu kennzeichnen (erforderlich).
   • Beschreibung: Geben Sie eine optionale Beschreibung ein.

4. Klicken Sie auf Speichern.

Snapshots werden unbegrenzt gespeichert.

Snapshots filtern

Die folgenden Kontrollen sind in der Registerkarte Snapshots verfügbar:

• Nach Tag suchen: Geben Sie Tag-Namen ein, um bestimmte Snapshots zu finden.

• Typmenü: Filtern Sie nach Automatischen oder Manuellen Snapshots:

  • Automatisch: Automatische Snapshots werden bei diesen Ereignissen erfasst:

    • Bereitstellung: Der Projekt-Designer zum Zeitpunkt der Bereitstellung.
    • Übertragung oder Migration: Der Ziel-Projekt-Designer vor der Übertragung oder Migration.
    • Import: Der Projekt-Designer vor dem Import.

  • Manuell: Snapshots, die manuell erstellt wurden.

Ereignisse und Snapshots mit Tags versehen

Übertragungs-, Bereitstellungs- und Wiederherstellungsereignisse können Tags und Kommentare zur Versionierung und Organisation enthalten.

Tag-Anforderungen

Übertragungsereignisse müssen vom Projekt-Übertragungsbildschirm aus mit Tags versehen werden, bevor das Projekt übertragen werden kann.

Bereitstellungsereignisse können so konfiguriert werden, dass Tags oder Kommentare erforderlich sind. Um Tags oder Kommentare zur Bereitstellungszeit erforderlich zu machen, aktivieren Sie Tags bei der Bereitstellung erforderlich in der Registerkarte Bereitstellung der Projekteinstellungen. Wenn diese Option aktiviert ist, wird ein Dialog angezeigt, der das erforderliche Tag oder den Kommentar anfordert, wenn Sie das Projekt bereitstellen.

Tags hinzufügen oder bearbeiten

Um ein Tag hinzuzufügen oder zu bearbeiten, führen Sie die folgenden Schritte aus:

1. Fahren Sie über das Ereignis oder den Snapshot.

2. Klicken Sie auf Details.

3. Der Dialog enthält die folgenden Felder:

   

   • Tag: Geben Sie ein Label ein (eindeutiges Tag empfohlen, aber nicht erforderlich).

   • Kommentar (Ereignisse) oder Beschreibung (Snapshots): Geben Sie zusätzliche Informationen ein.

4. Klicken Sie auf Speichern.

Sie können Tags und Kommentare bearbeiten, die Sie hinzugefügt haben. Tags und Kommentare, die von anderen Benutzern hinzugefügt wurden, sind schreibgeschützt.

Ein Projekt wiederherstellen

Projektsicherungen werden automatisch erstellt, wenn Sie ein Projekt übertragen, bereitstellen oder wiederherstellen.

In einer bestimmten Version wiederherstellen

Gehen Sie wie folgt vor, um ein Projekt wiederherzustellen:

1. Suchen Sie im Projekthistorie-Drawer nach dem Ereignis oder Snapshot, das Sie wiederherstellen möchten.

2. Fahren Sie mit der Maus über das Ereignis oder den Snapshot.

3. Klicken Sie auf Diese Version wiederherstellen.

4. Klicken Sie im Bestätigungsdialog auf Wiederherstellen.

Der Projekt-Designer wird auf die ausgewählte Version zurückgesetzt. Diese Aktion wirkt sich nicht auf die bereitgestellte Version aus. Stellen Sie das Projekt erneut bereit, um den wiederhergestellten Zustand bereitzustellen.

Alternativ können Sie das Projekt mithilfe des Symbols Letzte bereitgestellte Version wiederherstellen auf die zuletzt bereitgestellte Version zurücksetzen (siehe oben beschrieben).

Beschädigte Projekte wiederherstellen

Wenn ein Projekt beschädigt ist und nicht geöffnet werden kann, können Sie über das Aktionsmenü des Projekts auf der Seite Projekte auf die Projekthistorie zugreifen und das Projekt in einen früheren Zustand vor der Beschädigung wiederherstellen.

Während der Wiederherstellung zusammenarbeiten

Wenn mehrere Benutzer gleichzeitig an demselben Projekt arbeiten und jemand das Projekt wiederherstellt, geschieht Folgendes:

• Ein Informationsdialog wird für alle aktiven Benutzer angezeigt.
• Wenn Sie den Dialog schließen, wird die Ansicht aktualisiert, um den wiederhergestellten Projektzustand widerzuspiegeln.

Dieses Verhalten verhindert unerwartete Änderungen an aktiven Arbeitssitzungen ohne Vorwarnung.