Salva presentazioni in Java

Di cosa tratta questa pagina

Salva presentazioni PowerPoint e OpenDocument in file o stream in Java con Aspose.Slides, e configura l’output PPTX e la segnalazione dei progressi.

Panoramica

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

Salva presentazioni su file

Per salvare una presentazione su un file, passa il percorso di destinazione 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 com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation();
try {
    // Aggiungi o modifica il contenuto della presentazione qui.

    presentation.save("Output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Salva presentazioni nel loro formato originale

Per esempi di rilevamento di file e stream, il comportamento delle presentazioni appena create e la distinzione tra formati di origine e di output, vedi Determina 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 IPresentation.getSourceFormat . Passa il valore SourceFormat risultante a SlideUtil.toSaveFormat per ottenere il corrispondente valore SaveFormat e quindi usa Presentation.save per scrivere la presentazione modificata.

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

import com.aspose.slides.Presentation;
import com.aspose.slides.SlideUtil;
import java.io.File;

File inputDirectory = new File("Input");
File outputDirectory = new File("Output");

if (!outputDirectory.exists() && !outputDirectory.mkdirs()) {
    System.err.println("Cannot create the output directory.");
}

File[] inputFiles = inputDirectory.listFiles(File::isFile);
if (inputFiles != null && outputDirectory.isDirectory()) {
    for (File inputFile : inputFiles) {
        try {
            Presentation presentation = new Presentation(inputFile.getPath());
            try {
                int saveFormat = SlideUtil.toSaveFormat(presentation.getSourceFormat());
                presentation.getDocumentProperties().setTitle("Processed by the batch application");

                File outputFile = new File(outputDirectory, inputFile.getName());
                presentation.save(outputFile.getPath(), saveFormat);
            } finally {
                presentation.dispose();
            }
        } catch (IllegalArgumentException exception) {
            System.err.println("Cannot map the source format of '" + inputFile.getPath() + "': " + exception.getMessage());
        } catch (Exception exception) {
            System.err.println("Cannot process '" + inputFile.getPath() + "': " + exception.getMessage());
        }
    }
}

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 di origine 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’eccezione IllegalArgumentException.

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

Salva presentazioni su stream

Per scrivere una presentazione senza fare affidamento su un percorso file finale, 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 uno stream di file:

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.io.FileOutputStream;
import java.io.OutputStream;

Presentation presentation = new Presentation();
try {
    OutputStream outputStream = new FileOutputStream("Output.pptx");
    try {
        presentation.save(outputStream, SaveFormat.Pptx);
    } finally {
        outputStream.close();
    }
} finally {
    presentation.dispose();
}

Salva presentazioni con un tipo di vista predefinito

È possibile specificare la vista 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 vista Slide Master come vista iniziale:

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ViewType;

Presentation presentation = new Presentation();
try {
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView);
    presentation.save("SlideMasterView.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Salva presentazioni nel formato Strict di 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 com.aspose.slides.Conformance;
import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

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

Presentation presentation = new Presentation();
try {
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Salva presentazioni nel 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 di conteggio delle voci.

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

[IfNecessary] utilizza ZIP64 solo quando la presentazione supera i limiti ZIP standard. 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 com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.Zip64Mode;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new PptxOptions();
    options.setZip64Mode(Zip64Mode.Always);

    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Warning

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

Salva presentazioni nel formato Office Open XML con livelli di compressione

Per l’output PPTX, è possibile bilanciare la velocità di salvataggio rispetto alle dimensioni del 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 dimensioni del 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 com.aspose.slides.CompressionLevel;
import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new 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 com.aspose.slides.CompressionLevel;
import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new PptxOptions();
    options.setCompressionLevel(CompressionLevel.Level9);

    presentation.save("OutputMaximumCompression.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Salva presentazioni senza aggiornare la miniatura

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

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

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

import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new 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.

Salva aggiornamenti di avanzamento in percentuale

Per monitorare un’operazione di salvataggio, implementa l’interfaccia IProgressCallback e passa l’implementazione al metodo ISaveOptions.setProgressCallback. Aspose.Slides chiama quindi il metodo IProgressCallback.reporting con i valori di avanzamento durante l’esportazione.

Il seguente esempio riporta l’avanzamento di un’esportazione PDF sulla console:

import com.aspose.slides.IProgressCallback;
import com.aspose.slides.PdfOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

class ExportProgressHandler implements IProgressCallback {
    public void reporting(double progressValue) {
        int progress = (int) progressValue;
        System.out.println(progress + "% of the file has been converted.");
    }
}

PdfOptions options = new PdfOptions();
options.setProgressCallback(new ExportProgressHandler());

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pdf", SaveFormat.Pdf, options);
} finally {
    presentation.dispose();
}

Note

Aspose fornisce un gratuito PowerPoint Splitter basato sull’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 invece di aggiornare solo le parti modificate.

È possibile che più thread salvino la stessa istanza di Presentation?

No. Una Presentation non è thread‑safe. Accedi e salva ciascuna istanza da un solo thread alla volta.

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

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

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

Sì. Imposta le appropriate proprietà del documento prima del salvataggio e Aspose.Slides le scrive nel file di output.

Converti presentazioni in più formati con Java Gestisci la presentazione in Java