Presentatie‑informatie ophalen en bijwerken in Python via Java
Overzicht
Aspose.Slides kan het formaat van een presentatie identificeren en de documentmetadata lezen zonder een volledig presentatiemodel te creëren. Dit is handig wanneer u bestanden wilt classificeren, een inventaris wilt opstellen of eigenschappen wilt inspecteren voordat u besluit de presentatie-inhoud te laden en te verwerken.
De voorbeelden vereisen Aspose.Slides voor Python via Java en een compatibele Java‑runtime. Elk voorbeeld start de JVM indien deze nog niet draait. Voorzie bestaande presentatiebestanden op de paden die in de voorbeelden worden gebruikt.
Dit artikel toont lichtgewicht inspectie via PresentationFactory en PresentationInfo, evenals gerichte updates via DocumentProperties.
Controleer het presentatiefomaat
Als u al een geladen presentatie heeft, zie Bepaal het originele presentatiefomaat voor detectie na het laden en de beperkingen van legacy PPT‑, PPS‑ en POT‑stromen.
Gebruik PresentationFactory.getPresentationInfo om een bestand te inspecteren zonder een Presentation‑instantie te maken. De methode PresentationInfo.getLoadFormat meldt 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}")
Maak een lichte presentatie‑inventaris
Wanneer u veel presentatiebestanden verwerkt, heeft u mogelijk een compacte inventaris nodig voor validatie, indexering of een documentbeheersysteem. Gebruik in dit scenario PresentationFactory.getPresentationInfo om een PresentationInfo‑object te verkrijgen, en roep vervolgens PresentationInfo.readDocumentProperties aan om de documentmetadata te lezen. Deze aanpak maakt geen Presentation‑instantie aan en vereist niet dat u het volledige presentatiemodel doorloopt.
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 die notities bevatten. |
| 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 te maken en drukt een compacte inventaris af. Het combineert bovendien getHeadingPairs met getTitlesOfParts om inhoudsgroepen zoals lettertypen, thema’s en dia‑titels weer te geven.
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
Elk HeadingPair levert een groepsnaam en het aantal items in die groep. DocumentProperties.getTitlesOfParts retourneert een plat, geordend array, zodat u het aantal opeenvolgende titels kunt consumeren dat door elk heading‑pair wordt gespecificeerd.
Opgeslagen metadata en formatbeperkingen
De inventaris‑eigenschappen die worden geretourneerd door PresentationInfo.readDocumentProperties 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 oproep. Ontbrekende eigenschappen worden weergegeven met standaardwaarden, en opgeslagen waarden kunnen verouderd zijn als de applicatie die het bestand laatst heeft opgeslagen haar documenteigenschappen niet heeft bijgewerkt.
- PPTX: Het formaat biedt uitgebreide documenteigenschappen voor aantallen dia’s, notities, verborgen dia’s, alinea’s, woorden en multimedia, evenals heading‑pairs en part‑titles. Beschikbaarheid hangt af van welke eigenschappen door de documentproducent zijn weggeschreven.
- PPT: Het binaire formaat kan overeenkomstige document‑samenvattings‑eigenschappen opslaan. Als een eigenschap afwezig is of niet is ververst door de documentproducent, retourneert Aspose.Slides de opgeslagen of standaardwaarde in plaats van deze te berekenen op basis van de dia’s.
- ODP: OpenDocument‑metadata biedt algemene documentstatistieken, zoals pagina‑, alinea‑ en woord‑aantallen, maar deze waarden komen niet overeen met elke PowerPoint‑specifieke uitgebreide eigenschap. Metadata voor verborgen dia’s, notities, multimedia, heading‑pairs en part‑titles kan ontbreken, en de inventaris‑eigenschappen kunnen standaardwaarden retourneren. Beschouw een nul‑waarde of een lege array niet als doorslaggevend bewijs dat de corresponderende inhoud ontbreekt.
Gebruik de lichtgewicht metadata‑aanpak voor inventarissen en voorlopige controles. Laad de presentatie en inspecteer het live‑objectmodel wanneer het resultaat in‑memory wijzigingen moet weerspiegelen of wanneer u de werkelijke presentatiewaarde moet verifiëren.
Update presentatie‑eigenschappen
De eigenschappen die worden geretourneerd door PresentationInfo.readDocumentProperties kunnen ook worden gewijzigd zonder een Presentation‑instantie te maken. Pas de wijzigingen toe met PresentationInfo.updateDocumentProperties en schrijf vervolgens de gebonden presentatie weg met PresentationInfo.writeBindedPresentation.
De volgende afbeelding toont de oorspronkelijke documenteigenschappen van de PowerPoint‑presentatie.
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 gewijzigde documenteigenschappen van de PowerPoint‑presentatie.
Handige links
Voor gerelateerde beveiligingscontroles en bescherminginstellingen, 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 vereist zijn voor weergave maar niet zijn ingebed.
Hoe kan ik snel zien of het bestand verborgen dia’s bevat en hoeveel?
Wanneer opgeslagen documentmetadata voldoende is, lees DocumentProperties.getHiddenSlides via PresentationFactory.getPresentationInfo en PresentationInfo.readDocumentProperties. Dit is geschikt voor een lichte inventaris. Als de presentatie in‑memory is gewijzigd, kan de opgeslagen metadata ontbreken of verouderd zijn, of moet u live‑waarden verifiëren door door Presentation.getSlides te itereren en de Slide.getHidden‑methode van elke dia te inspecteren.
Kan ik detecteren of een aangepaste dia‑grootte en -oriëntatie wordt gebruikt, en of die afwijken van de standaarden?
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 preset en afmetingen.
Is er een snelle manier om te zien of grafieken naar externe gegevensbronnen verwijzen?
Ja. Zoek elke Chart en roep ChartData.getDataSourceType aan. Voor een extern werkboek roep ChartData.getExternalWorkbookPath aan. Het type gegevensbron en het pad identificeren een externe verwijzing, maar verifiëren of het doel beschikbaar is vereist een afzonderlijke resource‑check.
Hoe kan ik ‘zware’ dia’s beoordelen die het renderen of PDF‑export kunnen vertragen?
Er is geen enkele complexiteits‑eigenschap. Doorloop Presentation.getSlides en de BaseSlide.getShapes‑collectie van elke dia. Gebruik het aantal vormen en de aanwezigheid van grote afbeeldingen, effecten, animaties of multimedia als screening‑signalen, en meet een representatieve render of export voordat u een dia beschouwt als een bevestigde prestatie‑knelpunt.