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 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
- 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.
- Discuter dans un fil : regroupez le commentaire initial et ses réponses, avec auteurs, dates et texte.
- 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.
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().
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().
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().
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().
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().
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 et l’exemple Comments.
La permission de commenter se configure indépendamment de l’édition du contenu. Consultez permissions et autorisation pour l’identité applicative et l’autorisation du serveur.
Que pensez-vous de ce guide ?