Salva presentazioni in Python via Java

Di cosa tratta questa pagina

Salva presentazioni PowerPoint e OpenDocument su file o stream in Python via Java con Aspose.Slides, e configura l’output PPTX e la segnalazione di avanzamento.

Panoramica

Dopo aver creato una presentazione o aperto una esistente, usa il metodo Presentation.save per scrivere il risultato. Aspose.Slides per Python via Java può salvare una presentazione in un file o stream in PowerPoint, OpenDocument, PDF e altri formati. Le sezioni seguenti coprono le operazioni di salvataggio standard e le opzioni disponibili per l’output PPTX.

Salvare le presentazioni su file

Per salvare una presentazione su un file, passa il percorso di output e un valore SaveFormat al metodo Presentation.save. Il valore del formato determina il tipo di file che Aspose.Slides crea.

Il seguente esempio crea una presentazione e la salva come file PPTX:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    # Aggiungi o modifica il contenuto della presentazione qui.

    presentation.save("Output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Salvare le presentazioni nel loro formato originale

Per esempi di rilevamento file e stream, il comportamento delle presentazioni appena create e la distinzione tra formati di origine e di destinazione, vedere Determinare il formato originale della presentazione.

In un’applicazione di elaborazione batch, il formato di input potrebbe non essere noto in anticipo. Dopo aver caricato un file, leggi il suo formato originale dal metodo Presentation.getSourceFormat. Passa il valore risultante SourceFormat a SlideUtil.toSaveFormat per ottenere il corrispondente valore SaveFormat, quindi usa Presentation.save per scrivere la presentazione modificata.

Il seguente esempio completo elabora ogni file in una directory di input, aggiorna il suo titolo e lo salva in una directory di output nel formato da cui è stato caricato:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SlideUtil
from pathlib import Path

IllegalArgumentException = jpype.JClass("java.lang.IllegalArgumentException")
input_directory = Path("Input")
output_directory = Path("Output")

try:
    output_directory.mkdir(parents=True, exist_ok=True)
except OSError:
    print("Cannot create the output directory.")

if input_directory.is_dir() and output_directory.is_dir():
    for input_file in input_directory.iterdir():
        if input_file.is_file():
            try:
                presentation = Presentation(str(input_file))
                try:
                    save_format = SlideUtil.toSaveFormat(presentation.getSourceFormat())
                    presentation.getDocumentProperties().setTitle("Processed by the batch application")

                    output_file = output_directory / input_file.name
                    presentation.save(str(output_file), save_format)
                finally:
                    presentation.dispose()
            except IllegalArgumentException as exception:
                print(f"Cannot map the source format of '{input_file}': {exception}")
            except Exception as exception:
                print(f"Cannot process '{input_file}': {exception}")

SlideUtil.toSaveFormat mappa PPT, PPTX, ODP, PPTM, PPSX, PPSM, POTX, POTM, PPS, POT, OTP, FODP e PowerPoint XML ai rispettivi formati di salvataggio della presentazione. Mappa solo i formati sorgente della presentazione; non è destinato a selezionare formati di esportazione come PDF, HTML, TIFF o immagini. Passare un valore SourceFormat non supportato o non valido genera un IllegalArgumentException.

I file legacy PPT, PPS e POT utilizzano lo stesso contenitore binario. Quando una presentazione di questo tipo è caricata da uno stream senza estensione, un file PPS o POT può quindi essere identificato come PPT. Se è necessario conservare questi sottotipi legacy, mantieni separatamente il nome file originale o i metadati del formato e usali quando scegli il nome file e il formato di output.

Salvare le presentazioni su stream

Per scrivere una presentazione senza fare affidamento su un percorso file definitivo, passa uno stream scrivibile e un valore SaveFormat al metodo Presentation.save. Questo approccio è utile quando l’output deve essere restituito da un servizio web, memorizzato in un database o elaborato in memoria.

Il seguente esempio salva una nuova presentazione su un flusso file:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

FileOutputStream = jpype.JClass("java.io.FileOutputStream")

presentation = Presentation()
try:
    output_stream = FileOutputStream("Output.pptx")
    try:
        presentation.save(output_stream, SaveFormat.Pptx)
    finally:
        output_stream.close()
finally:
    presentation.dispose()

Salvare le presentazioni con un tipo di visualizzazione predefinito

Puoi specificare la visualizzazione con cui PowerPoint apre inizialmente una presentazione salvata. Usa il metodo ViewProperties.setLastView con un valore ViewType prima del salvataggio.

Il seguente esempio configura la visualizzazione Slide Master come visualizzazione iniziale:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, ViewType

presentation = Presentation()
try:
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView)
    presentation.save("SlideMasterView.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Salvare le presentazioni nel formato Strict Office Open XML

Per creare un file PPTX conforme al profilo Strict di Office Open XML, crea un’istanza PptxOptions e usa il suo metodo setConformance con Conformance.Iso29500_2008_Strict. Quindi passa le opzioni al metodo Presentation.save.

import jpype
import asposeslides

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

from asposeslides.api import Conformance, PptxOptions, Presentation, SaveFormat

options = PptxOptions()
options.setConformance(Conformance.Iso29500_2008_Strict)

presentation = Presentation()
try:
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Salvare le presentazioni in formato Office Open XML in modalità Zip64

Un archivio ZIP standard limita la dimensione compressa e non compressa di ogni voce, la dimensione totale dell’archivio e il numero di voci. Poiché un file PPTX è un archivio ZIP, una presentazione molto grande può superare tali limiti. Le estensioni ZIP64 aumentano i limiti di dimensione e conteggio delle voci.

Usa il metodo PptxOptions.setZip64Mode per controllare se Aspose.Slides scrive le estensioni ZIP64:

IfNecessary usa ZIP64 solo quando la presentazione supera i limiti standard ZIP. Questa è la modalità predefinita.
Never disabilita le estensioni ZIP64.
Always scrive sempre le estensioni ZIP64.

Il seguente esempio abilita sempre le estensioni ZIP64 per la presentazione di output:

import jpype
import asposeslides

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

from asposeslides.api import PptxOptions, Presentation, SaveFormat, Zip64Mode

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setZip64Mode(Zip64Mode.Always)

    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Warning

Se Zip64Mode.Never viene utilizzato e la presentazione non può rientrare nei limiti standard ZIP, l’operazione di salvataggio genera un PptxException.

Salvare le presentazioni in formato Office Open XML con livelli di compressione

Per l’output PPTX, puoi bilanciare velocità di salvataggio e dimensione file usando il metodo PptxOptions.setCompressionLevel. La classe CompressionLevel fornisce questi valori:

None memorizza i dati senza compressione.
Level1 fornisce la compressione più veloce e l’output compresso più grande.
Level2 fino a Level5 favoriscono progressivamente un output più piccolo rispetto alla velocità di salvataggio.
Level6 bilancia velocità di salvataggio e dimensione file. Questo è il livello predefinito.
Level7 e Level8 favoriscono ulteriormente un output più piccolo rispetto alla velocità di salvataggio.
Level9 fornisce la compressione più forte e richiede più tempo di elaborazione.

Il seguente esempio salva una presentazione senza compressione:

import jpype
import asposeslides

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

from asposeslides.api import CompressionLevel, PptxOptions, Presentation, SaveFormat

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setCompressionLevel(CompressionLevel.None_)

    presentation.save("OutputNoCompression.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Il seguente esempio utilizza il livello di compressione massimo:

import jpype
import asposeslides

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

from asposeslides.api import CompressionLevel, PptxOptions, Presentation, SaveFormat

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setCompressionLevel(CompressionLevel.Level9)

    presentation.save("OutputMaximumCompression.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Salvare le presentazioni senza aggiornare la miniatura

Quando una presentazione viene salvata come PPTX, il metodo PptxOptions.setRefreshThumbnail controlla la sua miniatura del documento:

True rigenera la miniatura durante l’operazione di salvataggio. Questo è il valore predefinito.
False preserva la miniatura esistente. Se la presentazione non ha miniatura, Aspose.Slides non ne genera una.

Il seguente esempio salva una presentazione senza aggiornare la sua miniatura:

import jpype
import asposeslides

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

from asposeslides.api import PptxOptions, Presentation, SaveFormat

presentation = Presentation("Sample.pptx")
try:
    options = PptxOptions()
    options.setRefreshThumbnail(False)

    presentation.save("Output.pptx", SaveFormat.Pptx, options)
finally:
    presentation.dispose()

Note

Disabilitare l’aggiornamento della miniatura può ridurre il tempo necessario per salvare un file PPTX.

Segnalare l’avanzamento del salvataggio in percentuale

Per monitorare un’operazione di salvataggio, registra un handler di progresso Python tramite jpype.JProxy e passalo al metodo SaveOptions.setProgressCallback. Aspose.Slides quindi chiama il metodo reporting dell’handler con i valori di avanzamento durante l’esportazione.

Il seguente esempio segnala l’avanzamento di un’esportazione PDF nella console:

import jpype
import asposeslides

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

from asposeslides.api import PdfOptions, Presentation, SaveFormat


class ExportProgressHandler:
    def reporting(self, progress_value):
        progress = int(progress_value)
        print(f"{progress}% of the file has been converted.")


handler = ExportProgressHandler()
callback = jpype.JProxy("com.aspose.slides.IProgressCallback", inst=handler)
options = PdfOptions()
options.setProgressCallback(callback)

presentation = Presentation("Sample.pptx")
try:
    presentation.save("Output.pdf", SaveFormat.Pdf, options)
finally:
    presentation.dispose()

Note

Aspose fornisce un PowerPoint Splitter gratuito costruito con l’API Aspose.Slides. Salva le diapositive selezionate da una presentazione come file PPT o PPTX separati.

FAQ

Aspose.Slides supporta il salvataggio incrementale o “fast save”?

No. Ogni operazione di salvataggio scrive un file di output completo anziché aggiornare solo le parti modificate.

Più thread possono salvare la stessa istanza di Presentation?

No. Un’istanza di Presentation non è thread-safe. Accedi e salva ogni istanza da un solo thread alla volta.

Cosa succede ai collegamenti ipertestuali e ai file collegati esternamente quando salvo una presentazione?

Hyperlinks rimangono nella presentazione. Aspose.Slides non copia i file collegati esternamente, quindi la presentazione salvata deve comunque poter accedere alle loro posizioni.

Posso salvare i metadati del documento come autore, titolo, azienda e data di creazione?

Sì. Imposta le document properties appropriate prima del salvataggio, e Aspose.Slides le scrive nel file di output.

Converti presentazioni in più formati con Python Gestire le presentazioni in Python tramite Java