Kelola Properti Presentasi di Python
Pendahuluan
Aspose.Slides untuk Python via Java mendukung properti dokumen built-in dan custom. Gunakan properti ini untuk membaca dan memperbarui metadata presentasi, seperti penulis, judul, dan nilai yang ditentukan pengguna.
Aspose.Slides memungkinkan Anda bekerja dengan properti dokumen presentasi melalui kelas DocumentProperties . Sebuah instance dari kelas ini dikembalikan oleh Presentation.getDocumentProperties. Contoh-contoh berikut menunjukkan cara membaca, mengubah, dan mengelola properti tersebut.
Note
Aspose.Slides mengelola metadata aplikasi dan produsen saat menyimpan presentasi; bidang-bidang ini mengidentifikasi perangkat lunak yang membuat output.Kelola Properti Presentasi
Properti dokumen menyimpan informasi deskriptif bersama konten presentasi. Mereka terbagi menjadi dua kategori:
- Built-in properties berisi metadata standar, seperti judul, penulis, dan statistik dokumen.
- Custom properties menyimpan pasangan nama/nilai yang ditentukan pengguna.
Aspose.Slides untuk Python via Java menyediakan akses ke kedua kategori. Di PowerPoint, pilih File → Info → Properties → Advanced Properties untuk memeriksa metadata dokumen. Dialog mengelompokkan informasi ke dalam tab seperti Summary, Statistics, Contents, dan Custom. Gunakan tab Custom untuk mengelola properti yang ditentukan pengguna.
Baca Properti Publik dari Presentasi yang Dienkripsi
Password pembuka biasanya melindungi baik konten presentasi maupun properti dokumen. Ketika sebuah presentasi dienkripsi setelah memanggil ProtectionManager.setEncryptDocumentProperties dengan False, properti dokumennya tetap publik. Sebuah aplikasi kemudian dapat memanggil LoadOptions.setOnlyLoadDocumentProperties dengan True dan membaca metadata publik tanpa menyertakan password pembuka.
LoadOptions.setOnlyLoadDocumentProperties mengontrol apa yang dimuat Aspose.Slides; itu tidak mendekripsi apa pun. Jika properti termasuk dalam enkripsi, memuatnya tanpa password akan gagal. Jika presentasi tidak dienkripsi, opsi ini diabaikan dan seluruh presentasi dimuat.
Contoh ini memerlukan sebuah presentasi terenkripsi yang properti dokumennya dibiarkan publik. Ia memverifikasi mode pemuatan melalui ProtectionManager.isOnlyDocumentPropertiesLoaded dan kemudian membaca properti built-in melalui Presentation.getDocumentProperties:
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()
Dalam mode ini, konten slide tidak dimuat. Slide, master, tata letak, shape, media, dan objek presentasi lainnya tidak tersedia. Aplikasi harus selalu memeriksa ProtectionManager.isOnlyDocumentPropertiesLoaded sebelum melakukan operasi yang memerlukan model objek presentasi lengkap.
Warning
Metadata publik dapat mengungkapkan nama penulis, judul, subjek, kata kunci, informasi perusahaan, komentar, dan nilai custom. Enkripsi properti sensitif bersama dengan presentasi. Biarkan mereka publik hanya ketika sistem pengindeksan, klasifikasi, pencarian, atau manajemen dokumen memiliki kebutuhan khusus untuk mengaksesnya tanpa password.Perbarui Properti Presentasi yang Dienkripsi
Untuk file PPTX terenkripsi, sebuah presentasi yang dimuat setelah memanggil LoadOptions.setOnlyLoadDocumentProperties dengan True dimaksudkan untuk membaca metadata publik. Aspose.Slides tidak dapat menyimpan properti yang diubah dari objek hanya-metadata tersebut karena properti publik harus tetap konsisten dengan data yang sesuai di dalam presentasi yang terenkripsi. Oleh karena itu memperbarui mereka memerlukan password pembuka yang benar dan pemuatan lengkap.
Contoh ini memerlukan sebuah presentasi PPTX terenkripsi dengan properti dokumen publik dan password pembuka yang diketahui. Ia membuka presentasi lengkap dengan LoadOptions.setPassword, memperbarui properti built-in publik, dan menyimpan hasilnya. Kemudian ia menggunakan PresentationInfo.isEncrypted untuk memverifikasi bahwa enkripsi tetap terjaga dan membuka kembali metadata publik tanpa password untuk memverifikasi nilai baru:
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()
Jika sebuah aplikasi tidak diizinkan mendekripsi atau memuat konten presentasi, ia harus memperlakukan properti publik dari file PPTX terenkripsi sebagai read-only.
Akses Properti Built-in
Kelas DocumentProperties menampilkan metadata built-in melalui metode getter, termasuk getAuthor, getTitle, dan getCreatedTime. Contoh ini membuka presentasi yang ada dan mencetak metadata yang disimpan ke console. Nilai tergantung pada presentasi input; beberapa bidang mungkin kosong.
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()
Modifikasi Properti Built-in
Untuk memperbarui metadata built-in, gunakan metode setter pada objek yang dikembalikan oleh Presentation.getDocumentProperties. Contoh ini membuka presentasi yang ada, memanggil setAuthor, setTitle, setSubject, setComments, dan setManager, kemudian menyimpan presentasi yang diperbarui dengan Presentation.save. PPTX yang disimpan berisi metadata baru.
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()
Kelola Hyperlink Base
DocumentProperties.getHyperlinkBase mengembalikan basis level dokumen untuk hyperlink relatif. Gunakan DocumentProperties.setHyperlinkBase untuk mengubah atau mengosongkannya. Ini berguna saat memindahkan presentasi dan file terkait ke lokasi lain. Ini terpisah dari Hyperlink.getExternalUrl pada hyperlink individual: mengubah basis tidak menulis ulang alamat tautan yang disimpan atau mengubah tujuan absolut.
Contoh ini memerlukan sebuah presentasi yang berisi baik tautan relatif, seperti target.html, dan tautan absolut, seperti https://example.org/absolute.html. Ia membaca basis yang ada, menetapkan alamat basis baru, dan menyimpan serta membuka kembali presentasi untuk memeriksa nilai tersebut. Kemudian ia mengosongkan basis dengan string kosong dan memverifikasi nilai kosong dalam file yang disimpan terpisah. Ganti alamat basis contoh dengan lokasi file terkait Anda.
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()
Dua pesan verifikasi harus mencetak True. Mengosongkan basis meninggalkan alamat hyperlink individual tetap utuh.
Sebuah tautan relatif ke target.pptx membuka old/target.pptx ketika basis menunjuk ke folder old. Setelah mengubah basis ke folder new, menyimpan, dan membuka kembali presentasi, tautan yang sama membuka new/target.pptx. Tautan absolut tetap membuka file yang sama. Uji tautan relatif Anda di PowerPoint sebelum dan sesudah memindahkan presentasi atau mengubah basisnya.
Tambahkan Properti Presentasi Kustom
Properti kustom menyimpan metadata yang tidak memiliki bidang built-in yang sesuai. Metode DocumentProperties.set_Item memungkinkan Anda menetapkan nilai berdasarkan nama properti. Contoh ini membuat sebuah presentasi, menambahkan dua nilai teks dan satu nilai versi integer (menggunakan jpype.JInt untuk melewatkan integer Java), dan menyimpan presentasi dengan Presentation.save. Menetapkan nilai ke nama yang sudah ada menggantikan nilai properti tersebut.
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()
Akses dan Modifikasi Properti Kustom
Contoh ini membuka sebuah presentasi yang berisi properti kustom dan menggunakan getCountOfCustomProperties untuk mengiterasi mereka. getCustomPropertyName menerima indeks berbasis nol dan mengembalikan nama yang digunakan oleh DocumentProperties.set_Item. Contoh mencetak setiap nama dan nilai asli, mengganti setiap nilai dengan string bernomor terlepas dari tipe aslinya, dan menyimpan perubahan. Jika tidak ada properti kustom, loop tidak membuat perubahan.
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()
Contoh Langsung
Coba aplikasi online View & Edit PowerPoint Metadata untuk melihat cara bekerja dengan properti dokumen menggunakan API Aspose.Slides:
FAQ
Bagaimana cara menghapus properti built-in dari sebuah presentasi?
Properti built-in adalah bagian integral dari presentasi dan tidak dapat dihapus sepenuhnya. Namun, Anda dapat mengubah nilainya atau mengosongkannya jika diperbolehkan oleh properti tersebut.
Apa yang terjadi jika saya menambahkan properti kustom yang sudah ada?
Jika Anda menambahkan properti kustom yang sudah ada, nilai yang ada akan ditimpa dengan nilai baru. Anda tidak perlu menghapus atau memeriksa properti tersebut terlebih dahulu, karena Aspose.Slides secara otomatis memperbarui nilai properti.
Bisakah saya mengakses properti presentasi tanpa memuat seluruh presentasi?
Ya. Gunakan PresentationFactory.getPresentationInfo dan kemudian PresentationInfo.readDocumentProperties untuk membaca metadata dokumen yang disimpan tanpa membuat instance Presentation. Lihat Bangun Inventaris Presentasi Ringan untuk contoh pelaporan lengkap dan batasan khusus format.
Bisakah saya membaca properti publik dari presentasi terenkripsi tanpa password pembukanya?
Ya. Presentasi harus dienkripsi setelah memanggil ProtectionManager.setEncryptDocumentProperties dengan False, dan harus dimuat setelah memanggil LoadOptions.setOnlyLoadDocumentProperties dengan True.
Bisakah saya memperbarui file PPTX terenkripsi dalam mode hanya-properti-dokumen?
Tidak. Data properti publik dan terenkripsi harus tetap konsisten, sehingga memperbarui file PPTX terenkripsi memerlukan pemuatan seluruh presentasi dengan password pembuka yang benar.
