Historique des versions
Consultez les versions précédentes, examinez les changements et restaurez le document partagé.
Pour chaque changement confirmé, les développeurs et les utilisateurs peuvent voir l'auteur, l'horodatage et l'action, ouvrir le document tel qu'il se trouvait à ce moment-là, examiner la différence et restaurer une version lorsqu'ils ont la permission. L'historique reste disponible après la fin de la session d'édition et recharge la page.
Fonctionnement de l’historique
A mutation est un changement de contenu rejouable, comme le réglage d'une cellule ou l'insertion d'un paragraphe. A changement est une soumission de collaboration qui porte un groupe ordonné de mutations.
1. Enregistrer les changements
Chaque édition d'un utilisateur ou d'un Agent produit des mutations. Univer emballe ces mutations dans un ensemble de modifications et les soumet pour la collaboration pour confirmer et persister.
Après confirmation, une soumission reçoit un révision, qui identifie sa position dans l'historique du document. L'historique indexe les changements confirmés, les regroupe par temps et par fonctionnement, et construit le calendrier de version.
2. Reconstruire le contenu historique
Un instantané est l'état complet du contenu lors d'une révision. Lorsqu'une version historique est sélectionnée, Univer charge un instantané de base et les changements qui le suivent jusqu'à la révision cible, puis rejoue leurs mutations dans l'ordre. Le résultat est une vue en lecture seule du contenu tel qu'il se trouvait à cette révision.
Exemple : snapshot de la revision 10 + changesets des révisions 11 à 15 = contenu de la revision 15.
3. Restaurer le document actuel
La sélection de Restaurer cette version démarre le flux suivant :
Choisir la version → Soumettre une mutation de restauration → Confirmation collaborative → Mettre à jour le document avec une nouvelle revision
L'opération de restauration crée un nouvel enregistrement historique. Les versions antérieures restent disponibles.
Consulter les versions et les changements
- Ouvrez l’historique depuis l’éditeur et sélectionnez une version.
- Élargir un groupe de versions pour inspecter les révisions individuelles. Sélectionnez une révision pour lire son contenu et les changements dans un visionneur en lecture seule.
- Sélectionnez Restaurer cette version lorsqu'un retour en arrière est nécessaire. La restauration met à jour le document partagé par la collaboration, de sorte que chaque autre participant reçoit la modification.
Un groupe de version peut combiner les modifications faites dans une fenêtre de temps. Élargir le groupe pour inspecter les révisions individuelles. Une entrée d'historique ne correspond pas nécessairement à une frappe ou à un Snapshot généré.
Lire les couleurs
| Repère | Signification |
|---|---|
| 🟦 Bleu: mis à jour | Le contenu actuel a changé. |
| 🟩 Vert : ajout | Nouvelle ligne, nouveau paragraphe, enregistrement ou objet. |
| 🟥 Rouge: supprimé | Contenu supprimé dans cette version. |
Les couleurs indiquent le type de changement. Le remplacement du texte peut produire à la fois une insertion et une suppression. Le visionneur de chaque produit détermine la quantité de contenu surlignée.
L’historique dans cinq produits
Les exemples ci-dessous proviennent d'un seul projet Northstar. Le contenu est en anglais et les échéanciers sont élargis, de sorte que chaque document est montré en même temps que les actions derrière ses changements.
Sheets
Le budget de lancement indique les ajustements budgétaires et prévisionnels ainsi que les lignes insérées et supprimées. La feuille de travail et le calendrier d'action aident à localiser la zone touchée par chaque changement.
Docs
La fiche de lancement du produit couvre la date de lancement, le formatage des paragraphes et les ajouts faits pour la préparation du client. Le texte supprimé reste visible avec brillance rouge, de sorte que chaque révision garde son contexte.
Slides
Tracez les métriques cibles et les objets de page dans la revue de lancement. Sélectionnez une entrée d'historique pour voir les objets mis à jour, insérés et supprimés marqués directement sur la diapositive.
Relational Table
Lancer Tracker affiche les changements aux tâches, aux propriétaires et aux statuts. Les changements d'enregistrement et de champ apparaissent dans le contexte du tableau, ce qui précise quand et comment les données d'entreprise ont changé.
Relational Table — Guide d’intégration
Canvases
Release Workspace affiche les cartes de planification et les propriétés des objets. Les objets insérés, supprimés et mis à jour restent marqués sur la toile, ce qui facilite la révision de la planification.
Canvases — Guide d’intégration
Coming soon: L’historique PDF n’est pas encore disponible.
Intégration dans votre application
L'historique des versions combine l'extension History en Server SDK avec les plugins d'historique des produits en Web SDK.
- Sur le serveur, ajoutez History Service, Endpoint et un adaptateur de base de données persistant à Core Collaboration. Le service s'inscrit à la création d'unité et aux changements engagés, construit un index d'historique et expose les requêtes pour les versions et les changements.
- Dans le navigateur, enregistrez la capacité d'historique commune et les plugins d'interface History / History du produit, puis connectez le paramètre d'historique. Le visionneur charge la révision sélectionnée et affiche ses modifications.
- Votre application fournit l'identité et l'autorisation, et le serveur vérifie l'historique et restaure les autorisations. Une version historique peut contenir des données que le document actuel a déjà supprimées.
Voir extensions de la collaboration et assembler le service avec le Exemple historique, puis connecter l'interface utilisateur aux guides de produits ci-dessus.
Les index d'historiques sont des données dérivées reconstructibles. Les modifications confirmées demeurent la source de contenu faisant autorité. Votre application contrôle la persistance et la rétention. Le panneau d'historique ne remplace pas les sauvegardes.
Liens avec les autres fonctions
| Capacité | Objet |
|---|---|
| Annuler / refaire | Revenir ou réappliquer une opération d'édition sans service d'historique. |
| Historique de la version | Tracez les versions confirmées à travers les sessions, inspectez les changements et restaurez le contenu partagé. |
| Comparaison du contenu | Comparez deux états de contenu pour une UI ou un Agent. Une comparaison en lecture seule ne restaure pas le contenu. |
| Worktree | Isolez les modifications provisoires à examiner avant de les fusionner en contenu partagé. |
Les changements d'agents effectués par l'intermédiaire des API Facade entrent dans le même pipeline d'historique une fois la collaboration confirmée. Les applications peuvent combiner l'historique avec la comparaison de contenu pour l'examen automatisé et les vérifications.
Que pensez-vous de ce guide ?