Gestionar OLE en presentaciones usando Python

Visión general

Info

OLE (Object Linking & Embedding) es una tecnología de Microsoft que permite que los datos y objetos creados en una aplicación sean vinculados o incrustados en otra.

Por ejemplo, un gráfico creado en Microsoft Excel y colocado en una diapositiva de PowerPoint es un objeto OLE.

Un objeto OLE puede aparecer como un icono. Al hacer doble clic en el icono se abre el objeto en su aplicación asociada (p. ej., Excel) o se le solicita que elija una aplicación para abrirlo o editarlo.
Un objeto OLE puede mostrar su contenido (por ejemplo, un gráfico). En este caso, PowerPoint activa el objeto incrustado, carga la interfaz del gráfico y le permite editar los datos del gráfico dentro de PowerPoint.

Aspose.Slides para Python le permite insertar objetos OLE en diapositivas como marcos de objetos OLE (OleObjectFrame).

Agregar objetos OLE a diapositivas

Si ya ha creado un gráfico en Microsoft Excel y desea incrustarlo en una diapositiva como un marco de objeto OLE usando Aspose.Slides para Python, siga estos pasos:

Cree una instancia de la clase Presentation.
Obtenga una referencia a la diapositiva por su índice.
Lea el archivo Excel en una matriz de bytes.
Agregue un OleObjectFrame a la diapositiva, proporcionando la matriz de bytes y otros detalles del objeto OLE.
Guarde la presentación modificada como archivo PPTX.

En el ejemplo a continuación, un gráfico de un archivo Excel se incrusta en una diapositiva como un OleObjectFrame.

Nota: El constructor OleEmbeddedDataInfo toma la extensión de archivo del objeto incrustable como su segundo parámetro. PowerPoint usa esta extensión para identificar el tipo de archivo y seleccionar la aplicación apropiada para abrir el objeto OLE.

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

    # Preparar los datos para el objeto OLE.
    with open("book.xlsx", "rb") as file_stream:
        file_data = file_stream.read()
        data_info = slides.dom.ole.OleEmbeddedDataInfo(file_data, "xlsx")

    # Añadir un marco de objeto OLE a la diapositiva.
    ole_frame = slide.shapes.add_ole_object_frame(0, 0, slide_size.width, slide_size.height, data_info)

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

Agregar objetos OLE vinculados

Aspose.Slides para Python le permite agregar un OleObjectFrame que enlaza a un archivo en lugar de incrustar sus datos.

El siguiente ejemplo en Python muestra cómo agregar un OleObjectFrame vinculado a un archivo Excel en una diapositiva:

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

    # Agregar un marco de objeto OLE con un archivo Excel vinculado.
    slide.shapes.add_ole_object_frame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx")

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

Acceder a objetos OLE

Si un objeto OLE ya está incrustado en una diapositiva, puede acceder a él de la siguiente manera:

Cargue la presentación que contiene el objeto OLE incrustado creando una instancia de la clase Presentation.
Obtenga una referencia a la diapositiva por su índice.
Acceda a la forma OleObjectFrame.
Una vez que tenga el marco del objeto OLE, realice las operaciones necesarias sobre él.

El ejemplo a continuación accede al marco del objeto OLE —un gráfico Excel incrustado— y recupera sus datos de archivo. En este ejemplo, usamos un PPTX que tiene una única forma en la primera diapositiva.

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.OleObjectFrame):
        ole_frame = shape

        # Obtener los datos del archivo incrustado.
        file_data = ole_frame.embedded_data.embedded_file_data

        # Obtener la extensión del archivo incrustado.
        file_extension = ole_frame.embedded_data.embedded_file_extension

        # ...

Acceder a propiedades de objeto OLE vinculado

Aspose.Slides le permite acceder a las propiedades de un marco de objeto OLE vinculado.

El siguiente ejemplo en Python verifica si un objeto OLE está vinculado y, si lo está, recupera la ruta al archivo vinculado:

with slides.Presentation("sample.ppt") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.OleObjectFrame):
        ole_frame = shape

        # Verificar si el objeto OLE está vinculado.
        if ole_frame.is_object_link:
            # Imprimir la ruta completa al archivo vinculado.
            print("OLE object frame is linked to:", ole_frame.link_path_long)

            # Imprimir la ruta relativa al archivo vinculado, si está presente.
            # Sólo las presentaciones .ppt pueden contener una ruta relativa.
            if ole_frame.link_path_relative:
                print("OLE object frame relative path:", ole_frame.link_path_relative)

Cambiar datos del objeto OLE

En esta sección, el ejemplo de código a continuación usa Aspose.Cells for Python via .NET.

Si un objeto OLE ya está incrustado en una diapositiva, puede acceder a él y modificar sus datos de la siguiente manera:

Cargue la presentación creando una instancia de la clase Presentation.
Obtenga la diapositiva objetivo por su índice.
Acceda a la forma OleObjectFrame.
Una vez que tenga el marco del objeto OLE, realice las operaciones requeridas sobre él.
Cree un objeto Workbook y lea los datos OLE.
Abra el Worksheet deseado y edite los datos.
Guarde el Workbook actualizado en un flujo.
Reemplace los datos del objeto OLE usando ese flujo.

En el ejemplo a continuación, se accede a un marco de objeto OLE (un gráfico Excel incrustado) y se modifican sus datos de archivo para actualizar el gráfico. La muestra usa un PPTX creado previamente que contiene una única forma en la primera diapositiva.

import io
import aspose.slides as slides
import aspose.cells as cells

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.OleObjectFrame):
        ole_frame = shape

        with io.BytesIO(ole_frame.embedded_data.embedded_file_data) as ole_stream:
            # Leer los datos del objeto OLE como un objeto Workbook.
            workbook = cells.Workbook(ole_stream)

        with io.BytesIO() as new_ole_stream:
            # Modificar los datos del libro de trabajo.
            workbook.worksheets.get(0).cells.get(0, 4).put_value("E")
            workbook.worksheets.get(0).cells.get(1, 4).put_value(12)
            workbook.worksheets.get(0).cells.get(2, 4).put_value(14)
            workbook.worksheets.get(0).cells.get(3, 4).put_value(15)

            file_options = cells.OoxmlSaveOptions(cells.SaveFormat.XLSX)
            workbook.save(new_ole_stream, file_options)

            # Cambiar los datos del objeto del marco OLE.
            new_data = slides.dom.ole.OleEmbeddedDataInfo(new_ole_stream.getvalue(), ole_frame.embedded_data.embedded_file_extension)
            ole_frame.set_embedded_data(new_data)

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

Incrustar archivos en diapositivas

Además de los gráficos Excel, Aspose.Slides para Python le permite incrustar otros tipos de archivo en diapositivas. Por ejemplo, puede insertar archivos HTML, PDF y ZIP como objetos. Cuando un usuario hace doble clic en un objeto insertado, se abre automáticamente en la aplicación asociada, o se le solicita al usuario que elija un programa apropiado.

Este código en Python muestra cómo incrustar archivos HTML y ZIP en una diapositiva:

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

    with open("sample.html", "rb") as html_stream:
        html_data = html_stream.read()

    html_data_info = slides.dom.ole.OleEmbeddedDataInfo(html_data, "html")
    html_ole_frame = slide.shapes.add_ole_object_frame(150, 120, 50, 50, html_data_info)
    html_ole_frame.is_object_icon = True

    with open("sample.zip", "rb") as zip_stream:
        zip_data = zip_stream.read()

    zip_data_info = slides.dom.ole.OleEmbeddedDataInfo(zip_data, "zip")
    zip_ole_frame = slide.shapes.add_ole_object_frame(150, 220, 50, 50, zip_data_info)
    zip_ole_frame.is_object_icon = True

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

Establecer tipos de archivo para objetos incrustados

Al trabajar con presentaciones, puede necesitar reemplazar objetos OLE antiguos por nuevos o intercambiar un objeto OLE no compatible por uno compatible. Aspose.Slides para Python le permite establecer el tipo de archivo de un objeto incrustado, lo que le permite actualizar los datos del marco OLE o su extensión de archivo.

Este código en Python muestra cómo establecer el tipo de archivo del objeto OLE incrustado a zip:

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    ole_frame = slide.shapes[0]

    file_extension = ole_frame.embedded_data.embedded_file_extension
    file_data = ole_frame.embedded_data.embedded_file_data

    print(f"Current embedded file extension is: {file_extension}")

    # Cambiar el tipo de archivo a ZIP.
    ole_frame.set_embedded_data(slides.dom.ole.OleEmbeddedDataInfo(file_data, "zip"))

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

Establecer imágenes de icono y títulos para objetos incrustados

Después de incrustar un objeto OLE, se agrega automáticamente una vista previa basada en un icono. Esta vista previa es lo que los usuarios ven antes de acceder o abrir el objeto OLE. Si desea usar una imagen y texto específicos en la vista previa, puede establecer la imagen del icono y el título usando Aspose.Slides para Python.

Este código en Python muestra cómo establecer la imagen del icono y el título para un objeto incrustado:

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    ole_frame = slide.shapes[0]

    # Agregar una imagen a los recursos de la presentación.
    with slides.Images.from_file("image.png") as image:
        ole_image = presentation.images.add_image(image)

    # Establecer un título y la imagen para la vista previa del OLE.
    ole_frame.substitute_picture_title = "My title"
    ole_frame.substitute_picture_format.picture.image = ole_image
    ole_frame.is_object_icon = True

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

Evitar que los marcos de objetos OLE se redimensionen y reposicionen

Después de agregar un objeto OLE vinculado a una diapositiva, PowerPoint puede solicitarle que actualice los enlaces al abrir la presentación. Seleccionar Actualizar enlaces puede cambiar el tamaño y la posición del marco del objeto OLE porque PowerPoint actualiza la vista previa con los datos del objeto vinculado. Para evitar que PowerPoint le solicite actualizar los datos del objeto, establezca la propiedad update_automatic de la clase OleObjectFrame en False:

ole_frame.update_automatic = False

Extraer archivos incrustados

Aspose.Slides para Python le permite extraer archivos incrustados en diapositivas como objetos OLE de la siguiente manera:

Cree una instancia de la clase Presentation que contiene los objetos OLE que desea extraer.
Itere a través de todas las formas en la presentación y localice las formas OLEObjectFrame.
Recupere los datos del archivo incrustado de cada OLEObjectFrame y escríbalos en el disco.

El siguiente código en Python muestra cómo extraer archivos incrustados en una diapositiva como objetos OLE:

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

    for index, shape in enumerate(slide.shapes):
        if isinstance(shape, slides.OleObjectFrame):
            ole_frame = shape

            file_data = ole_frame.embedded_data.embedded_file_data
            file_extension = ole_frame.embedded_data.embedded_file_extension

            file_path = f"OLE_object_{index}{file_extension}"
            with open(file_path, 'wb') as file_stream:
                file_stream.write(file_data)

FAQ

¿Se renderizará el contenido OLE al exportar diapositivas a PDF/imagenes?

Lo que es visible en la diapositiva se renderiza: el ícono/imagen sustituta (vista previa). El contenido OLE “en vivo” no se ejecuta durante el renderizado. Si es necesario, establezca su propia imagen de vista previa para garantizar la apariencia esperada en el PDF exportado.

¿Cómo puedo bloquear un objeto OLE en una diapositiva para que los usuarios no puedan moverlo/editarlo en PowerPoint?

Bloquee la forma: Aspose.Slides proporciona bloqueos a nivel de forma. No es encriptación, pero impide eficazmente ediciones y movimientos accidentales.

¿Por qué un objeto Excel vinculado “salta” o cambia de tamaño al abrir la presentación?

PowerPoint puede actualizar la vista previa del OLE vinculado. Para una apariencia estable, siga las prácticas de la Solución de trabajo para el redimensionamiento de hojas de cálculo: ajuste el marco al rango, o escale el rango a un marco fijo y establezca una imagen sustituta apropiada.

¿Se conservarán las rutas relativas para objetos OLE vinculados en el formato PPTX?

En PPTX, la información de “ruta relativa” no está disponible—solo la ruta completa. Las rutas relativas se encuentran en el formato PPT más antiguo. Para portabilidad, prefiera rutas absolutas fiables/URIs accesibles o la incrustación.

Gestionar Archivos Multimedia Gestionar Texto