Mengambil dan Memperbarui Informasi Presentasi dengan Python

Tentang apa halaman ini

Jelajahi slide, struktur, dan metadata dalam presentasi PowerPoint dan OpenDocument menggunakan Python untuk wawasan lebih cepat dan audit konten yang lebih cerdas.

Ikhtisar

Aspose.Slides dapat mengidentifikasi format presentasi dan membaca metadata dokumennya tanpa membuat model objek presentasi secara lengkap. Hal ini berguna ketika Anda perlu mengklasifikasikan berkas, membuat inventaris, atau memeriksa properti sebelum memutuskan apakah akan memuat dan memproses konten presentasi.

Artikel ini menunjukkan inspeksi ringan melalui PresentationFactory dan PresentationInfo, serta pembaruan terarah melalui DocumentProperties.

Periksa Format Presentasi

Jika Anda sudah memiliki presentasi yang dimuat, lihat Determine the Original Presentation Format untuk deteksi setelah pemuatan dan keterbatasan aliran PPT, PPS, dan POT lama.

Gunakan PresentationFactory.get_presentation_info untuk memeriksa berkas tanpa membuat instance Presentation. Properti PresentationInfo.load_format melaporkan format yang terdeteksi, seperti PPTX, PPT, atau ODP.

import aspose.slides as slides

file_names = ["pres.pptx", "pres.ppt", "pres.odp"]

for file_name in file_names:
    presentation_info = slides.PresentationFactory.instance.get_presentation_info(file_name)
    print(f"{file_name}: {presentation_info.load_format}")

Bangun Inventaris Presentasi Ringan

Ketika Anda memproses banyak berkas presentasi, Anda mungkin memerlukan inventaris yang ringkas untuk validasi, pengindeksan, atau sistem manajemen dokumen. Dalam skenario ini, gunakan PresentationFactory.get_presentation_info untuk mendapatkan objek PresentationInfo , kemudian panggil PresentationInfo.read_document_properties untuk membaca metadata dokumen. Pendekatan ini tidak membuat instance Presentation atau memaksa Anda menelusuri model objek presentasi secara lengkap.

Properti tambahan yang diekspos oleh DocumentProperties menyediakan nilai inventaris berikut:

Properti	Nilai inventaris
slides	Jumlah total slide.
hidden_slides	Jumlah slide tersembunyi.
notes	Jumlah slide yang berisi catatan.
paragraphs	Jumlah total paragraf, bila tersedia.
words	Jumlah total kata.
multimedia_clips	Jumlah total klip audio dan video.

Contoh berikut membaca nilai-nilai ini tanpa membuat objek Presentation dan mencetak inventaris yang ringkas. Ini juga menggabungkan heading_pairs dengan titles_of_parts untuk menampilkan grup konten seperti font, tema, dan judul slide.

import os
import aspose.slides as slides

file_path = "sample.pptx"
presentation_info = slides.PresentationFactory.instance.get_presentation_info(file_path)
document_properties = presentation_info.read_document_properties()

print(f"File: {os.path.basename(file_path)}")
print(f"Format: {presentation_info.load_format}")
print(f"Title: {document_properties.title}")
print(f"Author: {document_properties.author}")
print("Statistics:")
print(f"  Slides: {document_properties.slides}")
print(f"  Hidden slides: {document_properties.hidden_slides}")
print(f"  Slides with notes: {document_properties.notes}")
print(f"  Paragraphs: {document_properties.paragraphs}")
print(f"  Words: {document_properties.words}")
print(f"  Multimedia clips: {document_properties.multimedia_clips}")

heading_pairs = document_properties.heading_pairs or []
titles_of_parts = document_properties.titles_of_parts or []
part_index = 0

if not heading_pairs or not titles_of_parts:
    print("Content groups: not available")
else:
    print("Content groups:")

    for heading_pair in heading_pairs:
        print(f"  {heading_pair.name} ({heading_pair.count})")

        for _ in range(heading_pair.count):
            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

Setiap HeadingPair menyediakan nama grup dan jumlah item dalam grup tersebut. DocumentProperties.titles_of_parts merupakan koleksi datar berurutan, sehingga konsumsi jumlah judul berurutan yang ditentukan oleh setiap heading pair.

Metadata yang Disimpan dan Batasan Format

Properti inventaris yang dikembalikan oleh PresentationInfo.read_document_properties mencerminkan metadata yang tersedia dalam dokumen sumber. Aspose.Slides tidak memuat dan menelusuri model objek presentasi untuk menghitung ulang nilai-nilai ini pada pemanggilan ini. Properti yang tidak ada diwakili oleh nilai default, dan nilai yang disimpan mungkin sudah kadaluarsa jika aplikasi yang terakhir menyimpan berkas tidak memperbarui properti dokumennya.

• PPTX: Format ini menyediakan properti dokumen tambahan untuk hitungan slide, catatan, slide tersembunyi, paragraf, kata, dan multimedia, serta heading pairs dan judul bagian. Ketersediaannya tergantung pada properti mana yang dituliskan oleh pembuat dokumen.
• PPT: Format biner dapat menyimpan properti ringkasan dokumen yang sesuai. Jika suatu properti tidak ada atau tidak diperbarui oleh pembuat dokumen, Aspose.Slides mengembalikan nilai yang disimpan atau nilai default alih-alih menghitungnya dari slide.
• ODP: Metadata OpenDocument menyediakan statistik dokumen umum, seperti jumlah halaman, paragraf, dan kata, tetapi nilai-nilai ini tidak selalu sesuai dengan properti tambahan khusus PowerPoint. Metadata slide tersembunyi, slide catatan, multimedia, heading-pair, dan judul bagian mungkin tidak tersedia, dan properti inventaris dapat mengembalikan nilai default. Jangan menganggap nilai nol atau koleksi kosong sebagai bukti otoritatif bahwa konten yang bersangkutan tidak ada.

Gunakan pendekatan metadata ringan untuk inventaris dan pemeriksaan awal. Muat presentasi dan inspeksi model objek langsungnya ketika hasil harus mencerminkan perubahan di memori atau ketika Anda perlu memverifikasi konten presentasi yang sebenarnya.

Perbarui Properti Presentasi

Properti yang dikembalikan oleh PresentationInfo.read_document_properties juga dapat diubah tanpa membuat instance [Presentation]. Terapkan perubahan dengan PresentationInfo.update_document_properties, lalu tulis presentasi yang terikat dengan PresentationInfo.write_binded_presentation.

Gambar berikut menunjukkan properti dokumen asli dari presentasi PowerPoint:

Contoh berikut mengubah judul dan waktu penyimpanan terakhir serta menulis hasilnya ke berkas baru:

import datetime
import aspose.slides as slides

source_file = "sample.pptx"
output_file = "sample_with_updated_properties.pptx"
presentation_info = slides.PresentationFactory.instance.get_presentation_info(source_file)
document_properties = presentation_info.read_document_properties()

document_properties.title = "Quarterly sales report"
document_properties.last_saved_time = datetime.datetime.now(datetime.timezone.utc)

presentation_info.update_document_properties(document_properties)

with open(output_file, "wb") as output_stream:
    presentation_info.write_binded_presentation(output_stream)

Gambar berikut menunjukkan properti dokumen yang diperbarui dari presentasi PowerPoint:

Tautan Berguna

Untuk pemeriksaan keamanan terkait dan pengaturan perlindungan, lihat artikel berikut:

• Presentasi dengan Perlindungan Kata Sandi
• Presentasi dengan Perlindungan Penulisan

FAQ

Bagaimana cara memeriksa apakah font disematkan dan mana saja yang disematkan?

Muat presentasi dan gunakan Presentation.fonts_manager. Panggil FontsManager.get_embedded_fonts untuk memperoleh font yang disematkan dan FontsManager.get_fonts untuk memperoleh font yang digunakan oleh presentasi. Bandingkan kedua hasil untuk menemukan font yang diperlukan untuk rendering tetapi tidak disematkan.

Bagaimana cara cepat mengetahui apakah berkas memiliki slide tersembunyi dan berapa banyak?

Ketika metadata dokumen yang disimpan cukup, baca DocumentProperties.hidden_slides melalui PresentationFactory.get_presentation_info dan PresentationInfo.read_document_properties. Ini cocok untuk inventaris ringan. Jika presentasi telah dimodifikasi di memori, metadata yang disimpan mungkin tidak ada atau sudah kadaluarsa, atau Anda perlu memverifikasi nilai hidup, iterasi melalui Presentation.slides dan inspeksi properti Slide.hidden setiap slide sebagai gantinya.

Bisakah saya mendeteksi apakah ukuran dan orientasi slide khusus digunakan, dan apakah mereka berbeda dari nilai default?

Ya. Muat presentasi dan baca Presentation.slide_size. Inspeksi SlideSize.type, SlideSize.size, dan SlideSize.orientation untuk membandingkan pengaturan saat ini dengan preset dan dimensi yang diharapkan.

Apakah ada cara cepat untuk melihat apakah grafik merujuk ke sumber data eksternal?

Ya. Temukan setiap Chart dan inspeksi ChartData.data_source_type. Untuk buku kerja eksternal, baca ChartData.external_workbook_path. Jenis sumber data dan jalur mengidentifikasi referensi eksternal, tetapi memverifikasi apakah target tersedia memerlukan pemeriksaan sumber daya terpisah.

Bagaimana saya dapat menilai slide ‘berat’ yang dapat memperlambat rendering atau ekspor PDF?

Tidak ada properti kompleksitas tunggal. Telusuri Presentation.slides dan koleksi BaseSlide.shapes setiap slide. Gunakan jumlah bentuk dan keberadaan gambar besar, efek, animasi, atau multimedia sebagai sinyal penyaringan, dan ukur rendering atau ekspor representatif sebelum menganggap slide sebagai bottleneck kinerja yang terkonfirmasi.