Abrufen und Aktualisieren von Präsentationsinformationen in Python
Übersicht
Aspose.Slides kann das Format einer Präsentation erkennen und deren Dokumentmetadaten auslesen, ohne ein komplettes Präsentations‑Objektmodell zu erstellen. Das ist nützlich, wenn Sie Dateien klassifizieren, ein Inventar erstellen oder Eigenschaften prüfen müssen, bevor Sie entscheiden, ob Sie den Präsentationsinhalt laden und verarbeiten.
Dieser Artikel demonstriert die leichte Inspektion über PresentationFactory und PresentationInfo, sowie gezielte Aktualisierungen über DocumentProperties.
Präsentationsformat prüfen
Falls Sie bereits eine geladene Präsentation haben, siehe Determine the Original Presentation Format für die Erkennung nach dem Laden und die Einschränkungen von Legacy‑PPT-, PPS‑ und POT‑Streams.
Verwenden Sie PresentationFactory.get_presentation_info um eine Datei zu inspizieren, ohne eine Presentation‑Instanz zu erstellen. Die Eigenschaft PresentationInfo.load_format gibt das erkannte Format zurück, z. B. PPTX, PPT oder 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}")
Leichtes Präsentationsinventar erstellen
Wenn Sie viele Präsentationsdateien verarbeiten, benötigen Sie möglicherweise ein kompaktes Inventar für Validierung, Indexierung oder ein Dokument‑Management‑System. In diesem Szenario verwenden Sie PresentationFactory.get_presentation_info, um ein PresentationInfo‑Objekt zu erhalten, und rufen dann PresentationInfo.read_document_properties auf, um die Dokumentmetadaten zu lesen. Dieser Ansatz erstellt keine Presentation‑Instanz und erfordert keinen Durchlauf des gesamten Präsentations‑Objektmodells.
Die erweiterten Eigenschaften, die von DocumentProperties bereitgestellt werden, liefern folgende Inventarwerte:
| Eigenschaft | Inventarwert |
|---|---|
| slides | Gesamtzahl der Folien. |
| hidden_slides | Anzahl der versteckten Folien. |
| notes | Anzahl der Folien, die Notizen enthalten. |
| paragraphs | Gesamtzahl der Absätze, sofern verfügbar. |
| words | Gesamtzahl der Wörter. |
| multimedia_clips | Gesamtzahl der Audio‑ und Videoclips. |
Das folgende Beispiel liest diese Werte, ohne ein Presentation‑Objekt zu erstellen, und gibt ein kompaktes Inventar aus. Es kombiniert außerdem heading_pairs mit titles_of_parts, um Inhaltsgruppen wie Schriften, Designs und Folientitel darzustellen.
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
Jedes HeadingPair liefert einen Gruppennamen und die Anzahl der Elemente in dieser Gruppe. DocumentProperties.titles_of_parts ist eine flache, geordnete Sammlung, sodass die Anzahl aufeinanderfolgender Titel, die durch jedes Heading‑Pair angegeben werden, verarbeitet werden kann.
Gespeicherte Metadaten und Formatbeschränkungen
Die vom Aufruf PresentationInfo.read_document_properties zurückgegebenen Inventareigenschaften spiegeln die Metadaten wider, die im Quelldokument verfügbar sind. Aspose.Slides lädt das Präsentations‑Objektmodell nicht und traversiert es nicht, um diese Werte für diesen Aufruf neu zu berechnen. Fehlende Eigenschaften werden durch Standardwerte repräsentiert, und gespeicherte Werte können veraltet sein, wenn die Anwendung, die die Datei zuletzt gespeichert hat, ihre Dokumenteigenschaften nicht aktualisiert hat.
- PPTX: Das Format bietet erweiterte Dokumenteigenschaften für Folien‑, Noten‑, versteckte‑Folien‑, Absatz‑, Wort‑ und Multimedia‑Zählungen sowie Überschriftenpaare und Teil‑Titel. Die Verfügbarkeit hängt davon ab, welche Eigenschaften vom Dokumentersteller geschrieben wurden.
- PPT: Das Binärformat kann entsprechende Dokument‑Zusammenfassungs‑Eigenschaften speichern. Wenn eine Eigenschaft fehlt oder nicht vom Dokumentersteller aktualisiert wurde, gibt Aspose.Slides den gespeicherten oder Standardwert zurück, anstatt sie aus den Folien zu berechnen.
- ODP: OpenDocument‑Metadaten bieten allgemeine Dokumentstatistiken, wie Seiten‑, Absatz‑ und Wortzählungen, aber diese Werte lassen sich nicht auf jede PowerPoint‑spezifische erweiterte Eigenschaft abbilden. Versteckte‑Folien‑, Notizen‑, Multimedia‑, Überschriften‑ und Teil‑Titel‑Metadaten können fehlen, und die Inventareigenschaften können Standardwerte zurückgeben. Ein Null‑Wert oder eine leere Sammlung sollten nicht als eindeutiger Beweis dafür gelten, dass der entsprechende Inhalt fehlt.
Verwenden Sie den leichten Metadaten‑Ansatz für Inventare und Vorprüfungen. Laden Sie die Präsentation und inspizieren Sie ihr Live‑Objektmodell, wenn das Ergebnis Änderungen im Speicher widerspiegeln muss oder wenn Sie den tatsächlichen Präsentationsinhalt verifizieren möchten.
Präsentationseigenschaften aktualisieren
Die Eigenschaften, die von PresentationInfo.read_document_properties zurückgegeben werden, können ebenfalls geändert werden, ohne eine Presentation‑Instanz zu erstellen. Wenden Sie die Änderungen mit PresentationInfo.update_document_properties an und schreiben Sie die gebundene Präsentation mit PresentationInfo.write_binded_presentation.
Das folgende Bild zeigt die ursprünglichen Dokumenteigenschaften der PowerPoint‑Präsentation.
Das folgende Beispiel ändert den Titel und den letzten Speicherzeitpunkt und schreibt das Ergebnis in eine neue Datei:
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)
Das folgende Bild zeigt die geänderten Dokumenteigenschaften der PowerPoint‑Präsentation.
Nützliche Links
Für verwandte Sicherheitsprüfungen und Schutzeinstellungen siehe die folgenden Artikel:
FAQ
Wie kann ich prüfen, ob Schriftarten eingebettet sind und welche das sind?
Laden Sie die Präsentation und verwenden Sie Presentation.fonts_manager. Rufen Sie FontsManager.get_embedded_fonts auf, um die eingebetteten Schriftarten zu erhalten, und FontsManager.get_fonts für die von der Präsentation genutzten Schriftarten. Vergleichen Sie beide Ergebnisse, um Schriftarten zu finden, die für die Wiedergabe erforderlich, aber nicht eingebettet sind.
Wie kann ich schnell erkennen, ob die Datei versteckte Folien enthält und wie viele?
Wenn gespeicherte Dokumentmetadaten ausreichen, lesen Sie DocumentProperties.hidden_slides über PresentationFactory.get_presentation_info und PresentationInfo.read_document_properties. Das eignet sich für ein leichtes Inventar. Wenn die Präsentation im Speicher geändert wurde, können die gespeicherten Metadaten fehlen oder veraltet sein; dann iterieren Sie über Presentation.slides und prüfen die Eigenschaft Slide.hidden jeder Folie.
Kann ich feststellen, ob eine benutzerdefinierte Foliengröße und -ausrichtung verwendet wird und ob sie von den Vorgaben abweicht?
Ja. Laden Sie die Präsentation und lesen Sie Presentation.slide_size. Prüfen Sie SlideSize.type, SlideSize.size und SlideSize.orientation, um die aktuellen Einstellungen mit den erwarteten Vorgaben und Dimensionen zu vergleichen.
Gibt es einen schnellen Weg zu sehen, ob Diagramme externe Datenquellen referenzieren?
Ja. Lokalisieren Sie jedes Chart und prüfen Sie ChartData.data_source_type. Für eine externe Arbeitsmappe lesen Sie ChartData.external_workbook_path. Der Datentyp und Pfad identifizieren eine externe Referenz, jedoch erfordert die Überprüfung, ob das Ziel verfügbar ist, einen separaten Ressourcen‑Check.
Wie kann ich ‘schwere’ Folien beurteilen, die das Rendern oder den PDF‑Export verlangsamen könnten?
Es gibt keine einzelne Komplexitäts‑Eigenschaft. Durchlaufen Sie Presentation.slides und die BaseSlide.shapes jeder Folie. Nutzen Sie die Anzahl der Formen sowie das Vorhandensein großer Bilder, Effekte, Animationen oder Multimedia als Screening‑Signale und messen Sie ein repräsentatives Render‑ oder Export‑Ergebnis, bevor Sie eine Folie als bestätigten Performance‑Engpass einstufen.