Načíst a aktualizovat informace o prezentaci v Pythonu přes Java

O čem je tato stránka

Prozkoumejte snímky, strukturu a metadata v prezentacích PowerPoint a OpenDocument pomocí Pythonu přes Java pro rychlejší poznatky a inteligentnější audity obsahu.

Přehled

Aspose.Slides dokáže identifikovat formát prezentace a přečíst její metadata dokumentu, aniž by vytvořil kompletní objektový model prezentace. To je užitečné, když potřebujete soubory klasifikovat, vytvořit inventář nebo zkontrolovat vlastnosti před rozhodnutím, zda načíst a zpracovat obsah prezentace.

Příklady vyžadují Aspose.Slides pro Python via Java a kompatibilní Java runtime. Každý příklad spustí JVM, pokud ještě neběží. Poskytněte existující soubory prezentací na cestách použité v příkladech.

Tento článek demonstruje lehkou kontrolu pomocí PresentationFactory a PresentationInfo, stejně jako cílené aktualizace pomocí DocumentProperties.

Zkontrolujte formát prezentace

Použijte PresentationFactory.getPresentationInfo k prozkoumání souboru, aniž byste vytvořili instanci Presentation. Metoda PresentationInfo.getLoadFormat vrací detekovaný formát, například PPTX, PPT nebo ODP.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LoadFormat, PresentationFactory

file_names = ["pres.pptx", "pres.ppt", "pres.odp"]

for file_name in file_names:
    presentation_info = PresentationFactory.getInstance().getPresentationInfo(file_name)
    load_format = presentation_info.getLoadFormat()
    format_name = f"Other ({load_format})"

    if load_format == LoadFormat.Pptx:
        format_name = "PPTX"
    elif load_format == LoadFormat.Ppt:
        format_name = "PPT"
    elif load_format == LoadFormat.Odp:
        format_name = "ODP"

    print(f"{file_name}: {format_name}")

Vytvořte lehkou inventuru prezentací

Když zpracováváte mnoho souborů prezentací, můžete potřebovat kompaktní inventář pro validaci, indexaci nebo systém správy dokumentů. V takovém scénáři použijte PresentationFactory.getPresentationInfo k získání objektu PresentationInfo a poté zavolejte PresentationInfo.readDocumentProperties k načtení metadat dokumentu. Tento přístup nevytváří instanci Presentation ani nevyžaduje procházet kompletní objektový model prezentace.

Rozšířené vlastnosti poskytované třídou DocumentProperties poskytují následující hodnoty inventáře:

Metoda	Hodnota inventáře
getSlides	Celkový počet snímků.
getHiddenSlides	Počet skrytých snímků.
getNotes	Počet snímků, které obsahují poznámky.
getParagraphs	Celkový počet odstavců, pokud jsou dostupné.
getWords	Celkový počet slov.
getMultimediaClips	Celkový počet audio a video klipů.

Následující příklad načte tyto hodnoty, aniž by vytvořil objekt Presentation a vypíše kompaktní inventář. Také kombinuje getHeadingPairs s getTitlesOfParts pro zobrazení skupin obsahu, jako jsou písma, motivy a názvy snímků.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from pathlib import Path
from asposeslides.api import LoadFormat, PresentationFactory

file_path = "sample.pptx"
presentation_info = PresentationFactory.getInstance().getPresentationInfo(file_path)
document_properties = presentation_info.readDocumentProperties()

load_format = presentation_info.getLoadFormat()
format_name = f"Other ({load_format})"

if load_format == LoadFormat.Pptx:
    format_name = "PPTX"
elif load_format == LoadFormat.Ppt:
    format_name = "PPT"
elif load_format == LoadFormat.Odp:
    format_name = "ODP"

print(f"File: {Path(file_path).name}")
print(f"Format: {format_name}")
print(f"Title: {document_properties.getTitle()}")
print(f"Author: {document_properties.getAuthor()}")
print("Statistics:")
print(f"  Slides: {document_properties.getSlides()}")
print(f"  Hidden slides: {document_properties.getHiddenSlides()}")
print(f"  Slides with notes: {document_properties.getNotes()}")
print(f"  Paragraphs: {document_properties.getParagraphs()}")
print(f"  Words: {document_properties.getWords()}")
print(f"  Multimedia clips: {document_properties.getMultimediaClips()}")

heading_pairs = document_properties.getHeadingPairs()
titles_of_parts = document_properties.getTitlesOfParts()
heading_pairs = heading_pairs if heading_pairs is not None else []
titles_of_parts = titles_of_parts if titles_of_parts is not None else []
part_index = 0

if len(heading_pairs) == 0 or len(titles_of_parts) == 0:
    print("Content groups: not available")
else:
    print("Content groups:")

    for heading_pair in heading_pairs:
        print(f"  {heading_pair.getName()} ({heading_pair.getCount()})")

        for part_offset in range(heading_pair.getCount()):
            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

Každý HeadingPair poskytuje název skupiny a počet položek v této skupině. DocumentProperties.getTitlesOfParts vrací ploché, uspořádané pole, takže spotřebujte počet po sobě jdoucích názvů určených každým párem záhlaví.

Uložená metadata a omezení formátů

Vlastnosti inventáře vrácené metodou PresentationInfo.readDocumentProperties odrážejí metadata dostupná ve zdrojovém dokumentu. Aspose.Slides nenačítá a neprochází objektový model prezentace pro přepočet těchto hodnot při tomto volání. Chybějící vlastnosti jsou reprezentovány výchozími hodnotami a uložené hodnoty mohou být zastaralé, pokud aplikace, která soubor naposledy uložila, neaktualizovala jeho dokumentové vlastnosti.

• PPTX: Formát poskytuje rozšířené dokumentové vlastnosti pro počty snímků, poznámek, skrytých snímků, odstavců, slov a multimédií, stejně jako páry záhlaví a názvy částí. Dostupnost závisí na tom, které vlastnosti byly zapsány tvůrcem dokumentu.
• PPT: Binární formát může uložit odpovídající vlastnosti souhrnu dokumentu. Pokud je vlastnost absentní nebo nebyla obnovena tvůrcem dokumentu, Aspose.Slides vrátí její uloženou nebo výchozí hodnotu místo výpočtu ze snímků.
• ODP: Metadata OpenDocument poskytují obecné statistiky dokumentu, jako jsou počty stránek, odstavců a slov, ale tyto hodnoty neodpovídají všem rozšířeným vlastnostem specifickým pro PowerPoint. Metadata pro skryté snímky, poznámky, multimédia, páry záhlaví a názvy částí mohou být nedostupná a vlastnosti inventáře mohou vracet výchozí hodnoty. Nepovažujte nulovou hodnotu ani prázdné pole za závěrečný důkaz, že odpovídající obsah chybí.

Používejte lehký přístup k metadatům pro inventáře a předběžné kontroly. Načtěte prezentaci a prozkoumejte její živý objektový model, když výsledek musí odrážet změny v paměti nebo když potřebujete ověřit skutečný obsah prezentace.

Aktualizujte vlastnosti prezentace

Vlastnosti vrácené metodou PresentationInfo.readDocumentProperties lze také změnit, aniž byste vytvořili instanci Presentation. Proveďte změny pomocí PresentationInfo.updateDocumentProperties a poté zapište vázanou prezentaci pomocí PresentationInfo.writeBindedPresentation.

Následující obrázek zobrazuje původní vlastnosti dokumentu.

Následující příklad změní název a čas posledního uložení a zapíše výsledek do nového souboru:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import PresentationFactory
from java.io import FileOutputStream
from java.util import Date

source_file = "sample.pptx"
output_file = "sample_with_updated_properties.pptx"
presentation_info = PresentationFactory.getInstance().getPresentationInfo(source_file)
document_properties = presentation_info.readDocumentProperties()

document_properties.setTitle("Quarterly sales report")
last_saved_time = Date()
document_properties.setLastSavedTime(last_saved_time)

presentation_info.updateDocumentProperties(document_properties)
output_stream = FileOutputStream(output_file)
try:
    presentation_info.writeBindedPresentation(output_stream)
finally:
    output_stream.close()

Následující obrázek zobrazuje aktualizované vlastnosti dokumentu.

Užitečné odkazy

Pro související kontrolu zabezpečení a nastavení ochrany si přečtěte následující články:

• Password-Protect Presentations
• Write-Protect Presentations

Často kladené otázky

Jak mohu zkontrolovat, zda jsou písma vložena a která to jsou?

Načtěte prezentaci a použijte Presentation.getFontsManager. Zavolejte FontsManager.getEmbeddedFonts pro získání vložených písem a FontsManager.getFonts pro získání písem používaných v prezentaci. Porovnejte oba výsledky a najděte písma, která jsou potřebná pro vykreslení, ale nejsou vložena.

Jak rychle zjistit, zda soubor obsahuje skryté snímky a kolik jich je?

Když jsou uložená metadata dokumentu dostačující, přečtěte DocumentProperties.getHiddenSlides přes PresentationFactory.getPresentationInfo a PresentationInfo.readDocumentProperties. To je vhodné pro lehký inventář. Pokud byla prezentace změněna v paměti, uložená metadata mohou chybět nebo být zastaralá, nebo potřebujete ověřit živé hodnoty – iterujte přes Presentation.getSlides a zkontrolujte metodu Slide.getHidden každého snímku.

Mohu zjistit, zda je použita vlastní velikost a orientace snímku a zda se liší od výchozích?

Ano. Načtěte prezentaci a zavolejte Presentation.getSlideSize. Použijte SlideSize.getType, SlideSize.getSize a SlideSize.getOrientation pro porovnání aktuálního nastavení s očekávaným přednastavením a rozměry.

Existuje rychlý způsob, jak zjistit, zda grafy odkazují na externí zdroje dat?

Ano. Najděte každý Chart a zavolejte ChartData.getDataSourceType. Pro externí sešit zavolejte ChartData.getExternalWorkbookPath. Typ zdroje dat a cesta identifikují externí odkaz, ale ověření dostupnosti cíle vyžaduje samostatnou kontrolu zdroje.

Jak mohu posoudit „těžké“ snímky, které mohou zpomalit vykreslování nebo export do PDF?

Neexistuje jediná vlastnost složitosti. Procházejte Presentation.getSlides a kolekci BaseSlide.getShapes každého snímku. Použijte počet tvarů a přítomnost velkých obrázků, efektů, animací nebo multimédií jako signály pro screenování a změřte reprezentativní vykreslení nebo export, než označíte snímek jako potvrzený úzký profil výkonu.