# Comentarios e hilos de revisión

> Vincule preguntas a celdas, texto, registros o elementos y siga las decisiones mediante respuestas y resolución.

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

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

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.3.0`

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

---

Los comentarios mantienen la discusión junto al contenido. Un revisor puede preguntar por un valor, párrafo o gráfico; el autor responde en el mismo hilo y otros participantes aportan contexto sin repartir la conversación entre chats externos.

## De la pregunta a la decisión

1. **Vincule la pregunta** a una celda, texto seleccionado, registro, elemento o posición de página, conservando la referencia al contenido.
2. **Converse en un hilo** formado por un comentario raíz y respuestas, con autores, fechas y texto.
3. **Resuelva o reabra** tras los cambios. Reabra el hilo si requiere seguimiento, conservando la conversación.

El panel permite filtrar todos los hilos, pendientes, resueltos o relacionados con el usuario actual. Resolver no elimina la discusión: la decisión puede consultarse después.

## Comentarios y anotaciones por producto

Las capturas usan un proyecto de lanzamiento Northstar en inglés. Se crearon con las API de Facade en editores reales para mostrar comentarios y anotaciones del frontend. Pulse una imagen para ampliarla.

### Sheets

Vincule las discusiones a celdas para confirmar previsiones, costes y aprobaciones junto al presupuesto. El ejemplo muestra varios hilos, respuestas consecutivas y un grupo resuelto. Use `range.addCommentAsync()`; los comentarios sobre imágenes, gráficos y formas requieren su integración de comentarios de dibujos.

![Comentarios de Sheets: presupuesto, celdas vinculadas, respuestas y discusión resuelta](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/sheets.png)

[Integración y API del producto](https://docs.univer.ai/es-ES/guides/sheets/features/comments.md)

### Docs

Comente rangos de texto al revisar contratos, propuestas o fechas de lanzamiento. Las tarjetas conservan el fragmento citado y las decoraciones mantienen la ubicación durante la edición. El ejemplo discute la fecha, las métricas y la sustitución de un proceso anterior. Use `document.getTextRange(...).createCommentAsync()`.

![Comentarios de Docs: resumen del lanzamiento, citas y tres hilos de revisión](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/docs.png)

[Integración y API del producto](https://docs.univer.ai/es-ES/guides/docs/features/comments.md)

### Slides

Comente elementos o una posición libre de la diapositiva. Los comentarios de elementos referencian ID estables de cuadros de texto, imágenes o gráficos; los de posición usan coordenadas normalizadas de página. El ejemplo revisa objetivos y distribución. Use `slide.createElementCommentAsync()` y `slide.createPositionCommentAsync()`.

![Comentarios de Slides: revisión del lanzamiento, elementos y respuestas de varios revisores](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/slides.png)

[Integración y API del producto](https://docs.univer.ai/es-ES/guides/slides/features/comments.md)

### Relational Table

Los comentarios se vinculan al ID del registro, sin depender del número de fila visible. Úselos para traspasos, seguimiento de clientes y aceptación. El seguimiento del lanzamiento muestra responsables, aprobaciones pendientes y marcas de comentarios junto a los registros. Use `record.createCommentAsync()`.

![Comentarios de Relational Table: registros, marcas de comentarios y discusiones de traspaso](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/bases.png)

[Integración y API del producto](https://docs.univer.ai/es-ES/guides/bases/features/thread-comment.md)

### Canvases

Adjunte comentarios a elementos, como formas, o a una posición del tablero. Los primeros referencian el objeto; los segundos conservan coordenadas del tablero. El ejemplo trata investigación de clientes, traspaso de ingeniería y riesgos del lanzamiento. Use `board.createElementCommentAsync()` y `board.createPositionCommentAsync()`.

![Comentarios de Canvases: flujo de lanzamiento, elementos, posiciones y respuestas](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/boards.png)

[Integración y API del producto](https://docs.univer.ai/es-ES/guides/boards/features/comments.md)

### PDF: anotaciones de página

PDF ofrece actualmente anotaciones de página: resaltado, subrayado, tachado, líneas onduladas y tinta. Son objetos PDF persistibles, distintos de los hilos con respuestas y resolución anteriores. El ejemplo resalta la fecha, marca criterios de aceptación y tacha un paso de aprobación antiguo. Use `page.insertAnnotation()`.

![Anotaciones PDF: revisión con resaltado, subrayado, tachado y tinta](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/pdfs.png)

[Integración y API del producto](https://docs.univer.ai/es-ES/guides/pdfs/features/core/annotations-and-native-text.md)

## Integración

**Frontend**: registre los plugins de comentarios y UI del producto e importe las entradas `/facade` comunes y específicas. Los métodos del producto establecen anclajes; `replyCommentAsync()`, `updateCommentAsync()` y `resolveCommentAsync()` gestionan las operaciones posteriores. Use `resolved: false` para reabrir. PDF tiene una API de anotaciones independiente.

**Discusiones compartidas**: añada Comment Service, Comment Endpoint y un adaptador de base de datos independiente junto a la colaboración básica y configure la fuente de datos remota del frontend. El documento principal conserva los anclajes que cambian con el contenido; Comment Service guarda texto, respuestas y estado, y publica actualizaciones en las salas del documento. Consulte los [paquetes de comentarios](https://docs.univer.ai/es-ES/server/collaboration/packages.md#thread-comment) y el [ejemplo Comments](https://docs.univer.ai/es-ES/server/collaboration/examples.md#comments).

El permiso de comentar puede configurarse independientemente de la edición. Consulte [permisos y autorización](https://docs.univer.ai/es-ES/overview/features/shared/permissions.md) para la identidad de la aplicación y la autorización del servidor.

[Volver a todas las funciones](https://docs.univer.ai/es-ES/overview/features.md)
