Projekthistorie in Jitterbit Studio

Einführung

Diese Seite beschreibt, wie man die Projekthistorie anzeigt, 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.

Projekthistorie und Snapshots aufrufen

Sie können die Projekthistorie-Schublade von den folgenden Orten aus aufrufen:

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

Die Schublade enthält zwei Tabs:

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

Projekthistorie anzeigen

Projekthistorieereignisse werden nach Tag in umgekehrter chronologischer Reihenfolge gruppiert. Jedes Ereignis wird einzeln mit seinem Zeitstempel aufgelistet und zeigt den Vornamen und die Initialen des Nachnamens des Benutzers an.

Komponentenänderungsereignisse zeigen ein Symbol an, das den Komponententyp identifiziert. Fahren Sie mit der Maus über das Symbol, um einen Tooltip mit dem Typ anzuzeigen (z. B. „Skript", „Globale Variable" oder „Transformation").

Verlauf filtern

Die folgenden Steuerelemente stehen zur Verfügung, um die Historiendarstellung zu filtern:

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

  

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

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

  • Alle Ereignisse: Zeigt alle Projekthistorieereignisse 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.
  • Mit Tags versehen: Zeigt Ereignisse an, die mit Tags versehen wurden.

Ereignisdetails anzeigen

Um Ereignisdetails anzuzeigen oder zu reduzieren, klicken Sie auf das Caret neben einer Tagesüberschrift, um alle Ereignisse für diesen Tag zu erweitern oder zu reduzieren.

Die folgenden zusätzlichen Steuerelemente sind verfügbar:

• Alle erweitern / Alle reduzieren: Erweitert oder reduziert alle Ereignisdetails auf einmal.
• Letzte bereitgestellte Version wiederherstellen: Stellt das Projekt in der letzten Bereitstellung wieder her.
• Als CSV herunterladen: Lädt aktuelle gefilterte Verlaufsdaten herunter.

Ereignistypen

In der folgenden Tabelle werden die einzelnen Ereignistypen beschrieben:

Detaillierte Änderungsinformationen

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

Die detaillierten Änderungen können folgende Punkte enthalten:

• Script-Typ-Änderungen (z. B. „Script-Typ wurde von JavaScript zu Jitterbit Script geändert").
• Script-Inhaltsänderungen (angezeigt als „Script-Body wurde geändert").
• Transformations-Mapping-Änderungen.
• Tool-Konfigurationsänderungen, z. B. Bedingungsfelder, Operatoren und Werte eines Decision-Tools.
• E-Mail-Benachrichtigungsfeldänderungen, z. B. Änderungen bei Empfänger, Betreff oder Nachricht.
• Vorgangskonfigurationsänderungen, z. B. Änderungen bei Plan, Aktion oder Optionen.
• Projektvariablenfeldänderungen, z. B. Änderungen bei Standardwert oder Beschreibung.
• Connector-Endpunkt- und Activity-Konfigurationsfeldänderungen, einschließlich Authentifizierungsfeldänderungen (z. B. „Authentifizierungstyp geändert").
• Weitere direkte Konfigurationsaktualisierungen.

Änderungen vergleichen

Für Änderungsereignisse, die Inhalts- oder Konfigurationsaktualisierungen 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 (z. B. „7:06 Uhr Script: Fine Tune Data"). Die folgenden Steuerelemente sind in der Titelleiste verfügbar:

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

• Maximieren / Wiederherstellen: Erweitert die Diff-Ansicht, um den verfügbaren Bildschirmbereich zu fü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. Ein vertikaler Scrollbalken 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 Panels nebeneinander an:

  • Linkes Panel: Zeigt die vorherige Version des Inhalts. Gelöschte Zeilen sind rot hervorgehoben.

  • Rechtes Panel: Zeigt die aktualisierte Version des Inhalts. Hinzugefügte Zeilen sind grün hervorgehoben.

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

• Feldvergleich-Diff-Ansicht: Wird für Tools, E-Mail-Benachrichtigungen, Vorgänge (einschließlich ihrer Pläne, Aktionen und Optionen), Projektvariablen, Connector-Endpunkte und Connector-Activities 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 gefärbt, 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 Connector-Activity. Ein Feld, dessen Wert auf eine Projektvariable oder globale Variable verweist, wird als verknüpfte Referenz angezeigt, die den Variablennamen statt seines literalen Werts anzeigt. Ein Anmeldeinformationsfeld wie ein Kennwort oder Sicherheitstoken ist in den Spalten Vorher und Nachher maskiert.

Ein Feld, dessen Name oder Wert zu lang für die Tabellenanzeige ist, oder dessen Wert ein Objekt oder Array (als JSON-String angezeigt) ist, enthält ein Erweiterungssymbol. Klicken Sie auf das Symbol, um einen Inline-Diff des Feldinhalts zu öffnen, der als Code-Diff mit gelöschten Zeilen in Rot und hinzugefügten Zeilen in Grün angezeigt wird.

Für eine Connector-Aktivität, die Daten abfragt oder abruft, kann ein Response-Feld das Antwortschema als erweiterbarer Baum anzeigen. Im Schema hinzugefügte Felder werden grün hervorgehoben.

Snapshots verwalten

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

Manuellen Snapshot erstellen

Führen Sie diese Schritte aus, um einen Snapshot zu erstellen:

1. Öffnen Sie die Registerkarte Snapshots in der Projekt-Verlauf-Schublade.

2. Klicken Sie auf das Symbol Snapshot erstellen.

3. Das Dialogfeld Neuer Snapshot enthält die folgenden Felder:

   

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

4. Klicken Sie auf Speichern.

Snapshots werden auf unbestimmte Zeit gespeichert.

Snapshots filtern

Die folgenden Steuerelemente sind auf der Registerkarte Snapshots verfügbar:

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

• Typmenü: Filtern nach Automatisch oder Manuell Snapshots:

  • Automatisch: Automatische Snapshots werden während dieser Ereignisse erfasst:

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

  • Manuell: Manuell erstellte Snapshots.

Events und Snapshots mit Tags versehen

Transfer-, Deploy- und Wiederherstellungs-Events können Tags und Kommentare zur Versionierung und Organisation enthalten.

Tag-Anforderungen

Transfer-Events müssen vom Projekt-Transfer-Bildschirm aus getaggt werden, bevor das Projekt übertragen werden kann.

Deploy-Events können so konfiguriert werden, dass Tags oder Kommentare erforderlich sind. Um Tags oder Kommentare zum Deploy-Zeitpunkt erforderlich zu machen, aktivieren Sie Tags beim Deployment erforderlich in der Projekteinstellung auf der Registerkarte „Bereitstellung". Bei Aktivierung wird ein Dialogfeld angezeigt, das das erforderliche Tag oder den erforderlichen Kommentar anfordert, wenn Sie das Projekt bereitstellen.

Tags hinzufügen oder bearbeiten

Führen Sie diese Schritte aus, um ein Tag hinzuzufügen oder zu bearbeiten:

1. Halten Sie den Mauszeiger über das Event oder den Snapshot.

2. Klicken Sie auf Details.

3. Das Dialogfeld enthält die folgenden Felder:

   

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

   • Kommentar (Events) 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, können nur angezeigt werden.

Projekt wiederherstellen

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

Auf eine bestimmte Version wiederherstellen

Um ein Projekt wiederherzustellen, führen Sie diese Schritte aus:

1. Suchen Sie in der Projektversionshistorie das Ereignis oder den Snapshot, das bzw. den 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 kehrt zur ausgewählten Version zurück. Diese Aktion hat keine Auswirkungen auf die bereitgestellte Version. Stellen Sie das Projekt erneut bereit, um den wiederhergestellten Zustand bereitzustellen.

Alternativ können Sie Ihr Projekt auf die zuletzt bereitgestellte Version wiederherstellen, indem Sie das Symbol Letzte bereitgestellte Version wiederherstellen verwenden (siehe oben beschrieben).

Beschädigte Projekte wiederherstellen

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

Zusammenarbeit während der Wiederherstellung

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

• Ein Informationsdialog wird für alle aktiven Benutzer angezeigt.
• Das Schließen des Dialogs aktualisiert die Ansicht, um den wiederhergestellten Projektzustand widerzuspiegeln.

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