Gestionar comentarios de presentación en Python

De qué trata esta página

Gestiona los comentarios de presentaciones con Aspose.Slides for Python via .NET: añade, lee, edita, responde y elimina comentarios en presentaciones de PowerPoint.

Descripción general

Este artículo explica cómo gestionar los comentarios de una presentación con Aspose.Slides for Python via .NET. Presenta los tipos principales relacionados con los comentarios y muestra cómo añadir comentarios a diapositivas, acceder a los comentarios existentes, trabajar con respuestas y comentarios modernos, y eliminar comentarios de una presentación.

Los ejemplos cubren escenarios comunes de revisión y colaboración en PowerPoint, como asignar comentarios a autores, leer el texto y los metadatos de los comentarios, crear cadenas de respuestas y eliminar comentarios seleccionados o todos los comentarios.

En PowerPoint, los comentarios aparecen como anotaciones en las diapositivas. Al seleccionar un comentario se muestra su texto y la discusión relacionada.

Para solicitar que los comentarios se muestren u oculten al abrir una presentación sin modificar los propios comentarios, vea Mostrar u ocultar comentarios al abrir una presentación.

¿Por qué añadir comentarios a las presentaciones?

Puede usar los comentarios para proporcionar retroalimentación y colaborar con colegas al revisar presentaciones.

Aspose.Slides for Python via .NET proporciona las siguientes API para trabajar con comentarios:

La clase Presentation que proporciona acceso a los autores de comentarios de la presentación.
La clase CommentCollection que representa los comentarios asociados a un autor concreto.
La clase Comment que proporciona información sobre un comentario, incluido su autor, fecha de creación, posición y texto.
La clase CommentAuthor que proporciona información sobre un autor, incluido su nombre, iniciales y comentarios asociados.

Añadir comentarios a diapositivas

El ejemplo crea dos diapositivas y registra un autor de comentarios con add_author. Utiliza add_comment para colocar un comentario en cada diapositiva, luego recupera los comentarios de la primera diapositiva para ese autor con get_slide_comments. La consola muestra el texto del primer comentario dos veces, demostrando el acceso tanto a través de la diapositiva como del autor, y la presentación guardada contiene ambos comentarios.

from datetime import datetime

import aspose.slides as slides

with slides.Presentation() as presentation:
    first_slide = presentation.slides[0]
    second_slide = presentation.slides.add_empty_slide(presentation.layout_slides[0])

    author = presentation.comment_authors.add_author("Jawad", "MF")
    position = slides.PointF(0.2, 0.2)
    created_time = datetime.now()

    author.comments.add_comment("Hello Jawad, this is a slide comment", first_slide, position, created_time)
    author.comments.add_comment("Hello Jawad, this is the second slide comment", second_slide, position, created_time)

    comments = first_slide.get_slide_comments(author)
    if len(comments) > 0:
        first_comment = comments[0]
        print(first_comment.text)

        comment_text = first_comment.author.comments[0].text
        print(comment_text)

    presentation.save("Comments_out.pptx", slides.export.SaveFormat.PPTX)

Buscar o crear un autor de comentarios

Cuando una revisión automatizada procesa la misma presentación repetidamente, busque en su colección comment_authors antes de añadir un autor. find_by_name_and_initials coincide tanto con el nombre como con las iniciales y devuelve una matriz de autores coincidentes, o una matriz vacía si no hay coincidencias. En contraste, find_by_name busca solo por nombre, sin importar las iniciales. Llamar a add_author con un nombre e iniciales ya presentes en la colección lanza una excepción.

El ejemplo requiere un archivo de presentación con al menos una diapositiva. En cada una de dos pasadas, reutiliza el primer autor coincidente, o crea uno solo cuando el resultado está vacío. Si hay varias coincidencias, selecciona el primer elemento de la matriz sin fusionar ni eliminar los demás autores. A continuación llama a add_comment para el autor seleccionado y guarda la presentación. La segunda pasada abre la salida de la primera pasada y repite la operación.

from datetime import datetime

import aspose.slides as slides

author_name = "Reviewer"
author_initials = "RV"

input_file = "input.pptx"
position = slides.PointF(20, 20)

for pass_number in range(1, 3):
    with slides.Presentation(input_file) as presentation:
        matches = presentation.comment_authors.find_by_name_and_initials(author_name, author_initials)

        author = matches[0] if len(matches) > 0 else presentation.comment_authors.add_author(author_name, author_initials)
        author.comments.add_comment("Please review this slide.", presentation.slides[0], position, datetime.now())

        output_file = f"review_pass_{pass_number}.pptx"
        presentation.save(output_file, slides.export.SaveFormat.PPTX)
        input_file = output_file

La segunda pasada añade otro comentario sin añadir otro autor ni eliminar los comentarios existentes. El archivo final, review_pass_2.pptx, contiene ambos comentarios nuevos junto a cualquier comentario original. Reutilizar un autor no deduplica los comentarios: para evitar añadir repetidamente el mismo comentario, implemente una detección de duplicados independiente antes de añadirlo.

Acceder a los comentarios de la diapositiva

El ejemplo abre una presentación existente y lee su colección comment_authors. Para cada autor, itera a través de comments e imprime el número de diapositiva, el texto del comentario, el nombre del autor y la hora de creación. La presentación de entrada debe contener comentarios para producir salida en la consola.

import aspose.slides as slides

with slides.Presentation("Comments1.pptx") as presentation:
    for author in presentation.comment_authors:
        for comment in author.comments:
            print("Slide: " + str(comment.slide.slide_number))
            print("Comment: " + comment.text)
            print("Author: " + comment.author.name)
            print("Posted at: " + str(comment.created_time))
            print()

Responder a los comentarios

Un comentario principal es el comentario original en la parte superior de una jerarquía de respuestas. La propiedad parent_comment de la clase Comment le permite obtener o establecer el comentario padre.

El ejemplo crea comentarios de dos autores y utiliza parent_comment para construir respuestas, incluida una respuesta a otra respuesta. Pasar None a get_slide_comments recupera los comentarios de todos los autores; la consola sangra cada entrada de acuerdo con su profundidad en la jerarquía de respuestas. El ejemplo guarda la discusión completa, llama a remove sobre el primer comentario raíz y guarda una segunda presentación con ese comentario y sus respuestas eliminados.

from datetime import datetime

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    position = slides.PointF(10, 10)
    created_time = datetime.now()

    original_author = presentation.comment_authors.add_author("Author_1", "A.A.")
    root_comment = original_author.comments.add_comment("comment 1", slide, position, created_time)

    reviewer = presentation.comment_authors.add_author("Author_2", "B.B.")
    first_reply = reviewer.comments.add_comment("reply 1 for comment 1", slide, position, created_time)
    first_reply.parent_comment = root_comment

    second_reply = reviewer.comments.add_comment("reply 2 for comment 1", slide, position, created_time)
    second_reply.parent_comment = root_comment

    sub_reply = original_author.comments.add_comment("subreply 3 for reply 2", slide, position, created_time)
    sub_reply.parent_comment = second_reply

    reviewer.comments.add_comment("comment 2", slide, position, created_time)
    separate_comment = reviewer.comments.add_comment("comment 3", slide, position, created_time)

    separate_reply = original_author.comments.add_comment("reply 4 for comment 3", slide, position, created_time)
    separate_reply.parent_comment = separate_comment

    comments = slide.get_slide_comments(None)
    for current_comment in comments:
        comment = current_comment
        while comment.parent_comment is not None:
            print("\t", end="")
            comment = comment.parent_comment

        print(current_comment.author.name + ": " + current_comment.text)

    presentation.save("parent_comment.pptx", slides.export.SaveFormat.PPTX)

    root_comment.remove()
    presentation.save("remove_comment.pptx", slides.export.SaveFormat.PPTX)

Warning

Cuando se usa el método eliminar de la clase Comment para borrar un comentario, también se eliminan todas las respuestas a ese comentario.
Si la propiedad parent_comment crea una referencia circular, se lanza una PptxEditException.

Añadir comentarios modernos

Los comentarios modernos pueden asociarse a la propia diapositiva, a una forma concreta o a un rango de texto dentro de una AutoShape. El método CommentCollection.add_modern_comment acepta un argumento Shape además de la diapositiva y las coordenadas del marcador del comentario.

Cuando se pasa None para el argumento de forma, el comentario es un comentario a nivel de diapositiva. Su marcador se posiciona mediante las coordenadas suministradas, pero no está asociado a una forma concreta, por lo que ModernComment.shape devuelve None. Cuando se proporciona una Shape, el comentario se ancla a esa forma. Las coordenadas siguen definiendo la posición del marcador del comentario en la diapositiva, mientras que la asociación con la forma puede recuperarse a través de ModernComment.shape.

Anclar un comentario moderno a una forma

El ejemplo llama a add_modern_comment dos veces: una vez con una forma None para un comentario a nivel de diapositiva y una vez con un rectángulo como ancla. Leer shape imprime True para la comprobación nula del comentario a nivel de diapositiva y Revenue title para el comentario anclado. Ambos comentarios se guardan con la presentación.

from datetime import datetime

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    author = presentation.comment_authors.add_author("Reviewer", "RV")

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 300, 80)
    shape.name = "Revenue title"
    shape.text_frame.text = "Quarterly revenue"

    created_time = datetime.now()
    slide_comment_position = slides.PointF(20, 20)
    shape_comment_position = slides.PointF(60, 60)
    slide_comment = author.comments.add_modern_comment("Review the overall slide layout.", slide, None, slide_comment_position, created_time)
    shape_comment = author.comments.add_modern_comment("Check this title.", slide, shape, shape_comment_position, created_time)

    print(slide_comment.shape is None)
    print(shape_comment.shape.name)

    presentation.save("modern_comments.pptx", slides.export.SaveFormat.PPTX)

Anclar comentarios a diferentes tipos de forma

Cualquier objeto de diapositiva derivado de Shape puede usarse como ancla de forma. Los ejemplos comunes incluyen AutoShape, PictureFrame, GroupShape, Connector y GraphicalObject como gráficos.

El ejemplo usa add_modern_comment para asociar un comentario a cada uno de cinco tipos de forma: una AutoShape, un marco de imagen, un grupo, un conector y un gráfico. La imagen se inserta mediante datos de imagen incrustados, por lo que no se necesita una imagen externa. Cada comentario tiene su propia posición de marcador, y la presentación guardada conserva las cinco asociaciones de forma.

import base64
from datetime import datetime

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    author = presentation.comment_authors.add_author("Reviewer", "RV")
    created_time = datetime.now()

    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 180, 60)
    auto_shape.text_frame.text = "AutoShape"

    auto_shape_comment_position = slides.PointF(30, 30)
    author.comments.add_modern_comment("Comment on an AutoShape.", slide, auto_shape, auto_shape_comment_position, created_time)

    image_base64 = "iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVR4nGP8//8/AwMDEwMDAwMDAwAkBgMB/DXemwAAAABJRU5ErkJggg=="
    image_data = base64.b64decode(image_base64)
    image = presentation.images.add_image(image_data)
    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 220, 20, 120, 80, image)
    picture_comment_position = slides.PointF(230, 30)
    author.comments.add_modern_comment("Comment on a picture.", slide, picture_frame, picture_comment_position, created_time)

    group_shape = slide.shapes.add_group_shape()
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 0, 0, 80, 40)
    group_shape.shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 100, 0, 80, 40)
    group_comment_position = slides.PointF(40, 150)
    author.comments.add_modern_comment("Comment on a group.", slide, group_shape, group_comment_position, created_time)

    connector = slide.shapes.add_connector(slides.ShapeType.STRAIGHT_CONNECTOR1, 220, 150, 140, 40)
    connector_comment_position = slides.PointF(240, 150)
    author.comments.add_modern_comment("Comment on a connector.", slide, connector, connector_comment_position, created_time)

    chart = slide.shapes.add_chart(slides.charts.ChartType.CLUSTERED_COLUMN, 400, 20, 250, 180)
    chart_comment_position = slides.PointF(420, 40)
    author.comments.add_modern_comment("Comment on a graphical object.", slide, chart, chart_comment_position, created_time)

    presentation.save("modern_comment_shape_types.pptx", slides.export.SaveFormat.PPTX)

Anclar un comentario a texto y establecer su estado

Para un comentario moderno asociado a una AutoShape, ModernComment.text_selection_start especifica la posición inicial del texto seleccionado en el marco de texto de la forma, mientras que ModernComment.text_selection_length indica la longitud de la selección. Juntas, estas propiedades asocian el comentario a un rango de texto concreto dentro de la AutoShape.

La propiedad ModernComment.status puede leerse o actualizarse con un valor de la enumeración ModernCommentStatus:

NOT_DEFINED — no se ha definido un estado específico para el comentario moderno.
ACTIVE — el comentario está activo.
RESOLVED — el comentario se ha resuelto.
CLOSED — el comentario está cerrado.

El ejemplo ancla un comentario moderno a las palabras “quarterly revenue” en el texto de un rectángulo. Calcula el text_selection_start basado en cero a partir del texto y establece text_selection_length al número de caracteres seleccionados. Después de establecer status a RESOLVED, guarda y vuelve a abrir la presentación. Las cuatro comprobaciones en la consola deben imprimir True, confirmando que el ancla de forma, el rango de texto y el estado se han conservado.

from datetime import datetime

import aspose.slides as slides

output_file = "modern_comment_text_anchor.pptx"
shape_text = "Review the quarterly revenue forecast."
selected_text = "quarterly revenue"
expected_selection_start = shape_text.index(selected_text)

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 400, 100)
    shape.name = "Forecast text"
    shape.text_frame.text = shape_text

    author = presentation.comment_authors.add_author("Reviewer", "RV")
    comment_position = slides.PointF(60, 60)
    comment = author.comments.add_modern_comment("Verify this forecast wording.", slide, shape, comment_position, datetime.now())
    comment.text_selection_start = expected_selection_start
    comment.text_selection_length = len(selected_text)
    comment.status = slides.ModernCommentStatus.RESOLVED

    presentation.save(output_file, slides.export.SaveFormat.PPTX)

with slides.Presentation(output_file) as reopened_presentation:
    reopened_slide = reopened_presentation.slides[0]
    reopened_comments = reopened_slide.get_slide_comments(None)

    for reopened_comment in reopened_comments:
        if not isinstance(reopened_comment, slides.ModernComment):
            continue

        shape_matches = reopened_comment.shape.name == "Forecast text"
        selection_start_matches = reopened_comment.text_selection_start == expected_selection_start
        selection_length_matches = reopened_comment.text_selection_length == len(selected_text)
        status_matches = reopened_comment.status == slides.ModernCommentStatus.RESOLVED

        print("Shape anchor preserved: " + str(shape_matches))
        print("Text selection start preserved: " + str(selection_start_matches))
        print("Text selection length preserved: " + str(selection_length_matches))
        print("Resolved status preserved: " + str(status_matches))

Inspeccionar comentarios modernos existentes

El ejemplo requiere una presentación existente que contenga comentarios modernos e imprime su texto, estado y detalles del ancla. Para inspeccionarla, compruebe qué comentarios son instancias de ModernComment, luego examine ModernComment.shape, ModernComment.text_selection_start, ModernComment.text_selection_length y ModernComment.status. Una forma None indica un comentario a nivel de diapositiva. Para un ancla de AutoShape, las propiedades de selección de texto identifican el rango asociado en el marco de texto de la forma.

import aspose.slides as slides

with slides.Presentation("comments.pptx") as presentation:
    for slide in presentation.slides:
        comments = slide.get_slide_comments(None)
        for comment in comments:
            if not isinstance(comment, slides.ModernComment):
                continue

            print("Slide: " + str(slide.slide_number))
            print("Text: " + comment.text)
            print("Status: " + str(comment.status))

            shape = comment.shape
            if shape is None:
                print("Anchor: slide level")
            else:
                print("Anchor shape: " + shape.name)
                print("Anchor type: " + type(shape).__name__)

                if isinstance(shape, slides.AutoShape):
                    print("Text selection start: " + str(comment.text_selection_start))
                    print("Text selection length: " + str(comment.text_selection_length))

            print()

Eliminar comentarios

Aspose.Slides for Python via .NET le permite eliminar todos los comentarios y sus autores de una presentación o borrar comentarios seleccionados mientras mantiene el resto. Los ejemplos siguientes demuestran ambas enfoques y guardan la presentación actualizada.

Eliminar todos los comentarios y autores de comentarios

El ejemplo abre una presentación existente y llama a CommentCollection.clear para cada autor, luego llama a CommentAuthorCollection.clear para eliminar a los propios autores. La presentación guardada no contiene ni comentarios ni autores de comentarios. Use una presentación que contenga comentarios para observar la eliminación.

import aspose.slides as slides

with slides.Presentation("example.pptx") as presentation:
    for author in presentation.comment_authors:
        author.comments.clear()

    presentation.comment_authors.clear()

    presentation.save("example_out.pptx", slides.export.SaveFormat.PPTX)

Eliminar comentarios específicos

El ejemplo crea dos comentarios en una diapositiva y usa get_slide_comments para encontrar los comentarios de cada autor. Recoge los comentarios cuyo texto es igual a “comment 1” antes de llamar a CommentCollection.remove, evitando cambios en la colección durante la selección. La presentación guardada conserva solo “comment 2”.

from datetime import datetime

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    author = presentation.comment_authors.add_author("Author", "A")
    created_time = datetime.now()

    first_comment_position = slides.PointF(0.2, 0.2)
    second_comment_position = slides.PointF(0.3, 0.2)
    author.comments.add_comment("comment 1", slide, first_comment_position, created_time)
    author.comments.add_comment("comment 2", slide, second_comment_position, created_time)

    for comment_author in presentation.comment_authors:
        comments_to_remove = []
        comments = slide.get_slide_comments(comment_author)

        for comment in comments:
            if comment.text == "comment 1":
                comments_to_remove.append(comment)

        for comment in comments_to_remove:
            comment_author.comments.remove(comment)

    presentation.save("pres.pptx", slides.export.SaveFormat.PPTX)

Preguntas frecuentes

¿Aspose.Slides admite un estado resuelto para los comentarios modernos?

Sí. ModernComment.status puede leerse y establecerse con un valor de la enumeración ModernCommentStatus, incluido RESOLVED. El estado se almacena en la presentación y puede leerse nuevamente después de volver a abrir el archivo.

¿Se admiten discusiones en hilo (cadenas de respuestas) y existe un límite de anidamiento?

Sí. Cada comentario puede referenciar su parent comment, lo que permite cadenas de respuestas. La API no define un límite específico de profundidad de anidamiento.

¿En qué sistema de coordenadas se define la posición del marcador de un comentario en una diapositiva?

La posición del marcador se define mediante coordenadas de punto flotante en el sistema de coordenadas de la diapositiva, lo que permite colocarla con precisión en la diapositiva.

Recuperar y actualizar propiedades de vista de la presentación en Python Gestionar notas de la presentación en Python