# Комментарии и обсуждения при проверке

> Привязывайте вопросы к ячейкам, тексту, записям и элементам, отслеживая решения через ответы и статус обсуждения.

- Human documentation: [https://docs.univer.ai/ru-RU/overview/features/shared/comments](https://docs.univer.ai/ru-RU/overview/features/shared/comments)

- Agent Markdown: [https://docs.univer.ai/ru-RU/overview/features/shared/comments.md](https://docs.univer.ai/ru-RU/overview/features/shared/comments.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.3.0`

- Source: [features/shared/comments.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/features/shared/comments.ru-RU.mdx)

---

Комментарии сохраняют обсуждение рядом с содержимым. Рецензент может задать вопрос о значении, абзаце или графике; автор и другие участники отвечают в той же ветке, не перенося контекст во внешние чаты.

## От вопроса к решению

1. **Укажите содержимое**: создайте комментарий к ячейке, выделенному тексту, записи, элементу или позиции страницы, сохранив ссылку на объект.
2. **Обсудите в ветке**: корневой комментарий и ответы объединяются с указанием авторов, времени и текста.
3. **Завершите или возобновите** после исправлений. При необходимости откройте обсуждение снова, сохранив переписку.

Панель позволяет отбирать все обсуждения, незавершённые, завершённые и связанные с текущим пользователем. Завершение не удаляет ветку: историю решения можно просмотреть позднее.

## Комментарии и аннотации по продуктам

Скриншоты показывают один проект запуска Northstar на английском языке. Примеры созданы через Facade API в настоящих редакторах и демонстрируют клиентские комментарии и аннотации. Нажмите на изображение для увеличения.

### Sheets

Привязывайте обсуждения к ячейкам, чтобы уточнять прогнозы, расходы и согласования рядом с бюджетом. Пример показывает несколько веток, последовательные ответы и завершённое обсуждение. Используйте `range.addCommentAsync()`; комментарии к изображениям, диаграммам и фигурам требуют соответствующей интеграции комментариев графических объектов.

![Комментарии Sheets: бюджет запуска, ячейки, ответы и завершённое обсуждение](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/sheets.png)

[Интеграция продукта и API](https://docs.univer.ai/ru-RU/guides/sheets/features/comments.md)

### Docs

Комментируйте выделенный текст при проверке договоров, предложений или дат запуска. Карточки сохраняют цитату, а декорации комментариев поддерживают привязку при редактировании. Пример посвящён дате, определениям метрик и замене старого процесса. Используйте `document.getTextRange(...).createCommentAsync()`.

![Комментарии Docs: описание запуска, цитаты и три ветки проверки](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/docs.png)

[Интеграция продукта и API](https://docs.univer.ai/ru-RU/guides/docs/features/comments.md)

### Slides

Комментируйте отдельные элементы или свободную позицию слайда. Элементы связаны стабильными ID текстовых блоков, изображений, диаграмм и других объектов; позиции используют нормализованные координаты страницы. Пример обсуждает цели запуска и компоновку. Используйте `slide.createElementCommentAsync()` и `slide.createPositionCommentAsync()`.

![Комментарии Slides: обзор запуска, привязки к элементам и ответы нескольких участников](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/slides.png)

[Интеграция продукта и API](https://docs.univer.ai/ru-RU/guides/slides/features/comments.md)

### Relational Table

Комментарии связаны с ID записи, а не её видимым номером строки. Они подходят для передачи задач, работы с клиентами и приёмки. В таблице запуска показаны обсуждения ответственных, ожидаемые согласования и отметки комментариев у записей. Используйте `record.createCommentAsync()`.

![Комментарии Relational Table: записи запуска, отметки комментариев и обсуждение передачи задач](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/bases.png)

[Интеграция продукта и API](https://docs.univer.ai/ru-RU/guides/bases/features/thread-comment.md)

### Canvases

Прикрепляйте комментарии к элементам, например фигурам, или к позиции на доске. Первые ссылаются на объект, вторые сохраняют координаты доски. Пример обсуждает исследование клиентов, передачу разработки и риски запуска. Используйте `board.createElementCommentAsync()` и `board.createPositionCommentAsync()`.

![Комментарии Canvases: цветная схема запуска, элементы, позиции и ответы](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/boards.png)

[Интеграция продукта и API](https://docs.univer.ai/ru-RU/guides/boards/features/comments.md)

### PDF: аннотации страниц

PDF пока предоставляет аннотации страниц: выделение цветом, подчёркивание, зачёркивание, волнистые линии и рукописные штрихи. Это сохраняемые объекты PDF, отличающиеся от веток с ответами и завершением выше. Пример выделяет дату и критерии приёмки и зачёркивает старый этап согласования. Используйте `page.insertAnnotation()`.

![Аннотации PDF: проверка с выделением, подчёркиванием, зачёркиванием и рукописными штрихами](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/pdfs.png)

[Интеграция продукта и API](https://docs.univer.ai/ru-RU/guides/pdfs/features/core/annotations-and-native-text.md)

## Интеграция

**Клиент**: зарегистрируйте плагины комментариев и UI продукта и импортируйте общие и продуктовые входы `/facade`. Методы продукта создают привязки; `replyCommentAsync()`, `updateCommentAsync()` и `resolveCommentAsync()` выполняют последующие операции. Передайте `resolved: false` для возобновления ветки. PDF использует отдельный API аннотаций.

**Общие обсуждения**: добавьте Comment Service, Comment Endpoint и отдельный адаптер базы данных к основной совместной работе, затем настройте удалённый источник данных клиента. Основной документ хранит привязки, меняющиеся вместе с содержимым; Comment Service сохраняет текст, ответы и статус и публикует обновления в комнатах документа. См. [пакеты комментариев](https://docs.univer.ai/ru-RU/server/collaboration/packages.md#thread-comment) и [пример Comments](https://docs.univer.ai/ru-RU/server/collaboration/examples.md#comments).

Право комментирования настраивается независимо от редактирования содержимого. Идентификация приложения и авторизация сервера описаны в разделе [разрешения и авторизация](https://docs.univer.ai/ru-RU/overview/features/shared/permissions.md).

[Назад ко всем функциям](https://docs.univer.ai/ru-RU/overview/features.md)
