Recuperar e Atualizar Informações da Apresentação em Python via Java
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 carregar e processar o conteúdo da apresentação.
Os exemplos requerem Aspose.Slides for Python via Java e um runtime Java compatível. Cada exemplo inicia a JVM se ela ainda não estiver em execução. Forneça arquivos de apresentação existentes nos caminhos usados nos exemplos.
Este artigo demonstra inspeção leve através de PresentationFactory e PresentationInfo, bem como atualizações direcionadas através de DocumentProperties.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import LoadFormat, PresentationFactory
file_names = ["pres.pptx", "pres.ppt", "pres.odp"]
for file_name in file_names:
presentation_info = PresentationFactory.getInstance().getPresentationInfo(file_name)
load_format = presentation_info.getLoadFormat()
format_name = f"Other ({load_format})"
if load_format == LoadFormat.Pptx:
format_name = "PPTX"
elif load_format == LoadFormat.Ppt:
format_name = "PPT"
elif load_format == LoadFormat.Odp:
format_name = "ODP"
print(f"{file_name}: {format_name}")
Verificar o formato de uma apresentação
Use PresentationFactory.getPresentationInfo para inspecionar um arquivo sem criar uma instância de Presentation. O método PresentationInfo.getLoadFormat informa o formato detectado, como PPTX, PPT ou ODP.
Criar um inventário leve de apresentações
Ao processar muitos arquivos de apresentação, pode ser necessário 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 requer 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 de 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 getHeadingPairs com getTitlesOfParts para exibir grupos de conteúdo como fontes, temas e títulos de slides.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from pathlib import Path
from asposeslides.api import LoadFormat, PresentationFactory
file_path = "sample.pptx"
presentation_info = PresentationFactory.getInstance().getPresentationInfo(file_path)
document_properties = presentation_info.readDocumentProperties()
load_format = presentation_info.getLoadFormat()
format_name = f"Other ({load_format})"
if load_format == LoadFormat.Pptx:
format_name = "PPTX"
elif load_format == LoadFormat.Ppt:
format_name = "PPT"
elif load_format == LoadFormat.Odp:
format_name = "ODP"
print(f"File: {Path(file_path).name}")
print(f"Format: {format_name}")
print(f"Title: {document_properties.getTitle()}")
print(f"Author: {document_properties.getAuthor()}")
print("Statistics:")
print(f" Slides: {document_properties.getSlides()}")
print(f" Hidden slides: {document_properties.getHiddenSlides()}")
print(f" Slides with notes: {document_properties.getNotes()}")
print(f" Paragraphs: {document_properties.getParagraphs()}")
print(f" Words: {document_properties.getWords()}")
print(f" Multimedia clips: {document_properties.getMultimediaClips()}")
heading_pairs = document_properties.getHeadingPairs()
titles_of_parts = document_properties.getTitlesOfParts()
heading_pairs = heading_pairs if heading_pairs is not None else []
titles_of_parts = titles_of_parts if titles_of_parts is not None else []
part_index = 0
if len(heading_pairs) == 0 or len(titles_of_parts) == 0:
print("Content groups: not available")
else:
print("Content groups:")
for heading_pair in heading_pairs:
print(f" {heading_pair.getName()} ({heading_pair.getCount()})")
for part_offset in range(heading_pair.getCount()):
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
Cada HeadingPair fornece um nome de grupo e o número de itens nesse grupo. DocumentProperties.getTitlesOfParts devolve um array plano e ordenado, portanto consuma o número de títulos consecutivos especificado por cada par de cabeçalho.
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 para esta 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 contagem 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 gravadas pelo produtor do documento.
- PPT: O formato binário pode armazenar propriedades resumidas correspondentes. Se uma propriedade estiver ausente ou não for atualizada pelo produtor do documento, Aspose.Slides devolve seu valor armazenado ou padrão ao invés de calculá‑lo a partir dos slides.
- ODP: Os metadados OpenDocument fornecem estatísticas gerais do documento, como contagem 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 autoritária de que o conteúdo correspondente está ausente.
Use a abordagem de metadados leves 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 precisar 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 mudanças com PresentationInfo.updateDocumentProperties, e então escreva a apresentação vinculada com PresentationInfo.writeBindedPresentation.
A imagem a seguir mostra as propriedades originais do documento.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import PresentationFactory
from java.io import FileOutputStream
from java.util import Date
source_file = "sample.pptx"
output_file = "sample_with_updated_properties.pptx"
presentation_info = PresentationFactory.getInstance().getPresentationInfo(source_file)
document_properties = presentation_info.readDocumentProperties()
document_properties.setTitle("Quarterly sales report")
last_saved_time = Date()
document_properties.setLastSavedTime(last_saved_time)
presentation_info.updateDocumentProperties(document_properties)
output_stream = FileOutputStream(output_file)
try:
presentation_info.writeBindedPresentation(output_stream)
finally:
output_stream.close()
A imagem a seguir mostra as propriedades do documento alteradas.
Links úteis
Para verificações de segurança relacionadas e configurações de proteção, veja os artigos a seguir:
Perguntas frequentes
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 rapidamente saber se o arquivo tem slides ocultos e quantos?
Quando os metadados armazenados do documento são suficientes, leia DocumentProperties.getHiddenSlides através 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, percorra 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 maneira rápida de ver se os 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 destino está disponível requer uma verificação de recurso separada.
Como posso avaliar slides ‘pesados’ que podem desacelerar a renderização ou a exportação para PDF?
Não existe 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 um gargalo de desempenho comprovado.