Kelola Properti Presentasi dengan Python

Pendahuluan

Aspose.Slides for Python via .NET mendukung properti dokumen bawaan dan kustom. 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 kelas ini dikembalikan oleh Presentation.document_properties. Contoh-contoh berikut menunjukkan cara membaca, memodifikasi, dan mengelola properti ini.

Kelola Properti Presentasi

Properti dokumen menyimpan informasi deskriptif bersama konten presentasi. Mereka terbagi menjadi dua kategori:

  • Properti bawaan berisi metadata standar, seperti judul, penulis, dan statistik dokumen.
  • Properti kustom menyimpan pasangan nama/nilai yang ditentukan pengguna.

Aspose.Slides for Python via .NET 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 Terenkripsi

Kata sandi pembuka biasanya melindungi baik konten presentasi maupun properti dokumen. Ketika sebuah presentasi dienkripsi dengan ProtectionManager.encrypt_document_properties diatur ke False, properti dokumennya tetap publik. Sebuah aplikasi kemudian dapat mengatur LoadOptions.only_load_document_properties ke True dan membaca metadata publik tanpa menyediakan kata sandi pembuka.

LoadOptions.only_load_document_properties mengontrol apa yang dimuat oleh Aspose.Slides; ia tidak mendekripsi apa pun. Jika properti tersebut termasuk dalam enkripsi, memuatnya tanpa kata sandi gagal. Jika presentasi tidak dienkripsi, opsi ini diabaikan dan presentasi lengkap dimuat.

Contoh ini membutuhkan presentasi terenkripsi yang properti dokumennya dibiarkan publik. Ia memverifikasi mode pemuatan melalui ProtectionManager.is_only_document_properties_loaded dan kemudian membaca properti bawaan melalui Presentation.document_properties:

import aspose.slides as slides

load_options = slides.LoadOptions()
load_options.only_load_document_properties = True

with slides.Presentation("public-properties-encrypted.pptx", load_options) as presentation:
    if presentation.protection_manager.is_only_document_properties_loaded:
        document_properties = presentation.document_properties

        print("Author: " + document_properties.author)
        print("Title: " + document_properties.title)
        print("Keywords: " + document_properties.keywords)
    else:
        print("The presentation was not loaded in document-properties-only mode.")

Dalam mode ini, konten slide tidak dimuat. Slide, master, tata letak, bentuk, media, dan objek presentasi lainnya tidak tersedia. Aplikasi harus selalu memeriksa ProtectionManager.is_only_document_properties_loaded sebelum melakukan operasi yang memerlukan model objek presentasi lengkap.

Perbarui Properti dari Presentasi Terenkripsi

Untuk file PPTX terenkripsi, presentasi yang dimuat dengan LoadOptions.only_load_document_properties 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 bersesuaian di dalam presentasi terenkripsi. Memperbarui mereka oleh karena itu memerlukan kata sandi pembuka yang benar dan pemuatan lengkap.

Contoh ini membutuhkan presentasi PPTX terenkripsi dengan properti dokumen publik dan kata sandi pembuka yang diketahui. Ia membuka presentasi lengkap dengan LoadOptions.password, memperbarui properti bawaan publik, dan menyimpan hasilnya. Kemudian ia menggunakan PresentationInfo.is_encrypted untuk memverifikasi bahwa enkripsi dipertahankan dan membuka kembali metadata publik tanpa kata sandi untuk memverifikasi nilai baru:

import aspose.slides as slides

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

load_options = slides.LoadOptions()
load_options.password = "open_password"

with slides.Presentation(input_path, load_options) as presentation:
    document_properties = presentation.document_properties
    document_properties.title = "Updated Product Roadmap"
    document_properties.keywords = "roadmap, planning, indexed"
    
    presentation.save(output_path, slides.export.SaveFormat.PPTX)

presentation_info = slides.PresentationFactory.instance.get_presentation_info(output_path)
print("The presentation is encrypted: " + str(presentation_info.is_encrypted))

metadata_load_options = slides.LoadOptions()
metadata_load_options.only_load_document_properties = True

with slides.Presentation(output_path, metadata_load_options) as metadata_presentation:
    if metadata_presentation.protection_manager.is_only_document_properties_loaded:
        print("Title: " + metadata_presentation.document_properties.title)
        print("Keywords: " + metadata_presentation.document_properties.keywords)
    else:
        print("The presentation was not loaded in document-properties-only mode.")

Jika sebuah aplikasi tidak diizinkan mendekripsi atau memuat konten presentasi, ia harus memperlakukan properti publik dari file PPTX terenkripsi sebagai hanya‑baca.

Akses Properti Bawaan

Kelas DocumentProperties menampilkan metadata bawaan melalui properti bertipe, termasuk DocumentProperties.author, DocumentProperties.title, dan DocumentProperties.created_time. Contoh ini membuka presentasi yang ada dan mencetak metadata yang disimpan ke konsol. Nilai tergantung pada presentasi input; beberapa bidang mungkin kosong.

import aspose.slides as slides

with slides.Presentation("AccessBuiltInProperties.pptx") as presentation:
    document_properties = presentation.document_properties

    print("Category:", document_properties.category)
    print("Content status:", document_properties.content_status)
    print("Creation date:", document_properties.created_time)
    print("Author:", document_properties.author)
    print("Comments:", document_properties.comments)
    print("Keywords:", document_properties.keywords)
    print("Last modified by:", document_properties.last_saved_by)
    print("Manager:", document_properties.manager)
    print("Modified date:", document_properties.last_saved_time)
    print("Presentation format:", document_properties.presentation_format)
    print("Last print date:", document_properties.last_printed)
    print("Is shared between producers:", document_properties.shared_doc)
    print("Subject:", document_properties.subject)
    print("Title:", document_properties.title)

Modifikasi Properti Bawaan

Untuk memperbarui metadata bawaan, tetapkan nilai ke properti yang dapat ditulis yang ditampilkan oleh Presentation.document_properties. Contoh ini membuka presentasi yang ada, mengatur DocumentProperties.author, DocumentProperties.title, DocumentProperties.subject, DocumentProperties.comments, dan DocumentProperties.manager, kemudian menyimpan presentasi yang diperbarui dengan Presentation.save. PPTX yang disimpan berisi metadata baru.

import aspose.slides as slides

with slides.Presentation("ModifyBuiltInProperties.pptx") as presentation:
    document_properties = presentation.document_properties

    document_properties.author = "Aspose.Slides for Python via .NET"
    document_properties.title = "Manage PowerPoint Presentation Properties"
    document_properties.subject = "Modify Built-in Properties"
    document_properties.comments = "Aspose description"
    document_properties.manager = "Aspose manager"

    presentation.save("DocumentProperties_output.pptx", slides.export.SaveFormat.PPTX)

DocumentProperties.hyperlink_base menyimpan basis tingkat dokumen untuk hyperlink relatif. Ini berguna saat memindahkan presentasi dan file terkait ke lokasi lain. Ini terpisah dari Hyperlink.external_url pada hyperlink individu: mengubah basis tidak menulis ulang alamat tautan yang disimpan atau mengubah tujuan absolut.

Contoh ini membutuhkan presentasi yang berisi baik tautan relatif, seperti target.html, maupun tautan absolut ke file atau situs web. Ia membaca basis yang ada, menetapkan alamat basis baru, dan menyimpan serta membuka kembali presentasi untuk memeriksa nilai tersebut. Selanjutnya ia mengosongkan basis dengan "" dan memverifikasi nilai kosong dalam file terpisah yang disimpan. Ganti alamat basis contoh dengan lokasi file terkait Anda.

import aspose.slides as slides

with slides.Presentation("hyperlinks.pptx") as presentation:
    print("Original base:", presentation.document_properties.hyperlink_base)

    new_base = "https://example.com/new/"
    presentation.document_properties.hyperlink_base = new_base
    presentation.save("hyperlinks-updated.pptx", slides.export.SaveFormat.PPTX)

with slides.Presentation("hyperlinks-updated.pptx") as updated_presentation:
    print("Base preserved:", updated_presentation.document_properties.hyperlink_base == new_base)

    updated_presentation.document_properties.hyperlink_base = ""
    updated_presentation.save("hyperlinks-cleared.pptx", slides.export.SaveFormat.PPTX)

with slides.Presentation("hyperlinks-cleared.pptx") as cleared_presentation:
    print("Base cleared:", cleared_presentation.document_properties.hyperlink_base == "")

Dua pesan verifikasi harus mencetak True. Mengosongkan basis meninggalkan alamat hyperlink individu tetap utuh.

Sebuah tautan relatif ke target.pptx membuka old/target.pptx ketika basis mengarah ke folder old. Setelah mengubah basis ke folder new, menyimpan, dan membuka kembali presentasi, tautan yang sama membuka new/target.pptx. Tautan absolut terus membuka file yang sama. Uji tautan relatif Anda di PowerPoint sebelum dan setelah memindahkan presentasi atau mengubah basisnya.

Tambahkan Properti Presentasi Kustom

Properti kustom menyimpan metadata yang tidak memiliki bidang bawaan yang terkait. Metode DocumentProperties.set_custom_property_value memungkinkan Anda menetapkan nilai berdasarkan nama properti. Contoh ini membuat sebuah presentasi, menambahkan dua nilai teks dan satu nilai versi integer, dan menyimpan presentasi dengan Presentation.save. Menetapkan nilai ke nama yang sudah ada menggantikan nilai properti tersebut.

import aspose.slides as slides

with slides.Presentation() as presentation:
    document_properties = presentation.document_properties

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

    presentation.save("CustomDocumentProperties_output.pptx", slides.export.SaveFormat.PPTX)

Akses dan Modifikasi Properti Kustom

Contoh ini membuka sebuah presentasi yang berisi properti kustom dan menggunakan DocumentProperties.count_of_custom_properties untuk mengiterasi mereka. DocumentProperties.get_custom_property_name menerima indeks berbasis nol dan mengembalikan nama yang digunakan oleh DocumentProperties.set_custom_property_value. Contoh ini membutuhkan sebuah presentasi yang semua properti kustomnya berupa string. Ia mencetak setiap nama dan nilai asli, mengganti setiap nilai dengan string bernomor, dan menyimpan perubahan. Jika tidak ada properti kustom, loop tidak melakukan perubahan.

import aspose.slides as slides

with slides.Presentation("AccessAndModifyProperties.pptx") as presentation:
    document_properties = presentation.document_properties

    for i in range(document_properties.count_of_custom_properties):
        property_name = document_properties.get_custom_property_name(i)
        property_value = [""]
        document_properties.get_custom_property_value(property_name, property_value)

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

        document_properties.set_custom_property_value(property_name, "New Value " + str(i + 1))

    presentation.save("CustomProperties_output.pptx", slides.export.SaveFormat.PPTX)

DocumentProperties.get_custom_property_value mengembalikan nilai melalui daftar satu elemen yang diberikan sebagai argumen kedua. Placeholder harus sesuai dengan tipe properti yang disimpan: gunakan [""] untuk string atau [0] untuk integer. Tipe yang tidak cocok akan menimbulkan InvalidCastException; pilih placeholder sesuai skema properti‑kustom Anda.

Contoh Langsung

Coba aplikasi daring View & Edit PowerPoint Metadata untuk melihat cara bekerja dengan properti dokumen menggunakan API Aspose.Slides:

View & Edit PowerPoint Metadata

FAQ

Bagaimana saya dapat menghapus properti bawaan dari sebuah presentasi?

Properti bawaan merupakan bagian integral dari presentasi dan tidak dapat dihapus sepenuhnya. Namun, Anda dapat mengubah nilainya atau mengosongkannya jika properti tersebut memperbolehkan.

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 sebelumnya, karena Aspose.Slides secara otomatis memperbarui nilai properti.

Bisakah saya mengakses properti presentasi tanpa memuat seluruh presentasi?

Ya. Gunakan PresentationFactory.get_presentation_info lalu PresentationInfo.read_document_properties untuk membaca metadata dokumen yang disimpan tanpa membuat instance Presentation. Lihat Build a Lightweight Presentation Inventory untuk contoh pelaporan lengkap dan batasan format‑spesifik.

Bisakah saya membaca properti publik dari presentasi terenkripsi tanpa kata sandi pembukanya?

Ya. Presentasi harus dienkripsi dengan ProtectionManager.encrypt_document_properties disetel ke False, dan harus dimuat dengan LoadOptions.only_load_document_properties disetel ke 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 lengkap presentasi dengan kata sandi pembuka yang benar.