Recuperare e aggiornare le informazioni della presentazione in Python
Panoramica
Aspose.Slides può identificare il formato di una presentazione e leggere i metadati del documento senza creare un modello di oggetto della presentazione completo. Questo è utile quando è necessario classificare i file, creare un inventario o ispezionare le proprietà prima di decidere se caricare e elaborare il contenuto della presentazione.
Questo articolo dimostra l’ispezione leggera tramite PresentationFactory e PresentationInfo, così come gli aggiornamenti mirati tramite DocumentProperties.
Verificare il formato di una presentazione
Utilizza PresentationFactory.get_presentation_info per ispezionare un file senza creare un’istanza di Presentation. La proprietà PresentationInfo.load_format restituisce il formato rilevato, come PPTX, PPT o 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}")
Creare un inventario di presentazioni leggero
Quando elabori molti file di presentazione, potresti aver bisogno di un inventario compatto per la convalida, l’indicizzazione o un sistema di gestione dei documenti. In questo scenario, utilizza PresentationFactory.get_presentation_info per ottenere un oggetto PresentationInfo, quindi chiama PresentationInfo.read_document_properties per leggere i metadati del documento. Questo approccio non crea un’istanza di Presentation né richiede di attraversare l’intero modello di oggetto della presentazione.
Le proprietà estese esposte da DocumentProperties forniscono i seguenti valori di inventario:
| Proprietà | Valore dell’inventario |
|---|---|
| slides | Numero totale di diapositive. |
| hidden_slides | Numero di diapositive nascoste. |
| notes | Numero di diapositive che contengono note. |
| paragraphs | Numero totale di paragrafi, se disponibile. |
| words | Numero totale di parole. |
| multimedia_clips | Numero totale di clip audio e video. |
Il seguente esempio legge questi valori senza creare un oggetto Presentation e stampa un inventario compatto. Combina inoltre heading_pairs con titles_of_parts per visualizzare gruppi di contenuto come caratteri, temi e titoli delle diapositive.
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
Ogni HeadingPair fornisce un nome di gruppo e il numero di elementi in quel gruppo. DocumentProperties.titles_of_parts è una raccolta piatta e ordinata, quindi consuma il numero di titoli consecutivi specificati da ciascuna coppia di intestazioni.
Metadati memorizzati e limitazioni di formato
Le proprietà di inventario restituite da PresentationInfo.read_document_properties riflettono i metadati disponibili nel documento sorgente. Aspose.Slides non carica e attraversa il modello di oggetto della presentazione per ricalcolare questi valori per questa chiamata. Le proprietà mancanti sono rappresentate da valori predefiniti e i valori memorizzati potrebbero essere obsoleti se l’applicazione che ha salvato il file per ultima non ha aggiornato le sue proprietà del documento.
- PPTX: Il formato fornisce proprietà di documento estese per il conteggio di diapositive, note, diapositive nascoste, paragrafi, parole e multimedia, nonché coppie di intestazioni e titoli delle parti. La disponibilità dipende da quali proprietà sono state scritte dal produttore del documento.
- PPT: Il formato binario può memorizzare le corrispondenti proprietà di riepilogo del documento. Se una proprietà è assente o non è stata aggiornata dal produttore del documento, Aspose.Slides restituisce il valore memorizzato o predefinito anziché calcolarlo dalle diapositive.
- ODP: I metadati OpenDocument forniscono statistiche generali del documento, come conteggi di pagine, paragrafi e parole, ma questi valori non corrispondono a tutte le proprietà estese specifiche di PowerPoint. I metadati di diapositive nascoste, diapositive con note, multimedia, coppie di intestazioni e titoli delle parti potrebbero non essere disponibili e le proprietà di inventario potrebbero restituire valori predefiniti. Non considerare un valore zero o una raccolta vuota come prova autorevole dell’assenza del contenuto corrispondente.
Utilizza l’approccio di metadati leggeri per inventari e controlli preliminari. Carica la presentazione e ispeziona il suo modello di oggetto live quando il risultato deve riflettere le modifiche in memoria o quando è necessario verificare il contenuto reale della presentazione.
Aggiornare le proprietà della presentazione
Le proprietà restituite da PresentationInfo.read_document_properties possono anche essere modificate senza creare un’istanza di Presentation. Applica le modifiche con PresentationInfo.update_document_properties, quindi scrivi la presentazione associata con PresentationInfo.write_binded_presentation.
L’immagine seguente mostra le proprietà originali del documento.
Il seguente esempio modifica il titolo e l’ora dell’ultimo salvataggio e scrive il risultato in un nuovo file:
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)
L’immagine seguente mostra le proprietà del documento aggiornate.
Link utili
Per controlli di sicurezza correlati e impostazioni di protezione, consulta i seguenti articoli:
FAQ
Come posso verificare se i caratteri sono incorporati e quali sono?
Carica la presentazione e utilizza Presentation.fonts_manager. Chiama FontsManager.get_embedded_fonts per ottenere i caratteri incorporati e FontsManager.get_fonts per ottenere i caratteri utilizzati dalla presentazione. Confronta i due risultati per individuare i caratteri necessari per il rendering ma non incorporati.
Come posso capire rapidamente se il file contiene diapositive nascoste e quante?
Quando i metadati del documento memorizzati sono sufficienti, leggi DocumentProperties.hidden_slides tramite PresentationFactory.get_presentation_info e PresentationInfo.read_document_properties. Questo è adatto per un inventario leggero. Se la presentazione è stata modificata in memoria, i metadati memorizzati potrebbero mancare o essere obsoleti, o se devi verificare i valori live, itera attraverso Presentation.slides e ispeziona la proprietà Slide.hidden di ciascuna diapositiva.
Posso rilevare se è stata usata una dimensione e orientamento della diapositiva personalizzati e se differiscono dai valori predefiniti?
Sì. Carica la presentazione e leggi Presentation.slide_size. Ispeziona SlideSize.type, SlideSize.size e SlideSize.orientation per confrontare le impostazioni attuali con il preset e le dimensioni previste.
Esiste un modo rapido per verificare se i grafici fanno riferimento a fonti di dati esterne?
Sì. Individua ogni Chart e ispeziona ChartData.data_source_type. Per una cartella di lavoro esterna, leggi ChartData.external_workbook_path. Il tipo di origine dati e il percorso identificano un riferimento esterno, ma verificare se la destinazione è disponibile richiede un controllo di risorse separato.
Come posso valutare le diapositive ‘pesanti’ che potrebbero rallentare il rendering o l’esportazione in PDF?
Non esiste un’unica proprietà di complessità. Attraversa Presentation.slides e la raccolta BaseSlide.shapes di ogni diapositiva. Usa il conteggio delle forme e la presenza di immagini grandi, effetti, animazioni o multimedia come segnali di screening, e misura un rendering o un’esportazione rappresentativa prima di considerare una diapositiva come un collo di bottiglia prestazionale confermato.