Prezentáció tulajdonságok kezelése Pythonban

Bevezetés

Az Aspose.Slides for Python via Java támogatja a beépített és egyedi dokumentumtulajdonságokat. Ezeket a tulajdonságokat használhatja a bemutató metaadatainak olvasására és frissítésére, például a szerző, a cím és a felhasználó által megadott értékek esetén.

Az Aspose.Slides lehetővé teszi a bemutató dokumentumtulajdonságokkal való munkát a DocumentProperties osztályon keresztül. Ennek az osztálynak egy példánya a Presentation.getDocumentProperties hívásával kapható vissza. A következő példák bemutatják, hogyan lehet ezeket a tulajdonságokat olvasni, módosítani és kezelni.

A bemutató tulajdonságainak kezelése

A dokumentumtulajdonságok leíró információkat tárolnak a bemutató tartalma mellett. Két kategóriába sorolhatók:

  • Beépített tulajdonságok szabványos metaadatokat tartalmaznak, például a címet, a szerzőt és a dokumentumstatisztikákat.
  • Egyedi tulajdonságok felhasználó által meghatározott név/érték párokat tárolnak.

Az Aspose.Slides for Python via Java hozzáférést biztosít mindkét kategóriához. PowerPointban válassza a File → Info → Properties → Advanced Properties menüpontot a dokumentum metaadatainak megtekintéséhez. A párbeszédablak információkat csoportosít fülekre, mint a Summary, Statistics, Contents és Custom. Az Custom fül használatával kezelheti a felhasználó által definiált tulajdonságokat.

Nyilvános tulajdonságok olvasása titkosított bemutatóból

A nyitó jelszó általában a bemutató tartalmát és a dokumentumtulajdonságokat is védi. Ha a bemutatót a ProtectionManager.setEncryptDocumentProperties False értékkel történő meghívása után titkosítják, a dokumentumtulajdonságok nyilvánosak maradnak. Egy alkalmazás ekkor a LoadOptions.setOnlyLoadDocumentProperties True értékkel hívhatja meg, és a nyitó jelszó megadása nélkül olvashatja a nyilvános metaadatokat.

LoadOptions.setOnlyLoadDocumentProperties szabályozza, hogy az Aspose.Slides mit tölt be; nem hajt végre semmilyen dekódolást. Ha a tulajdonságok a titkosítás részei voltak, a jelszó nélkül történő betöltés meghiúsul. Ha a bemutató nincs titkosítva, az opció figyelmen kívül marad, és a teljes bemutató betöltődik.

A példa egy titkosított bemutatót igényel, amelynek a dokumentumtulajdonságai nyilvánosak maradtak. A betöltési módot a ProtectionManager.isOnlyDocumentPropertiesLoaded segítségével ellenőrzi, majd a beépített tulajdonságokat a Presentation.getDocumentProperties segítségével olvassa:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, LoadOptions

load_options = LoadOptions()
load_options.setOnlyLoadDocumentProperties(True)

presentation = Presentation("public-properties-encrypted.pptx", load_options)
try:
    if presentation.getProtectionManager().isOnlyDocumentPropertiesLoaded():
        properties = presentation.getDocumentProperties()

        print("Author: ", properties.getAuthor())
        print("Title: ", properties.getTitle())
        print("Keywords: ", properties.getKeywords())
    else:
        print("The presentation was not loaded in document-properties-only mode.")

finally:
    presentation.dispose()

Ebben a módban a dia tartalma nem töltődik be. A diák, mesterdiák, elrendezések, alakzatok, média és egyéb bemutatóobjektumok nem érhetők el. Az alkalmazásoknak mindig ellenőrizniük kell a ProtectionManager.isOnlyDocumentPropertiesLoaded állapotát, mielőtt olyan műveletet végeznek, amely a teljes bemutató objektummodellt igényli.

Titkosított bemutató tulajdonságainak frissítése

Titkosított PPTX fájl esetén a LoadOptions.setOnlyLoadDocumentProperties True értékkel történő meghívása után betöltött bemutató csak a nyilvános metaadatok olvasására szolgál. Az Aspose.Slides nem tudja menteni a módosított tulajdonságokat ebből a kizárólag metaadatokat tartalmazó objektumból, mivel a nyilvános tulajdonságoknak összhangban kell lenniük a titkosított bemutató megfelelő adataival. Ennek frissítése ezért a megfelelő nyitó jelszót és a teljes betöltést igényli.

A példa egy titkosított PPTX bemutatót igényel, amelynek a dokumentumtulajdonságai nyilvánosak, és egy ismert nyitó jelszóval rendelkezik. A teljes bemutatót a LoadOptions.setPassword segítségével nyitja meg, frissíti a nyilvános beépített tulajdonságokat, és elmenti az eredményt. Ezután a PresentationInfo.isEncrypted használatával ellenőrzi, hogy a titkosítás megmaradt-e, és a jelszó nélkül újra megnyitja a nyilvános metaadatokat az új értékek ellenőrzéséhez:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, LoadOptions, PresentationFactory, SaveFormat

input_path = "public-properties-encrypted.pptx"
output_path = "updated-public-properties-encrypted.pptx"

load_options = LoadOptions()
load_options.setPassword("open_password")

presentation = Presentation(input_path, load_options)
try:
    presentation.getDocumentProperties().setTitle("Updated Product Roadmap")
    presentation.getDocumentProperties().setKeywords("roadmap, planning, indexed")
    
    presentation.save(output_path, SaveFormat.Pptx)
finally:
    presentation.dispose()

presentation_info = PresentationFactory.getInstance().getPresentationInfo(output_path)
print("The presentation is encrypted: ", presentation_info.isEncrypted())

metadata_load_options = LoadOptions()
metadata_load_options.setOnlyLoadDocumentProperties(True)

metadata_presentation = Presentation(output_path, metadata_load_options)
try:
    if metadata_presentation.getProtectionManager().isOnlyDocumentPropertiesLoaded():
        print("Title: ", metadata_presentation.getDocumentProperties().getTitle())
        print("Keywords: ", metadata_presentation.getDocumentProperties().getKeywords())
    else:
        print("The presentation was not loaded in document-properties-only mode.")

finally:
    metadata_presentation.dispose()

Ha egy alkalmazás nem engedélyezett a bemutató tartalmának dekódolására vagy betöltésére, akkor a titkosított PPTX fájl nyilvános tulajdonságait csak olvasási módban kell kezelnie.

Beépített tulajdonságok elérése

A DocumentProperties osztály getter metódusokkal teszi elérhetővé a beépített metaadatokat, többek között a getAuthor, getTitle és a getCreatedTime metódusokkal. Ez a példa megnyit egy meglévő bemutatót, és a tárolt metaadatait a konzolra írja ki. Az értékek a bemeneti bemutatótól függenek; egyes mezők üresek lehetnek.

import jpype
import asposeslides

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

from asposeslides.api import Presentation

presentation = Presentation("AccessBuiltInProperties.pptx")
try:
    document_properties = presentation.getDocumentProperties()

    print("Category:", document_properties.getCategory())
    print("Content status:", document_properties.getContentStatus())
    print("Creation date:", document_properties.getCreatedTime())
    print("Author:", document_properties.getAuthor())
    print("Comments:", document_properties.getComments())
    print("Keywords:", document_properties.getKeywords())
    print("Last modified by:", document_properties.getLastSavedBy())
    print("Manager:", document_properties.getManager())
    print("Modified date:", document_properties.getLastSavedTime())
    print("Presentation format:", document_properties.getPresentationFormat())
    print("Last print date:", document_properties.getLastPrinted())
    print("Is shared between producers:", document_properties.getSharedDoc())
    print("Subject:", document_properties.getSubject())
    print("Title:", document_properties.getTitle())
finally:
    presentation.dispose()

Beépített tulajdonságok módosítása

A beépített metaadatok frissítéséhez használja a setter metódusokat a Presentation.getDocumentProperties által visszaadott objektumon. Ez a példa megnyit egy meglévő bemutatót, meghívja a setAuthor, setTitle, setSubject, setComments és setManager metódusokat, majd a Presentation.save segítségével elmenti a frissített bemutatót. A mentett PPTX a új metaadatokat tartalmazza.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("ModifyBuiltInProperties.pptx")
try:
    document_properties = presentation.getDocumentProperties()

    document_properties.setAuthor("Aspose.Slides for Python via Java")
    document_properties.setTitle("Manage PowerPoint Presentation Properties")
    document_properties.setSubject("Modify Built-in Properties")
    document_properties.setComments("Aspose description")
    document_properties.setManager("Aspose manager")

    presentation.save("DocumentProperties_output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

A hiperhivatkozás alapjának kezelése

A DocumentProperties.getHyperlinkBase visszaadja a dokumentumszintű alapot a relatív hiperhivatkozásokhoz. A DocumentProperties.setHyperlinkBase használatával módosítható vagy törölhető ez az alap. Hasznos, ha egy bemutatót és a hozzá kapcsolódó fájlokat más helyre helyezi. Ez különálló az egyes hiperhivatkozások Hyperlink.getExternalUrl metódusától: az alap módosítása nem írja felül a tárolt hivatkozási címeket, és nem változtatja meg az abszolút célokat.

A példa olyan bemutatót igényel, amely tartalmaz egy relatív hivatkozást, például target.html, valamint egy abszolút hivatkozást, például https://example.org/absolute.html. Kiolvassa a meglévő alapot, új alapcímre állítja, majd elmenti és újra megnyitja a bemutatót az érték ellenőrzéséhez. Ezután egy üres karakterlánccal törli az alapot, és egy külön mentett fájlban ellenőrzi az üres értéket. Cserélje le a példában szereplő alapcímet a saját hivatkozott fájljai helyére.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("hyperlinks.pptx")
try:
    print("Original base:", presentation.getDocumentProperties().getHyperlinkBase())

    new_base = "https://example.com/new/"
    presentation.getDocumentProperties().setHyperlinkBase(new_base)
    presentation.save("hyperlinks-updated.pptx", SaveFormat.Pptx)

    updated_presentation = Presentation("hyperlinks-updated.pptx")
    try:
        print("Base preserved:", new_base == updated_presentation.getDocumentProperties().getHyperlinkBase())

        updated_presentation.getDocumentProperties().setHyperlinkBase("")
        updated_presentation.save("hyperlinks-cleared.pptx", SaveFormat.Pptx)

        cleared_presentation = Presentation("hyperlinks-cleared.pptx")
        try:
            print("Base cleared:", "" == cleared_presentation.getDocumentProperties().getHyperlinkBase())
        finally:
            cleared_presentation.dispose()
    finally:
        updated_presentation.dispose()
finally:
    presentation.dispose()

A két ellenőrző üzenetnek True értéket kell kiírnia. Az alap törlése nem érinti az egyes hiperhivatkozások címét.

Egy relatív hivatkozás a target.pptx fájlra az old/target.pptx-t nyitotta meg, amikor az alap az old mappára mutatott. Az alap new mappára való módosítása, a mentés és a bemutató újbóli megnyitása után ugyanaz a hivatkozás a new/target.pptx-t nyitotta meg. Egy abszolút hivatkozás továbbra is ugyanazt a fájlt nyitotta meg. Tesztelje a relatív hivatkozásait a PowerPointban a bemutató áthelyezése vagy az alap megváltoztatása előtt és után.

Egyedi bemutatótulajdonságok hozzáadása

Az egyedi tulajdonságok olyan metaadatokat tárolnak, amelyeknek nincs megfelelő beépített mezője. A DocumentProperties.set_Item metódus lehetővé teszi a tulajdonság nevének megadásával történő érték hozzárendelését. Ez a példa létrehoz egy bemutatót, hozzáad két szöveges értéket és egy egész verzióértéket (a jpype.JInt használatával Java egész szám átadásához), majd a Presentation.save segítségével elmenti a bemutatót. Egy meglévő névhez érték hozzárendelése felülírja a tulajdonság értékét.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    document_properties = presentation.getDocumentProperties()

    document_properties.set_Item("Reviewed by", "John Smith")
    document_properties.set_Item("Confidentiality level", "Internal")
    document_properties.set_Item("Document version", jpype.JInt(2))

    presentation.save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Egyedi tulajdonságok elérése és módosítása

Ez a példa megnyit egy olyan bemutatót, amely egyedi tulajdonságokat tartalmaz, és a getCountOfCustomProperties segítségével iterálja őket. A getCustomPropertyName nulla-alapú indexet fogad és visszaadja a DocumentProperties.set_Item által használt nevet. A példa kiírja minden eredeti nevet és értéket, minden értéket egy számozott karakterláncra cserél az eredeti típusától függetlenül, és elmenti a változtatásokat. Ha nincsenek egyedi tulajdonságok, a ciklus nem hajt végre változtatást.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("AccessAndModifyProperties.pptx")
try:
    document_properties = presentation.getDocumentProperties()

    for i in range(document_properties.getCountOfCustomProperties()):
        property_name = document_properties.getCustomPropertyName(i)
        property_value = document_properties.get_Item(property_name)

        print("Custom property name:", property_name)
        print("Custom property value:", property_value)

        document_properties.set_Item(property_name, f"New Value {i + 1}")

    presentation.save("CustomProperties_output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Élő példa

Próbálja ki a View & Edit PowerPoint Metadata online alkalmazást, hogy lássa, hogyan lehet a dokumentumtulajdonságokkal dolgozni az Aspose.Slides API használatával:

PowerPoint metaadatok megtekintése és szerkesztése

GYIK

Hogyan távolíthatok el egy beépített tulajdonságot egy bemutatóból?

A beépített tulajdonságok a bemutató integrált részét képezik, és nem távolíthatók el teljesen. Azonban megváltoztathatja az értékeiket, vagy ha a konkrét tulajdonság engedi, beállíthatja őket üresnek.

Mi történik, ha olyan egyedi tulajdonságot adok hozzá, amely már létezik?

Ha olyan egyedi tulajdonságot ad hozzá, amely már létezik, a meglévő értéke felülíródik az újjal. Nem szükséges a tulajdonságot előzetesen eltávolítani vagy ellenőrizni, mivel az Aspose.Slides automatikusan frissíti a tulajdonság értékét.

Elérhetem a bemutató tulajdonságait anélkül, hogy teljesen betölteném a bemutatót?

Igen. Használja a PresentationFactory.getPresentationInfo és ezután a PresentationInfo.readDocumentProperties metódusokat, hogy a tárolt dokumentum metaadatait olvassa anélkül, hogy Presentation példányt hozna létre. Lásd a Build a Lightweight Presentation Inventory példát a teljes jelentéskészítési példa és a formátumspecifikus korlátozások megtekintéséhez.

Olvashatok nyilvános tulajdonságokat egy titkosított bemutatóból a nyitó jelszó nélkül?

Igen. A bemutatónak úgy kell titkosítva lennie, hogy a ProtectionManager.setEncryptDocumentProperties False értékkel lett meghívva, és a LoadOptions.setOnlyLoadDocumentProperties True értékkel történő meghívása után lett betöltve.

Frissíthetek egy titkosított PPTX fájlt csak a dokumentumtulajdonságok módjában?

Nem. A nyilvános és a titkosított tulajdonságadatoknak összhangban kell maradniuk, ezért egy titkosított PPTX fájl frissítéséhez a teljes bemutatót a megfelelő nyitó jelszóval kell betölteni.