Comentarios e hilos de revisión
Vincule preguntas a celdas, texto, registros o elementos y siga las decisiones mediante respuestas y resolución.
Los comentarios mantienen discusiones al lado del contenido. Los revisores pueden plantear preguntas sobre un valor, un párrafo o un gráfico, los autores responden en el mismo hilo, y otros participantes añaden contexto, por lo que la discusión no se extiende a las herramientas de chat externas.
De la pregunta a la decisión
- Anchor la pregunta a una celda, texto seleccionado, un registro, un elemento o una posición de la página. El ancla retiene una referencia al contenido al que apunta.
- Discúpelo en un hilo consiste en un comentario y respuestas en la raíz, cada una con su autor, timetamp y texto de comentario.
- Resolver o reabrir el hilo después de hacer cambios. Reabrir un hilo cuando se requiere seguimiento; la discusión anterior permanece intacta.
El panel de comentarios filtra por todos, hilos no resueltos o resueltos, o por discusiones que involucran al usuario actual. Resolver un hilo no lo elimina; la decisión sigue disponible para su revisión.
Comentarios y anotaciones por producto
Las capturas de pantalla utilizan un solo proyecto de lanzamiento de Northstar en inglés. Fueron capturadas a través de Facade APIs en editores reales para mostrar comentarios y anotaciones de frontend. Haga clic en una imagen para ampliarla.
Sheets
Una discusión anclada a una sola célula permite a un revisor confirmar un pronóstico, un detalle de costes, o una aprobación directamente al lado del número de presupuesto. El ejemplo muestra varios hilos, una serie de respuestas consecutivas, y una sección resuelta. Los comentarios de células se agregan a través de range.addCommentAsync(); comentarios sobre imágenes, gráficos y formas requieren la integración correspondiente del compromiso de dibujo.
Integración y API del producto
Docs
Seleccione un rango de texto y agregue un comentario al revisar cláusulas contractuales, redacción de propuestas o fechas de lanzamiento. Las tarjetas de comentario conservan el texto citado, y las decoraciones de comentarios mantienen el ancla mientras el texto circundante cambia. El ejemplo analiza la fecha de liberación, definiciones métricas y la sustitución de un viejo flujo de trabajo. document.getTextRange(...).createCommentAsync().
Integración y API del producto
Slides
Los comentarios pueden apuntar un solo elemento o una posición libre en una diapositiva. Element comments reference IDs estables para cajas de texto, imágenes, gráficos y otros objetos; comentarios de posición utilizan coordenadas de página normalizadas. slide.createElementCommentAsync() y slide.createPositionCommentAsync().
Integración y API del producto
Relational Table
Comentarios IDs de referencia, por lo que una discusión sigue ligada a un registro de negocios en lugar de a su número de fila visible. Se utilizan para las entregas, seguimiento de clientes y exámenes de aceptación. El rastreador de lanzamiento muestra discusiones de propietarios, aprobaciones pendientes, y marcadores de comentarios al lado de los registros. record.createCommentAsync().
Integración y API del producto
Canvases
Un comentario se puede adjuntar a un elemento como una forma, o se deja como una nota en una posición específica de la junta. Los comentarios de elementos hacen referencia a un objeto; los comentarios de posición conservan las coordenadas de la tabla. board.createElementCommentAsync() y board.createPositionCommentAsync().
Integración y API del producto
PDF: anotaciones de página
PDF actualmente proporciona anotaciones de página: destacamentos, subrayos, huelgas, líneas de calabaza y tinta. Estos son objetos de anotación PDF persistentes, separados de los hilos anteriores que soportan las respuestas y la resolución. El ejemplo destaca una fecha de lanzamiento, marca los criterios de aceptación y cruza un viejo paso de aprobación. page.insertAnnotation().
Integración y API del producto
Integración
Frontend: registrar el comentario y los plugins de la interfaz de usuario del producto, e importar las entradas de comentarios compartidos y específicos del producto /facade. Los métodos específicos del producto establecen anclas, mientras que API compartidas como replyCommentAsync(), updateCommentAsync(), y resolveCommentAsync() manejan las operaciones de discusión que siguen. Pase resolved: false para reabrir un hilo. PDF utiliza una API de anotación separada.
Debates compartidos: añadir servicio de comentario, comentario Endpoint, y un adaptador de base independiente junto con la colaboración básica, luego configurar la fuente de datos de frontend remoto. El documento principal conserva anclas, que cambian con el contenido; Comentario Servicio almacena texto, respuestas y estado de resolución, y publica actualizaciones de comentarios a salas de documentos. Paquetes de comentarios y el Ejemplo de comentarios.
El permiso de comentario puede configurarse por separado del permiso para editar contenido. Para la identidad de la aplicación y la autorización del servidor, consulte permisos y autorizaciones.
¿Cómo es esta guía?