Recuperar e Atualizar Informações da Apresentação em JavaScript

Sobre o que é esta página

Explore slides, estrutura e metadados em apresentações PowerPoint e OpenDocument usando JavaScript para obter insights mais rápidos e auditorias de conteúdo mais inteligentes.

Visão geral

Aspose.Slides pode identificar o formato de uma apresentação e ler seus metadados de documento sem criar um modelo de objeto de apresentação completo. Isso é útil quando você precisa classificar arquivos, criar um inventário ou inspecionar propriedades antes de decidir se carrega e processa o conteúdo da apresentação.

Este artigo demonstra inspeção leve por meio de PresentationFactory e PresentationInfo, bem como atualizações direcionadas por meio de DocumentProperties.

Verificar o formato de uma apresentação

Se você já tem uma apresentação carregada, consulte Determine the Original Presentation Format para detecção após o carregamento e as limitações dos fluxos legados PPT, PPS e POT.

Use PresentationFactory.getPresentationInfo para inspecionar um arquivo sem criar uma instância de Presentation. O método PresentationInfo.getLoadFormat relata o formato detectado, como PPTX, PPT ou 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}`);
}

Criar um inventário de apresentações leve

Quando você processa muitos arquivos de apresentação, pode precisar de um inventário compacto para validação, indexação ou um sistema de gerenciamento de documentos. Nesse cenário, use PresentationFactory.getPresentationInfo para obter um objeto PresentationInfo, e então chame PresentationInfo.readDocumentProperties para ler os metadados do documento. Essa abordagem não cria uma instância de Presentation nem exige que você percorra o modelo de objeto de apresentação completo.

As propriedades estendidas expostas por DocumentProperties fornecem os seguintes valores de inventário:

Método	Valor do inventário
getSlides	Número total de slides.
getHiddenSlides	Número de slides ocultos.
getNotes	Número de slides que contêm notas.
getParagraphs	Número total de parágrafos, quando disponível.
getWords	Número total de palavras.
getMultimediaClips	Número total de clipes de áudio e vídeo.

O exemplo a seguir lê esses valores sem criar um objeto Presentation e imprime um inventário compacto. Ele também combina DocumentProperties.getHeadingPairs com DocumentProperties.getTitlesOfParts para exibir grupos de conteúdo como fontes, temas e títulos de slides.

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

Cada HeadingPair fornece um nome de grupo por meio de HeadingPair.getName e o número de itens naquele grupo por meio de HeadingPair.getCount. DocumentProperties.getTitlesOfParts retorna um array plano e ordenado, portanto consuma o número de títulos consecutivos especificado por cada heading pair.

Metadados armazenados e limitações de formato

As propriedades de inventário retornadas por PresentationInfo.readDocumentProperties refletem os metadados disponíveis no documento de origem. Aspose.Slides não carrega e percorre o modelo de objeto da apresentação para recalcular esses valores nesta chamada. Propriedades ausentes são representadas por valores padrão, e valores armazenados podem estar desatualizados se a aplicação que salvou o arquivo pela última vez não atualizou suas propriedades de documento.

• PPTX: O formato fornece propriedades de documento estendidas para contagens de slides, notas, slides ocultos, parágrafos, palavras e multimídia, além de pares de cabeçalhos e títulos de partes. A disponibilidade depende de quais propriedades foram escritas pelo produtor do documento.
• PPT: O formato binário pode armazenar propriedades de resumo de documento correspondentes. Se uma propriedade estiver ausente ou não for atualizada pelo produtor do documento, Aspose.Slides retorna seu valor armazenado ou padrão em vez de calculá‑lo a partir dos slides.
• ODP: Os metadados do OpenDocument fornecem estatísticas gerais do documento, como contagens de páginas, parágrafos e palavras, mas esses valores não mapeiam para todas as propriedades estendidas específicas do PowerPoint. Metadados de slide oculto, slide de notas, multimídia, pares de cabeçalhos e títulos de partes podem estar indisponíveis, e as propriedades de inventário podem retornar valores padrão. Não trate um valor zero ou um array vazio como prova autoritativa de que o conteúdo correspondente está ausente.

Use a abordagem de metadados leve para inventários e verificações preliminares. Carregue a apresentação e inspecione seu modelo de objeto ao vivo quando o resultado precisar refletir alterações em memória ou quando for necessário verificar o conteúdo real da apresentação.

Atualizar propriedades da apresentação

As propriedades retornadas por PresentationInfo.readDocumentProperties também podem ser alteradas sem criar uma instância de Presentation. Aplique as alterações com PresentationInfo.updateDocumentProperties, e então grave a apresentação vinculada com PresentationInfo.writeBindedPresentation.

A imagem a seguir mostra as propriedades de documento originais.

O exemplo a seguir altera o título e a hora da última gravação e grava o resultado em um novo arquivo:

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

A imagem a seguir mostra as propriedades de documento atualizadas.

Links úteis

Para verificações de segurança relacionadas e configurações de proteção, veja os artigos a seguir:

• Password-Protect Presentations
• Write-Protect Presentations

FAQ

Como posso verificar se as fontes estão incorporadas e quais são?

Carregue a apresentação e use Presentation.getFontsManager. Chame FontsManager.getEmbeddedFonts para obter as fontes incorporadas e FontsManager.getFonts para obter as fontes usadas pela apresentação. Compare os dois resultados para encontrar fontes necessárias para renderização que não estejam incorporadas.

Como posso determinar rapidamente se o arquivo tem slides ocultos e quantos?

Quando os metadados de documento armazenados são suficientes, leia DocumentProperties.getHiddenSlides por meio de PresentationFactory.getPresentationInfo e PresentationInfo.readDocumentProperties. Isso é adequado para um inventário leve. Se a apresentação foi modificada em memória, os metadados armazenados podem estar ausentes ou desatualizados, ou se precisar verificar valores ao vivo, itere através de Presentation.getSlides e inspecione o método Slide.getHidden de cada slide.

Posso detectar se um tamanho de slide personalizado e orientação são usados, e se diferem dos padrões?

Sim. Carregue a apresentação e chame Presentation.getSlideSize. Use SlideSize.getType, SlideSize.getSize, e SlideSize.getOrientation para comparar as configurações atuais com o preset e dimensões esperados.

Existe uma forma rápida de ver se gráficos referenciam fontes de dados externas?

Sim. Localize cada Chart e chame ChartData.getDataSourceType. Para uma pasta de trabalho externa, chame ChartData.getExternalWorkbookPath. O tipo de fonte de dados e o caminho identificam uma referência externa, mas verificar se o alvo está disponível requer uma checagem de recurso separada.

Como posso avaliar slides “pesados” que podem atrasar a renderização ou exportação para PDF?

Não há uma única propriedade de complexidade. Percorra Presentation.getSlides e a coleção BaseSlide.getShapes de cada slide. Use contagens de formas e a presença de imagens grandes, efeitos, animações ou multimídia como sinais de triagem, e meça uma renderização ou exportação representativa antes de considerar um slide como gargalo de desempenho confirmado.