Gestion des versions

La gestion des versions n’est disponible que sur l’environnement principal.

La gestion des versions fait référence à la pratique consistant à produire plusieurs instantanés d’un document. La gestion des versions des entrées permet aux utilisateurs de Contentful de consulter les versions précédemment publiées de l’entrée, de savoir qui a publié une entrée et à quel moment, de comparer les instantanés précédents à la version actuelle et, si nécessaire, de restaurer le contenu à l’état antérieur.

Actuellement, Contentful produit un instantané d’une entrée chaque fois qu’elle est publiée ou republiée. Cela permet de revenir facilement aux versions précédentes lorsqu’une entrée est accidentellement modifiée. Vous pouvez choisir de restaurer le contenu de champs individuels ou de l’entrée entière. La gestion des versions des entrées est disponible dans l’application web et via les points de terminaison d’API dédiés :

Le point de terminaison /spaces/X/entries/Y/snapshots répertorie tous les instantanés disponibles pour une entrée donnée.

Le point de terminaison /spaces/X/entries/Y/snapshots/Z fournit le contenu d’un instantané sélectionné.

La fonctionnalité de gestion des versions des entrées comporte certaines limitations qui peuvent affecter le type de contenu que vous voyez dans votre application. Les instantanés d’entrée ne remontent qu’au 12 octobre 2016, ce qui rend impossible la comparaison de l’entrée actuelle avec les versions publiées avant cette date. Le contenu localisé n’apparaîtra dans la comparaison des versions que si les paramètres de langue-région respectifs sont sélectionnés dans la barre latérale de l’entrée.

Il est également important de se rappeler que la comparaison de versions n’affiche que les paramètres de langue-région actuels. Si votre entrée a été traduite en français dans le passé, mais que les paramètres de langue-région français ont été supprimés du type de contenu, le texte français ne sera plus visible. La même logique s’applique aux champs supprimés : tout contenu qui a été stocké dans ces champs dans le passé ne sera plus affiché.

La vue de comparaison des instantanés est conçue pour fournir un aperçu des modifications. Elle met en évidence les champs dont le contenu a été modifié, mais ne visualise pas les modifications granulaires dans le champ. Cette approche permet d’identifier facilement les champs modifiés accidentellement et de les annuler de manière sélective. Si vous souhaitez détecter et suivre les modifications au niveau du champ, nous vous recommandons d’utiliser des extensions d’interface utilisateur à la place. L’extension d’interface utilisateur Diff que nous avons publiée précédemment fournit un point de départ solide pour intégrer une telle fonctionnalité dans votre projet.

Oui. Les captures instantanées passées de l’entrée incluent le contenu de tous les champs, y compris les champs configurés pour fonctionner avec les extensions d’interface utilisateur. Dans la vue de comparaison des instantanés, ces champs sont affichés en mode désactivé, mais vous pouvez les ramener à l’état antérieur de la même manière que les champs génériques.

Il n’existe pas d’ensemble spécifique d’autorisations associées à la gestion des versions de contenu, car nous traitons la gestion des versions de contenu comme un sous-ensemble des activités de publication. En pratique, cela signifie que les utilisateurs autorisés à consulter une entrée peuvent également consulter les versions précédentes de l’entrée. Les utilisateurs autorisés à écrire dans une entrée peuvent également revenir aux versions précédentes. Enfin, les utilisateurs dont les privilèges sont limités à des champs individuels ne peuvent afficher et restaurer que les champs auxquels ils sont autorisés à accéder.

Oui. Nous avons déployé la prise en charge de la gestion des versions des types de contenu en mai 2017. Il n’existe pas d’interface visuelle pour inspecter ces modifications, vous devrez donc les récupérer via l’API/les SDK et les comparer localement. Les autres entités trouvées dans Contentful, telles que les ressources média, les webhooks ou les rôles et autorisations ne sont pas versionnées.

Non. La gestion de versions de base stocke tout le contenu présent dans l’entrée — y compris le contenu localisé et les références à d’autres entrées et ressources — mais elle ne crée ni ne conserve de captures instantanées des entités liées. Ainsi, si vous restaurez une entrée à la version antérieure contenant une référence à une ressource média supprimée, le champ image contiendra la référence, mais le fichier binaire de la ressource sera manquant.