Versionierung

Die Versionierung ist nur in der Master-Umgebung verfügbar.

Versionierung bezieht sich auf die Praxis, mehrere Snapshots eines Dokuments zu erstellen. Die Eintragsversionierung ermöglicht es Contentful Nutzer*innen, zuvor veröffentlichte Versionen des Eintrags anzuzeigen, herauszufinden, wer einen Eintrag wann veröffentlicht hat, frühere Snapshots mit der aktuellen Version zu vergleichen und – falls erforderlich – den Content in den früheren Zustand zurückzusetzen.

Derzeit erstellt Contentful bei jeder Veröffentlichung oder erneuten Veröffentlichung eine Momentaufnahme eines Eintrags. Dies ermöglicht es, einfach zu früheren Versionen zurückzukehren, wenn ein Eintrag versehentlich geändert wird. Sie können wählen, ob Sie den Content einzelner Felder oder des gesamten Eintrags zurücksetzen möchten. Die Eintragsversionierung ist in der Web-App und über die dedizierten API-Endpunkte verfügbar:

Der Endpunkt /spaces/X/entries/Y/snapshots listet alle verfügbaren Snapshots für einen bestimmten Eintrag auf.

Der Endpunkt /spaces/X/entries/Y/snapshots/Z  stellt Content eines ausgewählten Snapshots bereit.

Die Funktion zur Versionsverwaltung von Einträgen unterliegt bestimmten Einschränkungen, die sich auf die Art des Contents auswirken können, den Sie in Ihrer App sehen. Eintrags-Snapshots reichen nur bis zum 12. Oktober 2016 zurück, sodass es nicht möglich ist, den aktuellen Eintrag mit den vor diesem Datum veröffentlichten Versionen zu vergleichen. Lokalisierter Content wird nur im Versionsvergleich angezeigt, wenn die entsprechenden Sprachen in der Seitenleiste des Eintrags ausgewählt sind.

Es ist auch wichtig, sich daran zu erinnern, dass der Versionsvergleich nur aktuelle Sprachen anzeigt. Wenn Ihr Eintrag in der Vergangenheit ins Französische übersetzt wurde, aber später die französische Sprache aus dem Contenttyp entfernt wurde, ist der französische Text nicht mehr sichtbar. Die gleiche Logik gilt für gelöschte Felder: Der Content, der in der Vergangenheit in diesen Feldern gespeichert wurde, wird nicht mehr angezeigt.

Die Snapshot-Vergleichsansicht soll einen Überblick über Änderungen geben. Sie hebt die Felder mit geändertem Content hervor, visualisiert jedoch keine granularen Änderungen innerhalb des Feldes. Dieser Ansatz macht es einfach, versehentlich geänderte Felder zu identifizieren und selektiv zurückzusetzen. Wenn Sie Änderungen auf Feldebene erkennen und verfolgen möchten, empfehlen wir stattdessen die Verwendung von UI-Erweiterungen. Die Diff-UI-Erweiterung, die wir zuvor veröffentlicht haben, bietet einen soliden Ausgangspunkt für den Aufbau einer solchen Funktionalität in Ihrem Projekt.

Ja. Frühere Snapshots des Eintrags enthalten den Content aller Felder, einschließlich der Felder, die für die Arbeit mit UI-Erweiterungen konfiguriert sind. In der Snapshot-Vergleichsansicht werden solche Felder im deaktivierten Modus angezeigt, aber Sie können solche Felder auf die gleiche Weise wie generische Felder in den früheren Zustand zurücksetzen.

Es gibt keinen spezifischen Satz von Berechtigungen, die mit der Content-Versionierung verbunden sind, da wir die Content-Versionierung als eine Teilmenge der Veröffentlichungsaktivitäten behandeln. In der Praxis bedeutet dies, dass Nutzer*innen, die einen Eintrag anzeigen dürfen, auch die vorherigen Versionen des Eintrags anzeigen können. Nutzer*innen, die in einem Eintrag schreiben dürfen, können auch auf die vorherigen Versionen zurückgreifen. Schließlich können Nutzer*innen, deren Berechtigungen auf einzelne Felder beschränkt sind, nur die Felder anzeigen und wiederherstellen, auf die sie zugreifen dürfen.

Ja. Wir haben im Mai 2017 die Unterstützung für die Versionierung von Contenttypen eingeführt. Es gibt keine visuelle Schnittstelle, um diese Änderungen zu überprüfen. Sie müssen sie daher über die API/SDKs abrufen und lokal vergleichen. Andere Entitäten, die in Contentful gefunden werden, wie Assets, Webhooks oder Rollen und Berechtigungen, werden nicht versioniert.

Nein. Bei der Versionierung auf Eintragsebene wird der gesamte im Eintrag enthaltene Content gespeichert – auch lokalisierter Content und Verweise auf andere Einträge und Assets – es werden jedoch keine Snapshots verknüpfter Entitäten erstellt oder gespeichert. Wenn Sie also einen Eintrag mit der früheren Version wiederherstellen, die einen Verweis auf ein gelöschtes Asset enthält, enthält das Bildfeld den Verweis, aber die binäre Asset-Datei fehlt.