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.

Les commentateurs peuvent poser des questions sur une valeur, un paragraphe ou un graphique, les auteurs répondent dans le même thread, et d'autres participants ajoutent du contexte, de sorte que la discussion ne se propage pas aux outils de chat externe.

De la question à la décision

  1. Ancrage de la question vers une cellule, un texte sélectionné, un enregistrement, un élément ou une position de page. L'ancre conserve une référence au contenu qu'elle pointe.
  2. Discutez-en dans un fil composé d'un commentaire racine et des réponses, chacune avec son auteur, son horodatage et son texte de commentaire.
  3. Résoudre ou rouvrir le thread après avoir apporté des modifications. Réouvrir un thread lorsque le suivi est nécessaire; la discussion antérieure reste intacte.

Le groupe de commentaires filtre tous les threads, non résolus ou résolus, ou les discussions impliquant l'utilisateur actuel. La résolution d'un thread ne le supprime pas; la décision reste disponible pour examen.

Commentaires et annotations par produit

Les captures d'écran utilisent un seul projet de lancement Northstar en anglais. Elles ont été capturées par l'intermédiaire des API Facade dans de vrais éditeurs pour afficher des commentaires et des annotations frontend. Cliquez sur une image pour l'agrandir.

Sheets

Une discussion ancrée dans une cellule permet à un examinateur de confirmer une prévision, un détail des coûts ou une approbation directement à côté du numéro du budget. L'exemple montre plusieurs threads, une série de réponses consécutives et une section résolue. Les commentaires de cellules sont ajoutés par l'intermédiaire de range.addCommentAsync(); les commentaires sur les images, les graphiques et les formes nécessitent l'intégration du dessin-commentaire correspondant.

Intégration et API du produit

Docs

Sélectionnez une plage de texte et ajoutez un commentaire lors de l'examen des clauses du contrat, du libellé de la proposition ou des dates de lancement. Les cartes de commentaires conservent le texte cité et les décorations de commentaires maintiennent l'ancre pendant que le texte environnant change. L'exemple traite de la date de sortie, des définitions métriques et du remplacement d'un ancien workflow. Appelez document.getTextRange(...).createCommentAsync().

Intégration et API du produit

Slides

Les commentaires peuvent cibler un seul élément ou une position libre sur une diapositive. Element commente des ID stables pour les boîtes de texte, les images, les graphiques et autres objets; position commente utilise des coordonnées de page normalisées. L'exemple traite des cibles de lancement et de la mise en page. Appelez slide.createElementCommentAsync() et slide.createPositionCommentAsync().

Intégration et API du produit

Relational Table

Commenter les ID des dossiers de référence, de sorte qu'une discussion reste liée à un dossier d'entreprise plutôt qu'à son numéro de ligne visible. Ils sont utilisés pour les remises, le suivi des clients et les évaluations d'acceptation. Le traqueur de lancement montre les discussions des propriétaires, les approbations en attente, et les marqueurs de commentaires à côté des dossiers. Appelez record.createCommentAsync().

Intégration et API du produit

Canvases

Un commentaire peut être joint à un élément tel qu'une forme, ou laissé comme note à une position spécifique du conseil d'administration. Les commentaires de l'élément renvoient à un objet; les commentaires de position maintiennent les coordonnées du conseil. board.createElementCommentAsync() et board.createPositionCommentAsync().

Intégration et API du produit

PDF : annotations de page

Le PDF fournit actuellement des annotations de page : mises en évidence, souligne, frappe, lignes squiggly, et encre. Ce sont des objets d'annotation PDF persistantes, séparés des fils ci-dessus qui supportent les réponses et la résolution. L'exemple met en évidence une date de lancement, marque les critères d'acceptation et franchit une ancienne étape d'approbation. Appelez page.insertAnnotation().

Intégration et API du produit

Intégration

Frontière: enregistrez les plugins de commentaire et d'interface utilisateur du produit, et importez les entrées de commentaire partagées et spécifiques au produit /facade. Des méthodes spécifiques au produit établissent des ancres, tandis que des API partagées telles que replyCommentAsync(), updateCommentAsync() et resolveCommentAsync() gèrent les opérations de discussion qui suivent. Passez resolved: false pour rouvrir un thread. PDF utilise une API d'annotation séparée.

Débat partagé: ajouter Comment Service, Comment Endpoint, et un adaptateur de base de données indépendant à côté de la collaboration de base, puis configurer la source de données frontend distante. Le document principal conserve les ancres, qui changent avec le contenu; Comment Service stocke le texte, les réponses et l'état de résolution, et publie des mises à jour de commentaires dans les salles de documents. Voir commentaires paquets et le Exemple de commentaires.

La permission de commenter peut être configurée séparément de la permission de modifier le contenu. Pour l'identité de l'application et l'autorisation côté serveur, voir autorisation et autorisation.

Retour à toutes les fonctionnalités

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.