# Comparaison de contenu

> Comparez deux versions et consultez ajouts, suppressions et modifications par produit.

- Human documentation: [https://docs.univer.ai/fr-FR/overview/features/shared/compare](https://docs.univer.ai/fr-FR/overview/features/shared/compare)

- Agent Markdown: [https://docs.univer.ai/fr-FR/overview/features/shared/compare.md](https://docs.univer.ai/fr-FR/overview/features/shared/compare.md)

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.3.0`

- Source: [features/shared/compare.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/features/shared/compare.fr-FR.mdx)

---

Compare reçoit deux snapshots Unit entièrement reconstruits et renvoie des différences sémantiques par cellule, paragraphe, page ou enregistrement. Il sert à relire l’historique, les résultats d’agents et les Worktrees.

## Objets comparés

| Produit | Exemples |
| --- | --- |
| Sheet | Feuilles, valeurs et formules, lignes, colonnes, styles et ressources enregistrées, dont les graphiques. |
| Doc | Paragraphes, texte, styles, tableaux, blocs et dessins. |
| Slide | Pages, éléments, géométrie, styles, dispositions et thèmes. |
| Relational Table | Tables, champs, enregistrements et vues. |
| Canvases | Pages, éléments et ressources associées. |

Les différences sont des ajouts, suppressions ou modifications. Le zoom et la sélection sont exclus. La couverture dépend de l’adaptateur ; PDF n’est pas inclus.

## Le rôle de Snapshot et des changesets dans la comparaison

Un Snapshot conserve l’état complet du contenu à une révision donnée. Une mutation décrit un changement précis ; un changeset regroupe les mutations dans une soumission ordonnée. L’historique conserve et reconstruit les versions ; Compare explique les différences entre deux versions reconstruites.

```mermaid
flowchart LR
    S["Snapshot de base"]
    CA["Appliquer les changesets A"]
    CB["Appliquer les changesets B"]
    A["Version A"]
    B["Version B"]
    C["Comparaison par produit"]
    D["Ajout · suppression · modification"]
    S --> CA --> A
    S --> CB --> B
    A --> C
    B --> C
    C --> D
```

Pour comparer un historique ou un Worktree, on charge un Snapshot de base et on applique les changesets suivants dans l’ordre pour reconstruire chaque révision cible. Les états complets sont transmis à l’adaptateur du produit. Les changesets disponibles peuvent aussi améliorer l’alignement des changements structurels, comme l’insertion ou la suppression de lignes et de colonnes. Deux états complets permettent également une comparaison par snapshots.

Les résultats suivent le modèle de chaque produit : cellules et lignes ou colonnes de Sheet, paragraphes de Doc, éléments de Slide et Canvases, champs et enregistrements de Relational Table. La sélection temporaire et le zoom ne sont pas des modifications du contenu. Compare est en lecture seule ; restaurer une version et fusionner un Worktree sont des opérations distinctes.

## Associer Server SDK et AI SDK

**Server SDK** fournit les Snapshots, changesets et numéros de révision, puis reconstruit le contenu à comparer. L’application transmet les deux états et l’historique disponible à Compare, obtient des différences structurées et les affiche dans une interface web de revue. Voir l’[historique](https://docs.univer.ai/fr-FR/overview/features/shared/history.md) et les [extensions du service de collaboration](https://docs.univer.ai/fr-FR/server/collaboration/extensions.md).

**AI SDK** charge et modifie le contenu dans un Worktree et soumet le résultat de l’Agent. Les applications peuvent utiliser les différences structurées pour les vérifications de l’Agent et les traitements suivants ; les personnes examinent visuellement les mêmes changements avant de décider de la fusion. Voir le [parcours Worktree de l’Agent](https://docs.univer.ai/fr-FR/ai/worktree.md) et les [opérations sur le contenu](https://docs.univer.ai/fr-FR/ai/content-operations.md).

## Exemples de comparaison pour cinq produits

Ces exemples partagent un plan de lancement Northstar : création et soumission d’une version de référence complète, modifications dans un Worktree, puis ouverture de Compare pour examiner les différences.

Dans la liste des différences, le **bleu** indique les modifications, le **vert** les ajouts et le **rouge** les suppressions. Les panneaux en lecture seule montrent le contenu avant et après. Cliquez sur une image pour l’agrandir.

### Sheet : budget et structure des lignes

Modifier les prévisions de recherche et de l’éditeur, supprimer Legacy tooling, ajouter Accessibility QA et recalculer les totaux. Examiner les valeurs et résultats de formules avec les lignes correspondantes.

![Sheet : budget et structure des lignes](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/compare/sheets.jpg)

### Doc : plan de lancement et paragraphes

Modifier la date, le nombre d’équipes pilotes et l’objectif de réalisation. Supprimer l’ancienne approbation et ajouter un contrôle qualité, en conservant le contexte des paragraphes.

![Doc : plan de lancement et paragraphes](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/compare/docs.jpg)

### Slide : indicateurs et éléments de page

Modifier trois cartes d’indicateurs, supprimer le bloc d’approbation et ajouter un contrôle qualité. Comparer le texte et les éléments d’une même page.

![Slide : indicateurs et éléments de page](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/compare/slides.jpg)

### Relational Table : champs et enregistrements de tâches

Modifier l’avancement, les statuts et les dates ; renommer le champ de date ; supprimer l’ancienne approbation et ajouter une tâche d’accessibilité. Examiner par table, champ et enregistrement.

![Relational Table : champs et enregistrements de tâches](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/compare/bases.jpg)

### Canvases : parcours et éléments du canevas

Modifier le nombre d’équipes pilotes et la date, déplacer le nœud de revue et remplacer la carte d’approbation par un contrôle qualité. Examiner le contenu et la disposition dans leur contexte.

![Canvases : parcours et éléments du canevas](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/compare/boards.jpg)

## Interroger les résultats

Enregistrez les plugins de comparaison et extensions Facade du produit, puis appelez `compareUnitData()`. Pour filtrer et paginer plusieurs fois, utilisez `prepareUnitComparison()` et `query()`.

Présentez un résumé puis les détails par feuille, page ou table. Demandez les changements ou les valeurs complètes selon le besoin. Le détail est limité par défaut : la première page ne constitue pas nécessairement tout le résultat. Vérifiez les diagnostics et la couverture.

Consultez l’[API](https://docs.univer.ai/fr-FR/reference/facade/unit-comparison.md), l’[historique](https://docs.univer.ai/fr-FR/overview/features/shared/history.md) et [Worktree](https://docs.univer.ai/fr-FR/overview/features/shared/worktree.md).

[Retour à toutes les fonctionnalités](https://docs.univer.ai/fr-FR/overview/features.md)