Guardar presentaciones en Java

De qué trata esta página

Guarde presentaciones PowerPoint y OpenDocument en archivos o flujos en Java con Aspose.Slides, y configure la salida PPTX y el reporte de progreso.

Visión general

Después de crear una presentación o abrir una existente, use el método Presentation.save para escribir el resultado. Aspose.Slides for Java puede guardar una presentación en un archivo o flujo en PowerPoint, OpenDocument, PDF y otros formatos. Las siguientes secciones cubren las operaciones de guardado estándar y las opciones disponibles para la salida PPTX.

Guardar presentaciones en archivos

Para guardar una presentación en un archivo, pase la ruta de salida y un valor SaveFormat al método Presentation.save. El valor de formato determina el tipo de archivo que Aspose.Slides crea.

El siguiente ejemplo crea una presentación y la guarda como un archivo PPTX:

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

Presentation presentation = new Presentation();
try {
    // Agregar o modificar el contenido de la presentación aquí.

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

Guardar presentaciones en su formato original

Para ejemplos de detección de archivos y flujos, el comportamiento de presentaciones recién creadas y la distinción entre formatos de origen y de salida, consulte Determinar el formato original de la presentación.

En una aplicación de procesamiento por lotes, el formato de entrada puede no conocerse de antemano. Después de cargar un archivo, lea su formato original mediante el método IPresentation.getSourceFormat . Pase el valor resultante de SourceFormat a SlideUtil.toSaveFormat para obtener el valor correspondiente de SaveFormat, y luego use Presentation.save para escribir la presentación modificada.

El siguiente ejemplo completo procesa cada archivo en un directorio de entrada, actualiza su título y lo guarda en un directorio de salida en el formato del que se cargó:

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 asigna PPT, PPTX, ODP, PPTM, PPSX, PPSM, POTX, POTM, PPS, POT, OTP, FODP y PowerPoint XML a sus correspondientes formatos de guardado de presentación. Solo asigna formatos de origen de presentación; no está destinado a seleccionar formatos de exportación como PDF, HTML, TIFF o imágenes. Pasar un valor de SourceFormat no compatible o inválido produce una IllegalArgumentException.

Los archivos heredados PPT, PPS y POT utilizan el mismo contenedor binario. Cuando se carga una presentación de este tipo desde un flujo sin extensión de archivo, un archivo PPS o POT puede identificarse como PPT. Si es necesario conservar estos subtipos heredados, mantenga el nombre de archivo original o los metadatos de formato por separado y úselos al elegir el nombre y el formato del archivo de salida.

Guardar presentaciones en flujos

Para escribir una presentación sin depender de una ruta de archivo final, pase un flujo de escritura y un valor SaveFormat al método Presentation.save. Este enfoque es útil cuando la salida debe devolverse desde un servicio web, almacenarse en una base de datos o procesarse en memoria.

El siguiente ejemplo guarda una nueva presentación en un flujo de archivo:

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();
}

Guardar presentaciones con un tipo de vista predefinido

Puede especificar la vista en la que PowerPoint abre inicialmente una presentación guardada. Use el método ViewProperties.setLastView con un valor ViewType antes de guardar.

El siguiente ejemplo configura la vista Maestra de diapositivas como vista inicial:

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();
}

Guardar presentaciones en el formato Office Open XML estricto

Para crear un archivo PPTX que cumpla con el perfil Strict de Office Open XML, cree una instancia de PptxOptions y use su método setConformance con Conformance.Iso29500_2008_Strict. Luego pase las opciones al método 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();
}

Guardar presentaciones en formato Office Open XML en modo Zip64

Un archivo ZIP estándar limita el tamaño comprimido y descomprimido de cada entrada, el tamaño total del archivo y el número de entradas. Como un archivo PPTX es un archivo ZIP, una presentación muy grande puede superar esos límites. Las extensiones ZIP64 aumentan los límites de tamaño y de número de entradas aplicables.

Use el método PptxOptions.setZip64Mode para controlar si Aspose.Slides escribe extensiones ZIP64:

[IfNecessary] usa ZIP64 solo cuando la presentación supera los límites estándar de ZIP. Este es el modo predeterminado.
[Never] desactiva las extensiones ZIP64.
[Always] siempre escribe extensiones ZIP64.

El siguiente ejemplo siempre habilita las extensiones ZIP64 para la presentación de salida:

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();
}

Advertencia

Si se usa Zip64Mode.Never y la presentación no cabe dentro de los límites estándar de ZIP, la operación de guardado lanza una PptxException.

Guardar presentaciones en formato Office Open XML con niveles de compresión

Para la salida PPTX, puede equilibrar la velocidad de guardado con el tamaño del archivo usando el método PptxOptions.setCompressionLevel. La clase CompressionLevel proporciona los siguientes valores:

[None] almacena los datos sin compresión.
[Level1] ofrece la compresión más rápida y el archivo comprimido más grande.
[Level2] a [Level5] favorecen progresivamente una salida más pequeña sobre la velocidad de guardado.
[Level6] equilibra la velocidad de guardado y el tamaño del archivo. Este es el nivel predeterminado.
[Level7] y [Level8] favorecen aún más una salida más pequeña sobre la velocidad de guardado.
[Level9] ofrece la compresión más fuerte y requiere más tiempo de procesamiento.

El siguiente ejemplo guarda una presentación sin compresión:

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();
}

El siguiente ejemplo usa el nivel máximo de compresión:

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();
}

Guardar presentaciones sin actualizar la miniatura

Cuando una presentación se guarda como PPTX, el método PptxOptions.setRefreshThumbnail controla su miniatura del documento:

true regenera la miniatura durante la operación de guardado. Este es el valor predeterminado.
false conserva la miniatura existente. Si la presentación no tiene miniatura, Aspose.Slides no genera una.

El siguiente ejemplo guarda una presentación sin actualizar su 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();
}

Nota

Desactivar la actualización de la miniatura puede reducir el tiempo necesario para guardar un archivo PPTX.

Actualizar el progreso de guardado en porcentaje

Para supervisar una operación de guardado, implemente la interfaz IProgressCallback y pase la implementación al método ISaveOptions.setProgressCallback. Aspose.Slides entonces llama al método IProgressCallback.reporting con valores de progreso durante la exportación.

El siguiente ejemplo informa del progreso de una exportación a PDF en la consola:

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();
}

Nota

Aspose ofrece un PowerPoint Splitter gratuito construido con la API Aspose.Slides. Guarda diapositivas seleccionadas de una presentación como archivos PPT o PPTX separados.

Preguntas frecuentes

¿Aspose.Slides admite guardado incremental o “guardado rápido”?

No. Cada operación de guardado escribe un archivo de salida completo en lugar de actualizar solo las partes modificadas.

¿Pueden varios hilos guardar la misma instancia de Presentation?

No. Una instancia de Presentation no es segura para subprocesos. Acceda y guarde cada instancia solo desde un hilo a la vez.

¿Qué ocurre con los hipervínculos y los archivos vinculados externamente al guardar una presentación?

Los hipervínculos permanecen en la presentación. Aspose.Slides no copia los archivos vinculados externamente, por lo que la presentación guardada debe seguir pudiendo acceder a sus ubicaciones.

¿Puedo guardar metadatos del documento como el autor, título, empresa y fecha de creación?

Sí. Establezca las propiedades del documento apropiadas antes de guardar, y Aspose.Slides las escribe en el archivo de salida.

Convertir presentaciones a varios formatos en Java