Historique des versions
Sur un modèle versionné, chaque enregistrement écrit une nouvelle version numérotée qui n'est jamais modifiée ensuite. Vous pouvez lister les versions d'un enregistrement, comparer l'une avec la précédente et restaurer une version antérieure.
Quels modèles conservent un historique
Un modèle conserve un historique lorsque le versionnement, la publication ou les variantes sont activés pour lui. Les trois sont désactivés par défaut et sont définis par modèle. Sur un modèle sans aucun des trois, une mise à jour remplace les données sur place.
Ce qu'affiche la console
L'onglet History d'un enregistrement liste ses versions avec le nom de l'auteur et la description de la modification. De là, vous pouvez comparer une version avec la précédente, ou la restaurer. La description est facultative via l'API et la CLI, et la console renseigne "Content saved" quand un éditeur la laisse vide.
Restaurer ajoute une version
Une restauration rétablit le contenu de l'ancienne version sous forme de nouvelle version, validée comme n'importe quel autre enregistrement. L'historique ne va que vers l'avant, et la version dont vous restaurez reste inchangée. Si le modèle a changé depuis l'écriture de cette version, la restauration supprime les champs que le modèle ne déclare plus et refuse les valeurs dont la forme n'est plus acceptée.
Vérifier une restauration d'abord
foir records revert accepte l'option --dry-run : elle indique ce qui serait converti, supprimé ou refusé, n'écrit rien, et se termine avec un code non nul si l'annulation serait refusée. La mutation revert en GraphQL possède un argument dryRun équivalent.
Combien de temps l'historique est conservé
L'historique est conservé pendant une fenêtre qui dépend de votre forfait, et un nettoyage quotidien récupère les versions plus anciennes. Certaines versions sont conservées quel que soit leur âge : celle en cours d'édition, la version publiée, celle placée en file pour une publication planifiée, celle qu'une annulation de déploiement restaurerait, et la version la plus récente de chaque enregistrement.
Lire le détail
Le guide des enregistrements explique comment les versions sont écrites, combien de temps elles sont conservées et ce que fait une restauration lorsque le modèle a changé.