Recuperar y actualizar la información de la presentación en Java

De qué trata esta página

Explora diapositivas, estructuras y metadatos en presentaciones PowerPoint y OpenDocument utilizando Java para obtener conocimientos más rápidos y auditorías de contenido más inteligentes.

Visión general

Aspose.Slides puede identificar el formato de una presentación y leer sus metadatos de documento sin crear un modelo de objeto de presentación completo. Esto es útil cuando necesitas clasificar archivos, crear un inventario o inspeccionar propiedades antes de decidir si cargar y procesar el contenido de la presentación.

Este artículo muestra la inspección ligera mediante PresentationFactory y IPresentationInfo, así como actualizaciones específicas mediante IDocumentProperties.

Comprobar el formato de una presentación

Si ya tienes una presentación cargada, consulta Determine the Original Presentation Format para la detección después de cargar y las limitaciones de los flujos heredados PPT, PPS y POT.

Utiliza PresentationFactory.getPresentationInfo para inspeccionar un archivo sin crear una instancia de Presentation. El método IPresentationInfo.getLoadFormat informa del formato detectado, como PPTX, PPT u ODP.

import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;

String[] fileNames = { "pres.pptx", "pres.ppt", "pres.odp" };

for (String fileName : fileNames) {
    IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(fileName);
    int loadFormat = presentationInfo.getLoadFormat();
    String formatName = "Other (" + loadFormat + ")";

    if (loadFormat == LoadFormat.Pptx) {
        formatName = "PPTX";
    } else if (loadFormat == LoadFormat.Ppt) {
        formatName = "PPT";
    } else if (loadFormat == LoadFormat.Odp) {
        formatName = "ODP";
    }

    System.out.println(fileName + ": " + formatName);
}

Crear un inventario ligero de presentaciones

Cuando procesas muchos archivos de presentación, puede que necesites un inventario compacto para validación, indexación o un sistema de gestión documental. En este escenario, usa PresentationFactory.getPresentationInfo para obtener un objeto IPresentationInfo y, a continuación, llama a IPresentationInfo.readDocumentProperties para leer los metadatos del documento. Este enfoque no crea una instancia de Presentation ni requiere recorrer todo el modelo de objeto de la presentación.

Las propiedades extendidas expuestas por IDocumentProperties proporcionan los siguientes valores de inventario:

Método	Valor del inventario
getSlides	Número total de diapositivas.
getHiddenSlides	Número de diapositivas ocultas.
getNotes	Número de diapositivas que contienen notas.
getParagraphs	Número total de párrafos, cuando están disponibles.
getWords	Número total de palabras.
getMultimediaClips	Número total de clips de audio y vídeo.

El siguiente ejemplo lee estos valores sin crear un objeto Presentation e imprime un inventario compacto. También combina getHeadingPairs con getTitlesOfParts para mostrar grupos de contenido como fuentes, temas y títulos de diapositivas.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IHeadingPair;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;
import java.nio.file.Paths;

String filePath = "sample.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(filePath);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

int loadFormat = presentationInfo.getLoadFormat();
String formatName = "Other (" + loadFormat + ")";

if (loadFormat == LoadFormat.Pptx) {
    formatName = "PPTX";
} else if (loadFormat == LoadFormat.Ppt) {
    formatName = "PPT";
} else if (loadFormat == LoadFormat.Odp) {
    formatName = "ODP";
}

System.out.println("File: " + Paths.get(filePath).getFileName());
System.out.println("Format: " + formatName);
System.out.println("Title: " + documentProperties.getTitle());
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Statistics:");
System.out.println("  Slides: " + documentProperties.getSlides());
System.out.println("  Hidden slides: " + documentProperties.getHiddenSlides());
System.out.println("  Slides with notes: " + documentProperties.getNotes());
System.out.println("  Paragraphs: " + documentProperties.getParagraphs());
System.out.println("  Words: " + documentProperties.getWords());
System.out.println("  Multimedia clips: " + documentProperties.getMultimediaClips());

IHeadingPair[] headingPairs = documentProperties.getHeadingPairs();
String[] titlesOfParts = documentProperties.getTitlesOfParts();
headingPairs = headingPairs != null ? headingPairs : new IHeadingPair[0];
titlesOfParts = titlesOfParts != null ? titlesOfParts : new String[0];
int partIndex = 0;

if (headingPairs.length == 0 || titlesOfParts.length == 0) {
    System.out.println("Content groups: not available");
} else {
    System.out.println("Content groups:");

    for (IHeadingPair headingPair : headingPairs) {
        System.out.println("  " + headingPair.getName() + " (" + headingPair.getCount() + ")");

        for (int partOffset = 0; partOffset < headingPair.getCount() && partIndex < titlesOfParts.length; partOffset++) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.length) {
        System.out.println("  Other parts:");

        while (partIndex < titlesOfParts.length) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }
}

Cada IHeadingPair suministra un nombre de grupo y el número de elementos en ese grupo. IDocumentProperties.getTitlesOfParts devuelve una matriz plana y ordenada, por lo que se deben consumir la cantidad de títulos consecutivos especificados por cada pareja de encabezado.

Metadatos almacenados y limitaciones de formato

Las propiedades de inventario devueltas por IPresentationInfo.readDocumentProperties reflejan los metadatos disponibles en el documento origen. Aspose.Slides no carga ni recorre el modelo de objeto de la presentación para recalcular estos valores en esta llamada. Las propiedades ausentes se representan con valores predeterminados, y los valores almacenados pueden estar desactualizados si la aplicación que guardó el archivo por última vez no actualizó sus propiedades de documento.

PPTX: El formato proporciona propiedades de documento extendidas para recuentos de diapositivas, notas, diapositivas ocultas, párrafos, palabras y elementos multimedia, así como pares de encabezado y títulos de partes. La disponibilidad depende de qué propiedades haya escrito el productor del documento.
PPT: El formato binario puede almacenar propiedades de resumen de documento equivalentes. Si una propiedad está ausente o no fue refrescada por el productor del documento, Aspose.Slides devuelve su valor almacenado o predeterminado en lugar de calcularlo a partir de las diapositivas.
ODP: Los metadatos de OpenDocument proporcionan estadísticas generales del documento, como recuentos de páginas, párrafos y palabras, pero esos valores no se asignan a todas las propiedades extendidas específicas de PowerPoint. Los metadatos de diapositivas ocultas, notas, multimedia, pares de encabezado y títulos de partes pueden no estar disponibles, y las propiedades de inventario pueden devolver valores predeterminados. No consideres que un valor cero o una matriz vacía sea prueba concluyente de que el contenido correspondiente está ausente.

Utiliza el enfoque de metadatos ligeros para inventarios y verificaciones preliminares. Carga la presentación e inspecciona su modelo de objeto en vivo cuando el resultado debe reflejar cambios en memoria o cuando necesites verificar el contenido real de la presentación.

Actualizar propiedades de la presentación

Las propiedades devueltas por IPresentationInfo.readDocumentProperties también pueden modificarse sin crear una instancia de Presentation. Aplica los cambios con IPresentationInfo.updateDocumentProperties y, a continuación, escribe la presentación vinculada con IPresentationInfo.writeBindedPresentation.

La siguiente imagen muestra las propiedades del documento original.

Propiedades originales del documento de la presentación PowerPoint

El siguiente ejemplo cambia el título y la hora de última guardado y escribe el resultado en un nuevo archivo:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.PresentationFactory;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;

String sourceFile = "sample.pptx";
String outputFile = "sample_with_updated_properties.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(sourceFile);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

documentProperties.setTitle("Quarterly sales report");
documentProperties.setLastSavedTime(new Date());

presentationInfo.updateDocumentProperties(documentProperties);
try (OutputStream outputStream = new FileOutputStream(outputFile)) {
    presentationInfo.writeBindedPresentation(outputStream);
}

La siguiente imagen muestra las propiedades del documento modificadas.

Propiedades modificadas del documento de la presentación PowerPoint

Enlaces útiles

Para comprobaciones de seguridad relacionadas y configuraciones de protección, consulta los siguientes artículos:

Preguntas frecuentes

¿Cómo puedo comprobar si las fuentes están incrustadas y cuáles son?

Carga la presentación y utiliza Presentation.getFontsManager. Llama a IFontsManager.getEmbeddedFonts para obtener las fuentes incrustadas y a IFontsManager.getFonts para obtener las fuentes usadas por la presentación. Compara los dos resultados para encontrar las fuentes necesarias para la renderización que no están incrustadas.

¿Cómo puedo saber rápidamente si el archivo tiene diapositivas ocultas y cuántas?

Cuando los metadatos del documento almacenados son suficientes, lee IDocumentProperties.getHiddenSlides mediante PresentationFactory.getPresentationInfo y IPresentationInfo.readDocumentProperties. Esto es adecuado para un inventario ligero. Si la presentación se ha modificado en memoria, los metadatos almacenados pueden faltar o estar desactualizados, o necesitas verificar valores en vivo; en ese caso, recorre Presentation.getSlides e inspecciona el método ISlide.getHidden de cada diapositiva.

¿Puedo detectar si se utiliza un tamaño y orientación de diapositiva personalizados y si difieren de los valores predeterminados?

Sí. Carga la presentación y llama a Presentation.getSlideSize. Utiliza ISlideSize.getType, ISlideSize.getSize y ISlideSize.getOrientation para comparar la configuración actual con la predefinida y sus dimensiones.

¿Existe una manera rápida de ver si los gráficos hacen referencia a fuentes de datos externas?

Sí. Localiza cada Chart y llama a IChartData.getDataSourceType. Para un libro de trabajo externo, llama a IChartData.getExternalWorkbookPath. El tipo de fuente de datos y la ruta identifican una referencia externa, pero verificar si el objetivo está disponible requiere una comprobación de recursos adicional.

¿Cómo puedo evaluar las diapositivas «pesadas» que pueden ralentizar la renderización o la exportación a PDF?

No existe una única propiedad de complejidad. Recorre Presentation.getSlides y la colección IBaseSlide.getShapes de cada diapositiva. Utiliza el recuento de formas y la presencia de imágenes grandes, efectos, animaciones o multimedia como señales de filtrado, y mide una renderización o exportación representativa antes de considerar una diapositiva como un cuello de botella de rendimiento confirmado.

Abrir presentaciones en Java Determinar el formato original de la presentación en Java