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

Visión general

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

Este artículo demuestra una inspección ligera mediante PresentationFactory y PresentationInfo, así como actualizaciones dirigidas mediante DocumentProperties.

Comprobar el formato de una presentación

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

Utilice PresentationFactory::getPresentationInfo para inspeccionar un archivo sin crear una instancia de Presentation. El método PresentationInfo::getLoadFormat informa el formato detectado, como PPTX, PPT u ODP.

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$fileNames = ["pres.pptx", "pres.ppt", "pres.odp"];

foreach ($fileNames as $fileName) {
    $presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($fileName);
    $loadFormat = java_values($presentationInfo->getLoadFormat());
    $formatName = "Other (" . $loadFormat . ")";

    if ($loadFormat === LoadFormat::Pptx) {
        $formatName = "PPTX";
    } elseif ($loadFormat === LoadFormat::Ppt) {
        $formatName = "PPT";
    } elseif ($loadFormat === LoadFormat::Odp) {
        $formatName = "ODP";
    }

    echo $fileName . ": " . $formatName . PHP_EOL;
}

Crear un inventario de presentaciones ligero

Cuando procesa muchos archivos de presentación, puede necesitar un inventario compacto para validación, indexación o un sistema de gestión documental. En este escenario, use PresentationFactory::getPresentationInfo para obtener un objeto PresentationInfo y, a continuación, llame a PresentationInfo::readDocumentProperties para leer los metadatos del documento. Este enfoque no crea una instancia de Presentation ni requiere recorrer todo el modelo de objetos de la presentación.

Las propiedades extendidas expuestas por DocumentProperties 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 DocumentProperties::getHeadingPairs con DocumentProperties::getTitlesOfParts para mostrar grupos de contenido como fuentes, temas y títulos de diapositivas.

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$filePath = "sample.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($filePath);
$documentProperties = $presentationInfo->readDocumentProperties();

$loadFormat = java_values($presentationInfo->getLoadFormat());
$formatName = "Other (" . $loadFormat . ")";

if ($loadFormat === LoadFormat::Pptx) {
    $formatName = "PPTX";
} elseif ($loadFormat === LoadFormat::Ppt) {
    $formatName = "PPT";
} elseif ($loadFormat === LoadFormat::Odp) {
    $formatName = "ODP";
}

echo "File: " . basename($filePath) . PHP_EOL;
echo "Format: " . $formatName . PHP_EOL;
echo "Title: " . java_values($documentProperties->getTitle()) . PHP_EOL;
echo "Author: " . java_values($documentProperties->getAuthor()) . PHP_EOL;
echo "Statistics:" . PHP_EOL;
echo "  Slides: " . java_values($documentProperties->getSlides()) . PHP_EOL;
echo "  Hidden slides: " . java_values($documentProperties->getHiddenSlides()) . PHP_EOL;
echo "  Slides with notes: " . java_values($documentProperties->getNotes()) . PHP_EOL;
echo "  Paragraphs: " . java_values($documentProperties->getParagraphs()) . PHP_EOL;
echo "  Words: " . java_values($documentProperties->getWords()) . PHP_EOL;
echo "  Multimedia clips: " . java_values($documentProperties->getMultimediaClips()) . PHP_EOL;

$headingPairs = $documentProperties->getHeadingPairs();
$titlesOfParts = $documentProperties->getTitlesOfParts();

if (java_is_null($headingPairs) || java_is_null($titlesOfParts)) {
    echo "Content groups: not available" . PHP_EOL;
} else {
    $headingPairs = java_values($headingPairs);
    $titlesOfParts = java_values($titlesOfParts);
    $partIndex = 0;

    if (count($headingPairs) === 0 || count($titlesOfParts) === 0) {
        echo "Content groups: not available" . PHP_EOL;
    } else {
        echo "Content groups:" . PHP_EOL;

        foreach ($headingPairs as $headingPair) {
            $partCount = java_values($headingPair->getCount());
            echo "  " . java_values($headingPair->getName()) . " (" . $partCount . ")" . PHP_EOL;

            for ($partOffset = 0; $partOffset < $partCount && $partIndex < count($titlesOfParts); $partOffset++) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }

        if ($partIndex < count($titlesOfParts)) {
            echo "  Other parts:" . PHP_EOL;

            while ($partIndex < count($titlesOfParts)) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }
    }
}

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

Metadatos almacenados y limitaciones de formato

Las propiedades de inventario devueltas por PresentationInfo::readDocumentProperties reflejan los metadatos disponibles en el documento fuente. Aspose.Slides no carga ni recorre el modelo de objetos de la presentación para recalcular estos valores para esta llamada. Las propiedades ausentes se representan con valores predeterminados, y los valores almacenados pueden estar obsoletos 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 fueron escritas por el productor del documento.
  • PPT: El formato binario puede almacenar propiedades resumidas 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 estos 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 trate un valor cero o una matriz vacía como prueba autoritativa de que el contenido correspondiente está ausente.

Utilice el enfoque de metadatos ligeros para inventarios y verificaciones preliminares. Cargue la presentación e inspeccione su modelo de objetos en tiempo real cuando el resultado deba reflejar cambios en memoria o cuando necesite verificar el contenido real de la presentación.

Actualizar propiedades de la presentación

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

La siguiente imagen muestra las propiedades del documento original.

Propiedades del documento original de la presentación PowerPoint

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

use aspose\slides\PresentationFactory;

$sourceFile = "sample.pptx";
$outputFile = "sample_with_updated_properties.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($sourceFile);
$documentProperties = $presentationInfo->readDocumentProperties();

$documentProperties->setTitle("Quarterly sales report");
$documentProperties->setLastSavedTime(new Java("java.util.Date"));

$presentationInfo->updateDocumentProperties($documentProperties);
$outputStream = new Java("java.io.FileOutputStream", $outputFile);
try {
    $presentationInfo->writeBindedPresentation($outputStream);
} finally {
    $outputStream->close();
}

La siguiente imagen muestra las propiedades del documento modificadas.

Propiedades del documento modificadas de la presentación PowerPoint

Enlaces útiles

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

Preguntas frecuentes

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

Cargue la presentación y use Presentation::getFontsManager. Llame a FontsManager::getEmbeddedFonts para obtener las fuentes incrustadas y a FontsManager::getFonts para obtener las fuentes utilizadas por la presentación. Compare los dos resultados para encontrar fuentes que son necesarias para la representación pero no están incrustadas.

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

Cuando los metadatos del documento almacenado son suficientes, lea DocumentProperties::getHiddenSlides a través de PresentationFactory::getPresentationInfo y PresentationInfo::readDocumentProperties. Esto es adecuado para un inventario ligero. Si la presentación ha sido modificada en memoria, los metadatos almacenados pueden estar ausentes o desactualizados, o necesita verificar valores en tiempo real; en ese caso, itere a través de Presentation::getSlides y examine el método Slide::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í. Cargue la presentación y llame a Presentation::getSlideSize. Use SlideSize::getType, SlideSize::getSize y SlideSize::getOrientation para comparar la configuración actual con el preset y las dimensiones esperadas.

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

Sí. Ubique cada Chart y llame a ChartData::getDataSourceType. Para un libro de trabajo externo, llame a ChartData::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 separada.

¿Cómo puedo evaluar las diapositivas “pesadas” que pueden ralentizar la representación o la exportación a PDF?

No existe una única propiedad de complejidad. Recorra Presentation::getSlides y la colección de BaseSlide::getShapes de cada diapositiva. Utilice el recuento de formas y la presencia de imágenes grandes, efectos, animaciones o elementos multimedia como señales de filtrado, y mida una representación o exportación representativa antes de considerar una diapositiva como un cuello de botella de rendimiento confirmado.

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