Mengambil dan Memperbarui Informasi Presentasi dalam JavaScript

Tentang apa halaman ini

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

Gambaran Umum

Aspose.Slides dapat mengidentifikasi format presentasi dan membaca metadata dokumen tanpa membuat model objek presentasi lengkap. Hal ini berguna ketika Anda perlu mengklasifikasikan file, 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

Gunakan PresentationFactory.getPresentationInfo untuk memeriksa file tanpa membuat instance Presentation. Metode PresentationInfo.getLoadFormat melaporkan format yang terdeteksi, misalnya PPTX, PPT, atau ODP.

const aspose = require("aspose.slides.via.java");

const fileNames = ["pres.pptx", "pres.ppt", "pres.odp"];

for (const fileName of fileNames) {
    const presentationInfo = aspose.PresentationFactory.getInstance().getPresentationInfo(fileName);
    const loadFormat = presentationInfo.getLoadFormat();
    let formatName = `Other (${loadFormat})`;

    if (loadFormat === aspose.LoadFormat.Pptx) {
        formatName = "PPTX";
    } else if (loadFormat === aspose.LoadFormat.Ppt) {
        formatName = "PPT";
    } else if (loadFormat === aspose.LoadFormat.Odp) {
        formatName = "ODP";
    }

    console.log(`${fileName}: ${formatName}`);
}

Membangun Inventaris Presentasi Ringan

Saat Anda memproses banyak file presentasi, Anda mungkin memerlukan inventaris ringkas untuk validasi, pengindeksan, atau sistem manajemen dokumen. Dalam skenario ini, gunakan PresentationFactory.getPresentationInfo untuk memperoleh objek PresentationInfo, kemudian panggil PresentationInfo.readDocumentProperties untuk membaca metadata dokumen. Pendekatan ini tidak membuat instance Presentation atau memaksa Anda menelusuri model objek presentasi lengkap.

Properti tambahan yang disediakan oleh DocumentProperties memberikan nilai inventaris berikut:

Metode	Nilai inventaris
getSlides	Jumlah total slide.
getHiddenSlides	Jumlah slide tersembunyi.
getNotes	Jumlah slide yang berisi catatan.
getParagraphs	Jumlah total paragraf, bila tersedia.
getWords	Jumlah total kata.
getMultimediaClips	Jumlah total klip audio dan video.

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

const path = require("path");
const aspose = require("aspose.slides.via.java");

const filePath = "sample.pptx";
const presentationInfo = aspose.PresentationFactory.getInstance().getPresentationInfo(filePath);
const documentProperties = presentationInfo.readDocumentProperties();

const loadFormat = presentationInfo.getLoadFormat();
let formatName = `Other (${loadFormat})`;

if (loadFormat === aspose.LoadFormat.Pptx) {
    formatName = "PPTX";
} else if (loadFormat === aspose.LoadFormat.Ppt) {
    formatName = "PPT";
} else if (loadFormat === aspose.LoadFormat.Odp) {
    formatName = "ODP";
}

console.log(`File: ${path.basename(filePath)}`);
console.log(`Format: ${formatName}`);
console.log(`Title: ${documentProperties.getTitle()}`);
console.log(`Author: ${documentProperties.getAuthor()}`);
console.log("Statistics:");
console.log(`  Slides: ${documentProperties.getSlides()}`);
console.log(`  Hidden slides: ${documentProperties.getHiddenSlides()}`);
console.log(`  Slides with notes: ${documentProperties.getNotes()}`);
console.log(`  Paragraphs: ${documentProperties.getParagraphs()}`);
console.log(`  Words: ${documentProperties.getWords()}`);
console.log(`  Multimedia clips: ${documentProperties.getMultimediaClips()}`);

const headingPairs = documentProperties.getHeadingPairs() || [];
const titlesOfParts = documentProperties.getTitlesOfParts() || [];
let partIndex = 0;

if (headingPairs.length === 0 || titlesOfParts.length === 0) {
    console.log("Content groups: not available");
} else {
    console.log("Content groups:");

    for (const headingPair of headingPairs) {
        const partCount = headingPair.getCount();
        console.log(`  ${headingPair.getName()} (${partCount})`);

        for (let partOffset = 0; partOffset < partCount && partIndex < titlesOfParts.length; partOffset++) {
            console.log(`    - ${titlesOfParts[partIndex]}`);
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.length) {
        console.log("  Other parts:");

        while (partIndex < titlesOfParts.length) {
            console.log(`    - ${titlesOfParts[partIndex]}`);
            partIndex++;
        }
    }
}

Setiap HeadingPair menyediakan nama grup melalui HeadingPair.getName dan jumlah item dalam grup tersebut melalui HeadingPair.getCount. DocumentProperties.getTitlesOfParts mengembalikan array datar yang terurut, sehingga gunakan jumlah judul berurutan yang ditentukan oleh setiap heading pair.

Metadata yang Disimpan dan Batasan Format

Properti inventaris yang dikembalikan oleh PresentationInfo.readDocumentProperties 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 hilang direpresentasikan oleh nilai default, dan nilai yang disimpan dapat menjadi usang jika aplikasi yang terakhir menyimpan file tidak memperbarui properti dokumennya.

PPTX: Format ini menyediakan properti dokumen tambahan untuk hitungan slide, catatan, slide tersembunyi, paragraf, kata, dan multimedia, serta heading pair dan judul bagian. Ketersediaannya bergantung pada properti mana yang ditulis 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 hitungan halaman, paragraf, dan kata, tetapi nilai-nilai ini tidak selalu berkorespondensi dengan properti tambahan khusus PowerPoint. Metadata slide tersembunyi, catatan slide, multimedia, heading pair, dan judul bagian mungkin tidak tersedia, dan properti inventaris dapat mengembalikan nilai default. Jangan anggap nilai nol atau array kosong sebagai bukti otoritatif bahwa konten terkait tidak ada.

Gunakan pendekatan metadata ringan untuk inventaris dan pemeriksaan pendahuluan. Muat presentasi dan inspeksi model objek langsung ketika hasil harus mencerminkan perubahan dalam memori atau ketika Anda perlu memverifikasi konten presentasi sebenarnya.

Memperbarui Properti Presentasi

Properti yang dikembalikan oleh PresentationInfo.readDocumentProperties juga dapat diubah tanpa membuat instance Presentation. Terapkan perubahan dengan PresentationInfo.updateDocumentProperties, lalu tulis presentasi yang terikat dengan PresentationInfo.writeBindedPresentation.

Gambar berikut menunjukkan properti dokumen asli dari presentasi PowerPoint.

Properti dokumen asli dari presentasi PowerPoint

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

const aspose = require("aspose.slides.via.java");
const java = require("java");

const sourceFile = "sample.pptx";
const outputFile = "sample_with_updated_properties.pptx";
const presentationInfo = aspose.PresentationFactory.getInstance().getPresentationInfo(sourceFile);
const documentProperties = presentationInfo.readDocumentProperties();

documentProperties.setTitle("Quarterly sales report");
documentProperties.setLastSavedTime(java.newInstanceSync("java.util.Date"));

presentationInfo.updateDocumentProperties(documentProperties);
const outputStream = java.newInstanceSync("java.io.FileOutputStream", outputFile);
try {
    presentationInfo.writeBindedPresentation(outputStream);
} finally {
    outputStream.close();
}

Gambar berikut menunjukkan properti dokumen yang diubah dari presentasi PowerPoint.

Properti dokumen yang diubah dari presentasi PowerPoint

Tautan Berguna

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

FAQ

Bagaimana cara memeriksa apakah font ter-embed dan font mana saja?

Muat presentasi dan gunakan Presentation.getFontsManager. Panggil FontsManager.getEmbeddedFonts untuk memperoleh font yang ter-embed dan FontsManager.getFonts untuk memperoleh font yang digunakan oleh presentasi. Bandingkan kedua hasil untuk menemukan font yang diperlukan untuk rendering tetapi tidak ter-embed.

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

Ketika metadata dokumen yang disimpan cukup, baca DocumentProperties.getHiddenSlides melalui PresentationFactory.getPresentationInfo dan PresentationInfo.readDocumentProperties. Ini cocok untuk inventaris ringan. Jika presentasi telah dimodifikasi dalam memori, metadata yang disimpan mungkin hilang atau usang, atau Anda perlu memverifikasi nilai hidup, iterasi melalui Presentation.getSlides dan periksa metode Slide.getHidden tiap slide.

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

Ya. Muat presentasi dan panggil Presentation.getSlideSize. Gunakan SlideSize.getType, SlideSize.getSize, dan SlideSize.getOrientation untuk membandingkan pengaturan saat ini dengan preset dan dimensi yang diharapkan.

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

Ya. Temukan tiap Chart dan panggil ChartData.getDataSourceType. Untuk buku kerja eksternal, panggil ChartData.getExternalWorkbookPath. Jenis sumber data dan jalur mengidentifikasi referensi eksternal, tetapi memverifikasi ketersediaan target memerlukan pemeriksaan sumber daya terpisah.

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

Tidak ada properti kompleksitas tunggal. Telusuri Presentation.getSlides dan koleksi BaseSlide.getShapes tiap slide. Gunakan hitungan shape dan keberadaan gambar besar, efek, animasi, atau multimedia sebagai sinyal penyaringan, dan ukur render atau ekspor representatif sebelum menganggap slide sebagai bottleneck kinerja yang terkonfirmasi.

Membuka Presentasi dalam JavaScript Menggabungkan Presentasi Secara Efisien dengan JavaScript