Комментарии и обсуждения при проверке
Привязывайте вопросы к ячейкам, тексту, записям и элементам, отслеживая решения через ответы и статус обсуждения.
Комментарии сохраняют обсуждение рядом с содержимым. Рецензент может задать вопрос о значении, абзаце или графике; автор и другие участники отвечают в той же ветке, не перенося контекст во внешние чаты.
От вопроса к решению
- Укажите содержимое: создайте комментарий к ячейке, выделенному тексту, записи, элементу или позиции страницы, сохранив ссылку на объект.
- Обсудите в ветке: корневой комментарий и ответы объединяются с указанием авторов, времени и текста.
- Завершите или возобновите после исправлений. При необходимости откройте обсуждение снова, сохранив переписку.
Панель позволяет отбирать все обсуждения, незавершённые, завершённые и связанные с текущим пользователем. Завершение не удаляет ветку: историю решения можно просмотреть позднее.
Комментарии и аннотации по продуктам
Скриншоты показывают один проект запуска Northstar на английском языке. Примеры созданы через Facade API в настоящих редакторах и демонстрируют клиентские комментарии и аннотации. Нажмите на изображение для увеличения.
Sheets
Привязывайте обсуждения к ячейкам, чтобы уточнять прогнозы, расходы и согласования рядом с бюджетом. Пример показывает несколько веток, последовательные ответы и завершённое обсуждение. Используйте range.addCommentAsync(); комментарии к изображениям, диаграммам и фигурам требуют соответствующей интеграции комментариев графических объектов.
Docs
Комментируйте выделенный текст при проверке договоров, предложений или дат запуска. Карточки сохраняют цитату, а декорации комментариев поддерживают привязку при редактировании. Пример посвящён дате, определениям метрик и замене старого процесса. Используйте document.getTextRange(...).createCommentAsync().
Slides
Комментируйте отдельные элементы или свободную позицию слайда. Элементы связаны стабильными ID текстовых блоков, изображений, диаграмм и других объектов; позиции используют нормализованные координаты страницы. Пример обсуждает цели запуска и компоновку. Используйте slide.createElementCommentAsync() и slide.createPositionCommentAsync().
Relational Table
Комментарии связаны с ID записи, а не её видимым номером строки. Они подходят для передачи задач, работы с клиентами и приёмки. В таблице запуска показаны обсуждения ответственных, ожидаемые согласования и отметки комментариев у записей. Используйте record.createCommentAsync().
Canvases
Прикрепляйте комментарии к элементам, например фигурам, или к позиции на доске. Первые ссылаются на объект, вторые сохраняют координаты доски. Пример обсуждает исследование клиентов, передачу разработки и риски запуска. Используйте board.createElementCommentAsync() и board.createPositionCommentAsync().
PDF: аннотации страниц
PDF пока предоставляет аннотации страниц: выделение цветом, подчёркивание, зачёркивание, волнистые линии и рукописные штрихи. Это сохраняемые объекты PDF, отличающиеся от веток с ответами и завершением выше. Пример выделяет дату и критерии приёмки и зачёркивает старый этап согласования. Используйте page.insertAnnotation().
Интеграция
Клиент: зарегистрируйте плагины комментариев и UI продукта и импортируйте общие и продуктовые входы /facade. Методы продукта создают привязки; replyCommentAsync(), updateCommentAsync() и resolveCommentAsync() выполняют последующие операции. Передайте resolved: false для возобновления ветки. PDF использует отдельный API аннотаций.
Общие обсуждения: добавьте Comment Service, Comment Endpoint и отдельный адаптер базы данных к основной совместной работе, затем настройте удалённый источник данных клиента. Основной документ хранит привязки, меняющиеся вместе с содержимым; Comment Service сохраняет текст, ответы и статус и публикует обновления в комнатах документа. См. пакеты комментариев и пример Comments.
Право комментирования настраивается независимо от редактирования содержимого. Идентификация приложения и авторизация сервера описаны в разделе разрешения и авторизация.
Насколько полезно это руководство?