Recuperar y actualizar información de la presentación en Python
Visión general
Aspose.Slides puede identificar el formato de una presentación y leer sus metadatos de documento sin crear un modelo completo de objetos 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 muestra una inspección ligera mediante PresentationFactory y PresentationInfo, así como actualizaciones específicas mediante DocumentProperties.
Comprobar el formato de una presentación
Si ya tiene una presentación cargada, consulte Determinar el formato original de la presentación para la detección después de la carga y las limitaciones de los flujos heredados PPT, PPS y POT.
Utilice PresentationFactory.get_presentation_info para inspeccionar un archivo sin crear una instancia de Presentation. La propiedad PresentationInfo.load_format informa el formato detectado, como PPTX, PPT u ODP.
import aspose.slides as slides
file_names = ["pres.pptx", "pres.ppt", "pres.odp"]
for file_name in file_names:
presentation_info = slides.PresentationFactory.instance.get_presentation_info(file_name)
print(f"{file_name}: {presentation_info.load_format}")
Crear un inventario ligero de presentaciones
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.get_presentation_info para obtener un objeto PresentationInfo, y luego llame a PresentationInfo.read_document_properties para leer los metadatos del documento. Este enfoque no crea una instancia de Presentation ni requiere que recorra el modelo completo de objetos de la presentación.
Las propiedades extendidas expuestas por DocumentProperties proporcionan los siguientes valores de inventario:
| Propiedad | Valor de inventario |
|---|---|
| slides | Número total de diapositivas. |
| hidden_slides | Número de diapositivas ocultas. |
| notes | Número de diapositivas que contienen notas. |
| paragraphs | Número total de párrafos, cuando esté disponible. |
| words | Número total de palabras. |
| multimedia_clips | Número total de clips de audio y video. |
El siguiente ejemplo lee estos valores sin crear un objeto Presentation e imprime un inventario compacto. También combina heading_pairs con titles_of_parts para mostrar grupos de contenido como fuentes, temas y títulos de diapositiva.
import os
import aspose.slides as slides
file_path = "sample.pptx"
presentation_info = slides.PresentationFactory.instance.get_presentation_info(file_path)
document_properties = presentation_info.read_document_properties()
print(f"File: {os.path.basename(file_path)}")
print(f"Format: {presentation_info.load_format}")
print(f"Title: {document_properties.title}")
print(f"Author: {document_properties.author}")
print("Statistics:")
print(f" Slides: {document_properties.slides}")
print(f" Hidden slides: {document_properties.hidden_slides}")
print(f" Slides with notes: {document_properties.notes}")
print(f" Paragraphs: {document_properties.paragraphs}")
print(f" Words: {document_properties.words}")
print(f" Multimedia clips: {document_properties.multimedia_clips}")
heading_pairs = document_properties.heading_pairs or []
titles_of_parts = document_properties.titles_of_parts or []
part_index = 0
if not heading_pairs or not titles_of_parts:
print("Content groups: not available")
else:
print("Content groups:")
for heading_pair in heading_pairs:
print(f" {heading_pair.name} ({heading_pair.count})")
for _ in range(heading_pair.count):
if part_index >= len(titles_of_parts):
break
print(f" - {titles_of_parts[part_index]}")
part_index += 1
if part_index < len(titles_of_parts):
print(" Other parts:")
while part_index < len(titles_of_parts):
print(f" - {titles_of_parts[part_index]}")
part_index += 1
Cada HeadingPair proporciona un nombre de grupo y el número de elementos en ese grupo. DocumentProperties.titles_of_parts es una colección plana y ordenada, por lo que se consumen el número de títulos consecutivos especificado por cada par de encabezado.
Metadatos almacenados y limitaciones de formato
Las propiedades de inventario devueltas por PresentationInfo.read_document_properties reflejan los metadatos disponibles en el documento origen. Aspose.Slides no carga ni recorre el modelo de objetos de la presentación para recalcular estos valores en esta llamada. Las propiedades que faltan se representan con valores predeterminados, y los valores almacenados pueden estar desactualizados si la aplicación que guardó por última vez el archivo 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 creador del documento.
- PPT: El formato binario puede almacenar propiedades de resumen de documento equivalentes. Si una propiedad está ausente o no fue actualizada por el creador 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 corresponden con 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 colección vacía como prueba definitiva de que el contenido correspondiente está ausente.
Utilice el enfoque de metadatos ligeros para inventarios y comprobaciones preliminares. Cargue la presentación e inspeccione su modelo de objetos en vivo 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.read_document_properties también pueden modificarse sin crear una instancia de Presentation. Aplique los cambios con PresentationInfo.update_document_properties, y luego escriba la presentación vinculada con PresentationInfo.write_binded_presentation.
La siguiente imagen muestra las propiedades originales del documento.
El siguiente ejemplo cambia el título y la hora de la última guardada y escribe el resultado en un nuevo archivo:
import datetime
import aspose.slides as slides
source_file = "sample.pptx"
output_file = "sample_with_updated_properties.pptx"
presentation_info = slides.PresentationFactory.instance.get_presentation_info(source_file)
document_properties = presentation_info.read_document_properties()
document_properties.title = "Quarterly sales report"
document_properties.last_saved_time = datetime.datetime.now(datetime.timezone.utc)
presentation_info.update_document_properties(document_properties)
with open(output_file, "wb") as output_stream:
presentation_info.write_binded_presentation(output_stream)
La siguiente imagen muestra las propiedades del documento modificadas.
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.fonts_manager. Llame a FontsManager.get_embedded_fonts para obtener las fuentes incrustadas y a FontsManager.get_fonts para obtener las fuentes utilizadas por la presentación. Compare los dos resultados para encontrar 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 almacenado son suficientes, lea DocumentProperties.hidden_slides a través de PresentationFactory.get_presentation_info y PresentationInfo.read_document_properties. Esto es adecuado para un inventario ligero. Si la presentación ha sido modificada en memoria, los metadatos almacenados pueden faltar o estar desactualizados, o necesita verificar valores en vivo; itere a través de Presentation.slides y examine la propiedad Slide.hidden 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 lea Presentation.slide_size. Inspeccione SlideSize.type, SlideSize.size y SlideSize.orientation para comparar la configuración actual con la predefinida y sus dimensiones.
¿Existe una forma rápida de ver si los gráficos hacen referencia a fuentes de datos externas?
Sí. Localice cada Chart e inspeccione ChartData.data_source_type. Para un libro de trabajo externo, lea ChartData.external_workbook_path. El tipo de origen 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 renderización o la exportación a PDF?
No existe una única propiedad de complejidad. Recorra Presentation.slides y la colección BaseSlide.shapes de cada diapositiva. Use el recuento de formas y la presencia de imágenes grandes, efectos, animaciones o contenidos multimedia como señales de screening, y mida una renderización o exportación representativa antes de considerar una diapositiva como un cuello de botella de rendimiento confirmado.