# Commentaires et fils de révision > Reliez les questions aux cellules, textes, enregistrements ou éléments et suivez les décisions par les réponses et la résolution. - Human documentation: [https://docs.univer.ai/fr-FR/overview/features/shared/comments](https://docs.univer.ai/fr-FR/overview/features/shared/comments) - Agent Markdown: [https://docs.univer.ai/fr-FR/overview/features/shared/comments.md](https://docs.univer.ai/fr-FR/overview/features/shared/comments.md) - Requested language: `fr-FR` - Content language: `fr-FR` - Documentation version: `1.3.0` - Source: [features/shared/comments.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/features/shared/comments.fr-FR.mdx) --- Les commentaires gardent la discussion près du contenu. Un réviseur peut questionner une valeur, un paragraphe ou un graphique ; l’auteur répond dans le même fil et les autres participants ajoutent du contexte sans disperser les échanges dans des conversations externes. ## De la question à la décision 1. **Cibler le contenu** : commentez une cellule, du texte sélectionné, un enregistrement, un élément ou une position de page en conservant la référence. 2. **Discuter dans un fil** : regroupez le commentaire initial et ses réponses, avec auteurs, dates et texte. 3. **Résoudre ou rouvrir** après les modifications. Rouvrez le fil si un suivi est nécessaire, en conservant les échanges. Le panneau filtre tous les fils, les non résolus, les résolus ou ceux concernant l’utilisateur actuel. Résoudre ne supprime pas la discussion : la décision reste consultable. ## Commentaires et annotations par produit Les captures présentent un même projet de lancement Northstar en anglais. Elles ont été créées avec les API Facade dans de vrais éditeurs pour illustrer commentaires et annotations côté client. Cliquez sur une image pour l’agrandir. ### Sheets Ancrez les discussions aux cellules pour confirmer prévisions, coûts et validations à côté du budget. L’exemple montre plusieurs fils, des réponses successives et un groupe résolu. Utilisez `range.addCommentAsync()` ; les commentaires sur images, graphiques et formes nécessitent leur intégration de commentaires de dessin. ![Commentaires Sheets : budget, cellules ciblées, réponses et discussion résolue](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/sheets.png) [Intégration et API du produit](https://docs.univer.ai/fr-FR/guides/sheets/features/comments.md) ### Docs Commentez une sélection de texte pour réviser un contrat, une proposition ou une date de lancement. Les cartes conservent la citation et les décorations maintiennent l’ancrage pendant l’édition. L’exemple aborde la date, la définition des indicateurs et le remplacement d’une ancienne procédure. Utilisez `document.getTextRange(...).createCommentAsync()`. ![Commentaires Docs : note de lancement, citations et trois fils de révision](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/docs.png) [Intégration et API du produit](https://docs.univer.ai/fr-FR/guides/docs/features/comments.md) ### Slides Commentez un élément ou une position libre de la diapositive. Les éléments sont référencés par un ID stable : texte, image, graphique, etc. Les positions utilisent des coordonnées normalisées dans la page. L’exemple révise objectifs et disposition. Utilisez `slide.createElementCommentAsync()` et `slide.createPositionCommentAsync()`. ![Commentaires Slides : revue de lancement, éléments ciblés et réponses de plusieurs réviseurs](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/slides.png) [Intégration et API du produit](https://docs.univer.ai/fr-FR/guides/slides/features/comments.md) ### Relational Table Les commentaires sont liés à l’ID de l’enregistrement, sans dépendre du numéro de ligne affiché. Ils servent aux transmissions, au suivi client et à la réception. Le suivi du lancement présente responsables, validations en attente et marqueurs de commentaires. Utilisez `record.createCommentAsync()`. ![Commentaires Relational Table : enregistrements, marqueurs et discussions de transmission](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/bases.png) [Intégration et API du produit](https://docs.univer.ai/fr-FR/guides/bases/features/thread-comment.md) ### Canvases Attachez un commentaire à un élément, comme une forme, ou à une position du tableau. Les premiers référencent l’objet ; les seconds conservent des coordonnées. L’exemple discute recherche client, transmission technique et risques du lancement. Utilisez `board.createElementCommentAsync()` et `board.createPositionCommentAsync()`. ![Commentaires Canvases : processus coloré, éléments, positions et réponses](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/boards.png) [Intégration et API du produit](https://docs.univer.ai/fr-FR/guides/boards/features/comments.md) ### PDF : annotations de page PDF propose actuellement des annotations de page : surlignage, soulignement, texte barré, lignes ondulées et encre. Ce sont des objets PDF persistants, distincts des fils avec réponses et résolution ci-dessus. L’exemple marque la date et les critères de réception, puis barre une ancienne étape de validation. Utilisez `page.insertAnnotation()`. ![Annotations PDF : revue avec surlignage, soulignement, texte barré et encre](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/pdfs.png) [Intégration et API du produit](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/annotations-and-native-text.md) ## Intégration **Client** : enregistrez les plugins de commentaires et d’interface du produit, puis importez les entrées `/facade` communes et spécifiques. Les méthodes du produit établissent les ancrages ; `replyCommentAsync()`, `updateCommentAsync()` et `resolveCommentAsync()` gèrent la suite des échanges. Passez `resolved: false` pour rouvrir. PDF utilise une API d’annotation distincte. **Discussions partagées** : ajoutez Comment Service, Comment Endpoint et un adaptateur de base de données indépendant à la collaboration de base, puis configurez la source distante du client. Le document principal conserve les ancrages qui évoluent avec le contenu ; Comment Service stocke texte, réponses et état de résolution et publie les mises à jour dans les salons du document. Consultez les [packages de commentaires](https://docs.univer.ai/fr-FR/server/collaboration/packages.md#thread-comment) et l’[exemple Comments](https://docs.univer.ai/fr-FR/server/collaboration/examples.md#comments). La permission de commenter se configure indépendamment de l’édition du contenu. Consultez [permissions et autorisation](https://docs.univer.ai/fr-FR/overview/features/shared/permissions.md) pour l’identité applicative et l’autorisation du serveur. [Retour à toutes les fonctionnalités](https://docs.univer.ai/fr-FR/overview/features.md)