Comparaison de contenu
Comparez deux versions et consultez ajouts, suppressions et modifications par produit.
Comparer les rapports ce qui a changé entre deux versions. Il accepte deux instantanés d'unité entièrement reconstruits et renvoie les différences sémantiques dans les cellules, les paragraphes, les pages ou les enregistrements. Il prend en charge l'historique, la vérification de la sortie Agent, et l'inspection d'un Worktree.
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. |
Chaque changement est un ajout, une suppression ou une mise à jour. L'état temporaire de l'interface utilisateur, tel que le niveau de zoom et la sélection, n'est pas un changement de contenu.
Le rôle de Snapshot et des changesets dans la comparaison
Un Snapshot stocke l'état complet du contenu lors d'une révision spécifique. Une mutation décrit un changement de contenu unique et un groupe de changements se transforme en commit commandé. L'historique stocke les versions et les reconstitue sur demande.
Pour comparer une entrée d'historique ou une Worktree, chargez le Snapshot de base et appliquez les changements suivants dans l'ordre jusqu'à ce que le contenu atteigne la révision de la cible. Effectuez cette reconstruction pour chaque côté, puis passez les deux états complets à l'adaptateur du produit. Lorsque les changements correspondants sont disponibles, comparez aligne les changements structurels tels que les lignes et les colonnes insérées ou supprimées plus précisément.
Les résultats suivent le modèle de contenu de chaque produit : cellules et lignes ou colonnes pour Feuille, paragraphes pour Doc, éléments pour Diapositive et Toiles, et champs et enregistrements pour Table Relationnelle. Une sélection temporaire ou un niveau de zoom n'est pas un changement de contenu. Comparer est en lecture seule. Restaurer une version et fusionner un Worktree sont des opérations séparées.
Associer Server SDK et AI SDK
Server SDK fournit les Snapshots, les changementset, et les numéros de révision, et il reconstitue le contenu à comparer. Une application passe les deux états et l'historique qu'il doit comparer, reçoit des différences structurées, et présente une interface de révision sur le web. Voir Historique et prolongements de services de collaboration.
AI SDK charge et modifie le contenu dans un Worktree Une application peut utiliser les différences structurées pour les vérifications d'Agent et le traitement ultérieur, tandis qu'une personne examine les mêmes changements visuellement et décide de les fusionner. Agent Worktree flux de travail et Opérations de contenu.
Exemples de comparaison pour cinq produits
Les cinq exemples utilisent le même plan de lancement de Northstar. Nous avons créé et soumis une base de référence complète, l'avons édité dans un Worktree, puis ouvert Comparer pour inspecter les changements.
Dans la liste des modifications, bleu marque les modifications, vert ajouts et rouge suppressions. Les panneaux en lecture seule affichent le contenu avant et après la modification. Cliquez sur une image pour l'agrandir.
Sheet : budget et structure des lignes
Nous avons mis à jour les prévisions de la recherche et de l'éditeur, supprimé l'outil Legacy, ajouté l'AQ d'accessibilité et recalculé les totaux.
Doc : plan de lancement et paragraphes
Nous avons modifié la date de lancement, le nombre d'équipes pilotes et l'objectif d'achèvement, enlevé le texte d'approbation et ajouté une grille de qualité. Le contexte préservé facilite l'examen au niveau des paragraphes.
Slide : indicateurs et éléments de page
Nous avons mis à jour trois cartes métriques, enlevé le bloc d'approbation et ajouté une grille de qualité. La comparaison couvre le texte et les éléments sur la même page plutôt que de traiter la page comme une nouvelle image.
Relational Table : champs et enregistrements de tâches
Nous avons mis à jour les progrès, l'état et les dates, rebaptisé le champ de date, enlevé le dossier d'approbation et ajouté une tâche d'accessibilité.
Canvases : parcours et éléments du canevas
Nous avons mis à jour la taille du pilote et la date de lancement, déplacé le nœud d'examen et remplacé la carte d'approbation existante par une grille de qualité.
Interroger les résultats
Enregistrez les plugins de comparaison d'historique et les extensions Facade du produit, puis appelez compareUnitData(). Pour le filtrage et la pagination répétés, créez une session avec prepareUnitComparison() et appelez query().
Affichez d'abord un résumé, puis forez-le dans des feuilles de travail, des pages ou des tableaux. Demandez des listes de changements ou des valeurs complètes avant/après au besoin. Les résultats détaillés par défaut sont limités, de sorte que la première page n'est pas nécessairement la diff complète. Vérifiez le diagnostic et l'état de couverture avant de présenter les résultats.
Consultez l’API, l’historique et Worktree.
Que pensez-vous de ce guide ?