Aprire presentazioni in Python via Java

Di cosa tratta questa pagina

Scopri come aprire presentazioni PowerPoint e OpenDocument in Python tramite Java, fornire password di apertura, controllare il caricamento delle risorse e ridurre l’uso della memoria con Aspose.Slides per Python tramite Java.

Introduzione

Aspose.Slides for Python via Java può caricare presentazioni PowerPoint e OpenDocument da file e stream. Dopo che una presentazione è stata caricata, è possibile ispezionarne la struttura, modificare le diapositive, gestire le risorse e salvarla nel formato originale o in un altro formato supportato.

Il comportamento di caricamento può essere personalizzato tramite la classe LoadOptions. Ad esempio, è possibile fornire una password di apertura, tenere i grandi oggetti binari al di fuori della heap di Java, controllare le risorse esterne o omettere i dati binari incorporati.

Aprire le presentazioni

Dopo aver caricato un file o uno stream, è possibile determinare il formato originale della presentazione per scegliere come la propria applicazione la elabora.

Per aprire una presentazione esistente, passare il percorso del file al costruttore Presentation. Rilasciare la presentazione dopo l’uso in modo che handle dei file, dati temporanei e altre risorse vengano rilasciati rapidamente.

Il seguente esempio Python mostra come aprire una presentazione e ottenere il conteggio delle diapositive:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("sample.pptx")
try:
    print("Slide count:", presentation.getSlides().size())
finally:
    presentation.dispose()

Aprire presentazioni protette da password

Una password di apertura cripta il contenuto della presentazione. Per caricare l’intera presentazione, passare la password corretta a LoadOptions.setPassword e fornire le opzioni al costruttore Presentation. Il caricamento fallisce quando la password è mancante o errata.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LoadOptions, Presentation

load_options = LoadOptions()
load_options.setPassword("open_password")

presentation = Presentation("encrypted-presentation.pptx", load_options)
try:
    print("Slide count:", presentation.getSlides().size())
finally:
    presentation.dispose()

Per i flussi di lavoro di rilevamento, convalida e crittografia delle password, vedere Password-Protect Presentations. Se una presentazione crittografata è stata deliberatamente salvata con proprietà del documento pubbliche, tali proprietà possono essere lette senza password; vedere Manage Presentation Properties.

Aprire presentazioni di grandi dimensioni

LoadOptions.getBlobManagementOptions restituisce opzioni che controllano come Aspose.Slides gestisce gli oggetti binari di grandi dimensioni come immagini, audio e video. È possibile mantenere il file di origine bloccato, consentire file temporanei e limitare la quantità di dati BLOB mantenuti in memoria.

Il seguente codice Python dimostra come caricare una presentazione di grandi dimensioni (ad esempio, 2 GB):

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LoadOptions, Presentation, PresentationLockingBehavior, SaveFormat

file_path = "large-presentation.pptx"

load_options = LoadOptions()
load_options.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked)
load_options.getBlobManagementOptions().setTemporaryFilesAllowed(True)
load_options.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024)

presentation = Presentation(file_path, load_options)
try:
    presentation.getSlides().get_Item(0).setName("Large presentation")
    presentation.save("large-presentation-copy.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Note

Con PresentationLockingBehavior.KeepLocked, il file di origine rimane bloccato finché l’istanza della presentazione non viene rilasciata. Non spostare, sovrascrivere o eliminare il file di origine mentre quell’istanza è attiva.

Aspose.Slides può copiare il contenuto di uno stream di input durante il caricamento. Per presentazioni di grandi dimensioni, un percorso di file è quindi generalmente più efficiente di uno stream. Vedere Manage BLOBs per ulteriori opzioni di archiviazione e gestione della memoria.

Controllare le risorse esterne

LoadOptions.setResourceLoadingCallback accetta un proxy JPype che implementa l’interfaccia di callback di caricamento delle risorse Java. Il callback può fornire dati di sostituzione, reindirizzare una risorsa, utilizzare il caricatore predefinito o saltare la risorsa. Questo è utile quando le presentazioni contengono immagini esterne che devono essere risolte secondo regole di sicurezza o di archiviazione specifiche dell’applicazione.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from pathlib import Path
from asposeslides.api import LoadOptions, Presentation, ResourceLoadingAction

class ImageLoadingHandler:
    def resourceLoading(self, resource_loading_arguments):
        is_jpeg = str(resource_loading_arguments.getOriginalUri()).lower().endswith(".jpg")
        approved_image_path = Path("approved-image.jpg")
        if not is_jpeg or not approved_image_path.exists():
            return ResourceLoadingAction.Skip

        try:
            image_data = approved_image_path.read_bytes()
            java_image_data = jpype.JArray(jpype.JByte)(image_data)
            resource_loading_arguments.setData(java_image_data)
            return ResourceLoadingAction.UserProvided
        except OSError:
            print("The approved replacement image could not be read.")
            return ResourceLoadingAction.Skip

load_options = LoadOptions()
image_loading_handler = ImageLoadingHandler()
callback = jpype.JProxy("com.aspose.slides.IResourceLoadingCallback", inst=image_loading_handler)
load_options.setResourceLoadingCallback(callback)

presentation = Presentation("presentation-with-external-images.pptx", load_options)
try:
    print("Slide count:", presentation.getSlides().size())
finally:
    presentation.dispose()

Caricare presentazioni senza oggetti binari incorporati

Una presentazione può contenere dati binari incorporati che un’applicazione non necessita o non desidera conservare. Esempi includono:

• Progetti VBA, disponibili tramite Presentation.getVbaProject;
• Dati OLE incorporati, disponibili tramite OleEmbeddedDataInfo.getEmbeddedFileData;
• Dati di controllo ActiveX, disponibili tramite Control.getActiveXControlBinary.

Impostare LoadOptions.setDeleteEmbeddedBinaryObjects su True per rimuovere questi dati binari durante il caricamento. Salvare la presentazione caricata per mantenere il risultato sanitizzato.

Questa opzione riduce l’esposizione a payload incorporati indesiderati, ma non è un sistema completo di rilevamento malware o di sanitizzazione dei contenuti.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LoadOptions, Presentation, SaveFormat

load_options = LoadOptions()
load_options.setDeleteEmbeddedBinaryObjects(True)

presentation = Presentation("presentation-with-embedded-data.pptx", load_options)
try:
    presentation.save("presentation-without-embedded-data.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

FAQ

Come posso capire se un file è danneggiato e non può essere aperto?

Aspose.Slides genera un’eccezione di parsing o di formato durante il caricamento. Gestire tale fallimento separatamente da un errore di password errata in modo che l’applicazione possa segnalare la causa in modo preciso.

Cosa succede se i font richiesti mancano?

La presentazione può comunque essere caricata, ma il rendering e l’esportazione potrebbero sostituire i font. È possibile configurare la sostituzione dei font o fornire font personalizzati per rendere l’output più prevedibile.

Il caricamento di una presentazione carica anche i media incorporati?

L’audio e il video incorporati diventano disponibili tramite il modello oggetto della presentazione. Le risorse esterne vengono risolte in base al comportamento di caricamento delle risorse configurato e potrebbero non essere disponibili se le loro posizioni non possono essere accessibili.