# Historique des versions
> Consultez les versions précédentes, examinez les changements et restaurez le document partagé.
- Human documentation: [https://docs.univer.ai/fr-FR/overview/features/shared/history](https://docs.univer.ai/fr-FR/overview/features/shared/history)
- Agent Markdown: [https://docs.univer.ai/fr-FR/overview/features/shared/history.md](https://docs.univer.ai/fr-FR/overview/features/shared/history.md)
- Requested language: `fr-FR`
- Content language: `fr-FR`
- Documentation version: `1.3.0`
- Source: [features/shared/history.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/features/shared/history.fr-FR.mdx)
---
L’historique organise les changements collaboratifs confirmés en versions consultables. Il permet de voir les auteurs, les heures, les actions et le contenu antérieur, puis de restaurer une version avec les autorisations nécessaires. Il reste accessible entre les sessions et après un rechargement.
## Fonctionnement de l’historique
- **Mutation**: Une modification rejouable du contenu, par exemple modifier une cellule ou insérer un paragraphe.
- **Changeset**: Une soumission collaborative contenant un groupe ordonné de mutations.
### 1. Enregistrer les changements
**Lors de l’envoi des modifications.** Les changements d’un utilisateur ou d’un Agent produisent des mutations regroupées dans un changeset, envoyé au service de collaboration pour confirmation et enregistrement.
```mermaid
flowchart LR
A["Modifier le contenu"]
B["Mutation"]
C["Changeset"]
D["Confirmer et enregistrer
Noter la revision"]
A --> B
B --> C
C --> D
```
Une **revision** identifie la position d’une soumission confirmée dans l’historique. History indexe les changesets confirmés et les regroupe par heure et opération pour construire la chronologie des versions.
### 2. Reconstruire le contenu historique
**Lors de la sélection d’une version historique.** Un snapshot contient l’état complet du contenu à une revision. Le système charge un snapshot de référence et les changesets suivants jusqu’à la revision cible, puis rejoue leurs mutations dans l’ordre pour créer une vue en lecture seule.
```mermaid
flowchart LR
A["Choisir la version
revision N"]
B["Charger le snapshot
et les changesets suivants"]
C["Rejouer les mutations
dans l’ordre"]
D["Contenu historique
Lecture seule"]
A --> B
B --> C
C --> D
```
Exemple : **snapshot de la revision 10 + changesets des révisions 11 à 15 = contenu de la revision 15.**
### 3. Restaurer le document actuel
**Lors de la sélection de Restaurer cette version.**
> Choisir la version → Soumettre une mutation de restauration → Confirmation collaborative → Mettre à jour le document avec une nouvelle revision
La restauration crée une nouvelle entrée ; les versions précédentes restent disponibles.
## Consulter les versions et les changements
1. Ouvrez l’historique depuis l’éditeur et sélectionnez une version.
2. Développez un groupe pour consulter chaque revision et ses différences dans une visionneuse en lecture seule.
3. Sélectionnez Restaurer cette version pour mettre à jour le document partagé via la collaboration. Les autres participants reçoivent la mise à jour.
Un groupe peut réunir les modifications d’un intervalle de temps. Une entrée ne correspond pas nécessairement à une frappe ou à la création d’un Snapshot.
### Lire les couleurs
| Repère | Signification |
| --- | --- |
| 🟦 **Bleu : modification** | Changement d’un contenu, d’un format ou d’une propriété existants. |
| 🟩 **Vert : ajout** | Nouvelle ligne, nouveau paragraphe, enregistrement ou objet. |
| 🟥 **Rouge : suppression** | Le contenu supprimé conserve un repère dans la vue historique. |
Les couleurs indiquent les types de changement. Un remplacement de texte peut afficher un ajout et une suppression. Chaque visionneuse détermine la portée du surlignage.
## L’historique dans cinq produits
Les exemples Northstar suivants utilisent un contenu en anglais et des chronologies développées.
### Sheets
Consultez les budgets, les prévisions et les lignes ajoutées ou supprimées dans Launch Budget.
[Sheets — Guide d’intégration](https://docs.univer.ai/fr-FR/guides/sheets/features/edit-history.md)
### Docs
Examinez la date de lancement, le formatage et la préparation des clients dans Product Launch Brief. Le texte supprimé reste barré en rouge.
[Docs — Guide d’intégration](https://docs.univer.ai/fr-FR/guides/docs/features/edit-history.md)
### Slides
Suivez les objectifs et les objets de page dans Launch Review.
[Slides — Guide d’intégration](https://docs.univer.ai/fr-FR/guides/slides/features/edit-history.md)
### Relational Table
Consultez les tâches, responsables, statuts et changements d’enregistrements et de champs dans Launch Tracker.
[Relational Table — Guide d’intégration](https://docs.univer.ai/fr-FR/guides/bases/features/edit-history.md)
### Canvases
Retrouvez les changements de cartes et de propriétés dans Release Workspace, avec leur contexte spatial.
[Canvases — Guide d’intégration](https://docs.univer.ai/fr-FR/guides/boards/features/edit-history.md)
### PDF
**Coming soon**: L’historique PDF n’est pas encore disponible.
## Intégration dans votre application
- **Serveur** : ajoutez History Service, Endpoint et un Database Adapter persistant à Core Collaboration. Les événements de création de Unit et de confirmation des changesets alimentent l’index et les requêtes de versions et de changements.
- **Navigateur** : enregistrez la fonction commune et les plugins History / History UI du produit, puis connectez l’API. La visionneuse charge la revision sélectionnée et ses différences. Ajoutez les plugins nécessaires au contenu personnalisé.
- **Autorisations** : votre application fournit identité et autorisation ; le serveur vérifie la lecture de l’historique et la restauration. Les anciennes versions peuvent contenir des données supprimées du document actuel.
Consultez les [extensions de collaboration](https://docs.univer.ai/fr-FR/server/collaboration/extensions.md) et l’[exemple History](https://docs.univer.ai/fr-FR/server/collaboration/examples.md#history), puis les guides produit pour connecter l’interface.
L’index est une donnée dérivée reconstructible. Les changesets confirmés restent la source de référence. L’application gère persistance et rétention ; le panneau ne remplace pas les sauvegardes.
## Liens avec les autres fonctions
- **Annuler / rétablir** : inverse ou réapplique des opérations sans service d’historique.
- **Historique** : retrace les versions confirmées entre les sessions et restaure le contenu partagé.
- [Comparaison de contenu](https://docs.univer.ai/fr-FR/overview/features/shared/compare.md) : compare deux états en lecture seule, sans les restaurer.
- [Worktree](https://docs.univer.ai/fr-FR/overview/features/shared/worktree.md) : isole les brouillons pour décider de leur fusion après examen.
Les modifications d’un Agent via Facade API peuvent suivre le même historique une fois confirmées par la collaboration. La comparaison permet d’ajouter des examens et contrôles automatiques.
[Retour à toutes les fonctionnalités](https://docs.univer.ai/fr-FR/overview/features.md)