Presentatie-informatie ophalen en bijwerken in Python via Java
Overzicht
Aspose.Slides kan het formaat van een presentatie identificeren en de document‑metadata lezen zonder een volledig presentatiemodel te maken. Dit is handig wanneer u bestanden wilt classificeren, een inventaris wilt opbouwen of eigenschappen wilt inspecteren voordat u besluit de presentatie‑inhoud te laden en te verwerken.
De voorbeelden vereisen Aspose.Slides for Python via Java en een compatibele Java‑runtime. Elk voorbeeld start de JVM als deze nog niet draait. Lever bestaande presentatie‑bestanden op de in de voorbeelden gebruikte paden.
Dit artikel demonstreert lichtgewicht inspectie via PresentationFactory en PresentationInfo, evenals gerichte updates via DocumentProperties.
Controleer een presentatie‑indeling
Gebruik PresentationFactory.getPresentationInfo om een bestand te inspecteren zonder een Presentation‑instantie te maken. De methode PresentationInfo.getLoadFormat rapporteert het gedetecteerde formaat, zoals PPTX, PPT of 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}")
Bouw een lichtgewicht presentatie‑inventaris
Wanneer u veel presentatie‑bestanden verwerkt, heeft u mogelijk een compacte inventaris nodig voor validatie, indexering of een document‑beheersysteem. Gebruik in dit scenario PresentationFactory.getPresentationInfo om een PresentationInfo‑object te verkrijgen, en roep vervolgens PresentationInfo.readDocumentProperties aan om de document‑metadata te lezen. Deze aanpak maakt geen Presentation‑instantie aan en vereist geen doorlopen van het volledige presentatiemodel.
De uitgebreide eigenschappen die door DocumentProperties worden blootgelegd, leveren de volgende inventariswaarden:
| Methode | Inventariswaarde |
|---|---|
| getSlides | Totaal aantal dia’s. |
| getHiddenSlides | Aantal verborgen dia’s. |
| getNotes | Aantal dia’s met notities. |
| getParagraphs | Totaal aantal alinea’s, indien beschikbaar. |
| getWords | Totaal aantal woorden. |
| getMultimediaClips | Totaal aantal audio‑ en videoclips. |
Het volgende voorbeeld leest deze waarden zonder een Presentation‑object aan te maken en drukt een compacte inventaris af. Het combineert bovendien getHeadingPairs met getTitlesOfParts om content‑groepen weer te geven, zoals lettertypen, thema’s en dia‑titels.
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
Elke HeadingPair levert een groepsnaam en het aantal items in die groep. DocumentProperties.getTitlesOfParts retourneert eenplatte, geordende reeks, zodat u het aantal opeenvolgende titels moet verbruiken dat door elk heading‑pair wordt gespecificeerd.
Opgeslagen metadata en formatlimieten
De inventarie‑eigenschappen die door PresentationInfo.readDocumentProperties worden geretourneerd, weerspiegelen de metadata die beschikbaar is in het bron‑document. Aspose.Slides laadt en doorloopt het presentatiemodel niet om deze waarden opnieuw te berekenen voor deze aanroep. Ontbrekende eigenschappen worden weergegeven met standaardwaarden, en opgeslagen waarden kunnen verouderd zijn als de applicatie die het bestand als laatste heeft opgeslagen, de document‑eigenschappen niet heeft bijgewerkt.
- PPTX: Het formaat biedt uitgebreide document‑eigenschappen voor aantallen dia’s, notities, verborgen dia’s, alinea’s, woorden en multimedia, evenals heading‑pairs en onderdeel‑titels. Beschikbaarheid hangt af van welke eigenschappen door de document‑maker zijn weggeschreven.
- PPT: Het binaire formaat kan overeenkomstige document‑samenvattings‑eigenschappen opslaan. Als een eigenschap ontbreekt of niet is vernieuwd door de document‑maker, retourneert Aspose.Slides de opgeslagen of standaardwaarde in plaats van deze te berekenen vanuit de dia’s.
- ODP: OpenDocument‑metadata biedt algemene documentstatistieken, zoals aantallen pagina’s, alinea’s en woorden, maar deze waarden komen niet overeen met elke PowerPoint‑specifieke uitgebreide eigenschap. Metadata over verborgen dia’s, notities, multimedia, heading‑pairs en onderdeel‑titels kan ontbreken, en de inventarie‑eigenschappen kunnen standaardwaarden retourneren. Beschouw een nul‑waarde of een lege reeks niet als onbetwistbaar bewijs dat de corresponderende inhoud afwezig is.
Gebruik de lichtgewicht metadata‑benadering voor inventarissen en voorlopige controles. Laad de presentatie en inspecteer het levende objectmodel wanneer het resultaat in‑memory wijzigingen moet weergeven of wanneer u de feitelijke presentatie‑inhoud moet verifiëren.
Werk presentatie‑eigenschappen bij
De eigenschappen die door PresentationInfo.readDocumentProperties worden geretourneerd, kunnen ook worden gewijzigd zonder een Presentation‑instantie te maken. Pas de wijzigingen toe met PresentationInfo.updateDocumentProperties en schrijf vervolgens de gekoppelde presentatie weg met PresentationInfo.writeBindedPresentation.
De volgende afbeelding toont de oorspronkelijke document‑eigenschappen.
Het volgende voorbeeld wijzigt de titel en de laatst‑opgeslagen tijd en schrijft het resultaat naar een nieuw bestand:
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()
De volgende afbeelding toont de bijgewerkte document‑eigenschappen.
Handige links
Voor gerelateerde beveiligingscontroles en beschermingsinstellingen, zie de volgende artikelen:
FAQ
Hoe kan ik controleren of lettertypen zijn ingebed en welke dat zijn?
Laad de presentatie en gebruik Presentation.getFontsManager. Roep FontsManager.getEmbeddedFonts aan om de ingebedde lettertypen te verkrijgen en FontsManager.getFonts om de door de presentatie gebruikte lettertypen te verkrijgen. Vergelijk de twee resultaten om lettertypen te vinden die nodig zijn voor weergave maar niet zijn ingebed.
Hoe kan ik snel zien of het bestand verborgen dia’s bevat en hoeveel?
Wanneer opgeslagen document‑metadata voldoende is, lees dan DocumentProperties.getHiddenSlides via PresentationFactory.getPresentationInfo en PresentationInfo.readDocumentProperties. Dit is geschikt voor een lichtgewicht inventaris. Als de presentatie in‑memory is aangepast, kan de opgeslagen metadata ontbreken of verouderd zijn, of u moet live‑waarden verifiëren door door Presentation.getSlides te itereren en elke dia’s Slide.getHidden‑methode te inspecteren.
Kan ik detecteren of er een aangepaste dia‑grootte en -oriëntatie wordt gebruikt, en of deze afwijkt van de standaardinstellingen?
Ja. Laad de presentatie en roep Presentation.getSlideSize aan. Gebruik SlideSize.getType, SlideSize.getSize en SlideSize.getOrientation om de huidige instellingen te vergelijken met de verwachte vooraf‑ingestelde waarden en afmetingen.
Is er een snelle manier om te zien of grafieken verwijzen naar externe gegevensbronnen?
Ja. Zoek elke Chart en roep ChartData.getDataSourceType aan. Voor een extern werkboek, roep ChartData.getExternalWorkbookPath aan. Het type gegevensbron en het pad geven een externe referentie aan, maar verifiëren of het doel beschikbaar is, vereist een afzonderlijke resources‑controle.
Hoe kan ik ‘zware’ dia’s beoordelen die mogelijk de weergave of PDF‑export vertragen?
Er bestaat geen enkele complexiteits‑eigenschap. Doorloop Presentation.getSlides en de BaseSlide.getShapes‑collectie van elke dia. Gebruik het aantal shapes en de aanwezigheid van grote afbeeldingen, effecten, animaties of multimedia als screeningssignalen, en meet een representatieve weergave of export voordat u een dia als een bevestigd performance‑probleem classificeert.