检索并更新 JavaScript 中的演示文稿信息

本页内容简介

使用 JavaScript 探索 PowerPoint 和 OpenDocument 演示文稿中的幻灯片、结构和元数据，以实现更快的洞察和更智能的内容审计。

概述

Aspose.Slides 能够识别演示文稿的格式并读取其文档元数据，而无需创建完整的演示文稿对象模型。这在需要对文件进行分类、建立清单或在决定是否加载和处理演示文稿内容之前检查属性时非常有用。

本文演示了通过 PresentationFactory 和 PresentationInfo 进行轻量检查，以及通过 DocumentProperties 进行有针对性的更新。

检查演示文稿格式

如果您已经加载了演示文稿，请参阅 Determine the Original Presentation Format 了解加载后检测以及传统 PPT、PPS 和 POT 流的限制。

使用 PresentationFactory.getPresentationInfo 可在不创建 Presentation 实例的情况下检查文件。PresentationInfo.getLoadFormat 方法会报告检测到的格式，例如 PPTX、PPT 或 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}`);
}

构建轻量演示文稿清单

当您处理大量演示文稿文件时，可能需要一个紧凑的清单用于验证、索引或文档管理系统。在这种情况下，使用 PresentationFactory.getPresentationInfo 获取 PresentationInfo 对象，然后调用 PresentationInfo.readDocumentProperties 读取文档元数据。此方法不会创建 Presentation 实例，也不需要遍历完整的演示文稿对象模型。

DocumentProperties 暴露的扩展属性提供以下清单值：

方法	清单值
getSlides	幻灯片总数。
getHiddenSlides	隐藏的幻灯片数量。
getNotes	包含批注的幻灯片数量。
getParagraphs	可用时的段落总数。
getWords	单词总数。
getMultimediaClips	音视频剪辑总数。

下面的示例在不创建 Presentation 对象的情况下读取这些值并打印紧凑的清单。它还将 DocumentProperties.getHeadingPairs 与 DocumentProperties.getTitlesOfParts 结合使用，以显示字体、主题和幻灯片标题等内容组。

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++;
        }
    }
}

每个 HeadingPair 通过 HeadingPair.getName 提供组名，并通过 HeadingPair.getCount 提供该组中的项目数。DocumentProperties.getTitlesOfParts 返回一个平坦、有序的数组，因此需要按每个标题对指定的连续标题数量进行消费。

存储的元数据和格式限制

由 PresentationInfo.readDocumentProperties 返回的清单属性反映了源文档中可用的元数据。Aspose.Slides 不会加载并遍历演示文稿对象模型来重新计算这些值。缺失的属性使用默认值表示，如果上一次保存文件的应用程序未更新其文档属性，则存储的值可能已过时。

PPTX： 该格式提供幻灯片、批注、隐藏幻灯片、段落、单词和多媒体计数的扩展文档属性，以及标题对和部件标题。可用性取决于文档生成者写入了哪些属性。
PPT： 二进制格式可以存储相应的文档摘要属性。如果属性缺失或未被文档生成者刷新，Aspose.Slides 将返回其存储的或默认值，而不是从幻灯片计算得出。
ODP： OpenDocument 元数据提供页面、段落和单词计数等通用文档统计信息，但这些值并不对应每个 PowerPoint 特定的扩展属性。隐藏幻灯片、批注幻灯片、多媒体、标题对和部件标题的元数据可能不可用，清单属性可能返回默认值。不要将零值或空数组视为对应内容缺失的权威证明。

在进行清单和预检时使用轻量元数据方法。当结果必须反映内存中的更改或需要验证实际演示文稿内容时，请加载演示文稿并检查其实时对象模型。

更新演示文稿属性

由 PresentationInfo.readDocumentProperties 返回的属性也可以在不创建 Presentation 实例的情况下进行更改。使用 PresentationInfo.updateDocumentProperties 应用更改，然后使用 PresentationInfo.writeBindedPresentation 写入绑定的演示文稿。

下图显示了原始文档属性。

Original document properties of the PowerPoint presentation

以下示例更改标题和最后保存时间，并将结果写入新文件：

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();
}

下图显示了已更新的文档属性。

Changed document properties of the PowerPoint presentation

有用链接

有关相关安全检查和保护设置，请参阅以下文章：

常见问题

如何检查是否嵌入了字体以及具体是哪几种？

加载演示文稿并使用 Presentation.getFontsManager。调用 FontsManager.getEmbeddedFonts 获取嵌入的字体，调用 FontsManager.getFonts 获取演示文稿使用的字体。比较两者即可找出在渲染时需要但未嵌入的字体。

如何快速判断文件是否包含隐藏幻灯片以及数量？

当存储的文档元数据足够时，通过 PresentationFactory.getPresentationInfo 和 PresentationInfo.readDocumentProperties 读取 DocumentProperties.getHiddenSlides。这适用于轻量清单。如果演示文稿已在内存中修改，存储的元数据可能缺失或已过时，或需要验证实时值，则遍历 Presentation.getSlides 并检查每个幻灯片的 Slide.getHidden 方法。

我能检测自定义幻灯片尺寸和方向是否被使用，以及它们是否与默认值不同吗？

可以。加载演示文稿并调用 Presentation.getSlideSize。使用 SlideSize.getType、SlideSize.getSize、SlideSize.getOrientation 将当前设置与预期的预设和尺寸进行比较。

有没有快速方法查看图表是否引用外部数据源？

有。定位每个 Chart 并调用 ChartData.getDataSourceType。对于外部工作簿，调用 ChartData.getExternalWorkbookPath。数据源类型和路径即可标识外部引用，但验证目标是否可用需要单独的资源检查。

如何评估可能导致渲染或 PDF 导出变慢的“重量”幻灯片？

没有单一的复杂度属性。遍历 Presentation.getSlides 并检查每个幻灯片的 BaseSlide.getShapes 集合。使用形状数量以及大图像、效果、动画或多媒体的存在作为筛选信号，并在将幻灯片视为确认的性能瓶颈前进行代表性的渲染或导出测量。

演示文稿查看器