Recupera e aggiorna le informazioni della presentazione su Android

Di cosa tratta questa pagina

Esplora diapositive, struttura e metadati nelle presentazioni PowerPoint e OpenDocument usando Java per ottenere rapidamente approfondimenti e audit più intelligenti dei contenuti.

Panoramica

Aspose.Slides può identificare il formato di una presentazione e leggere i metadati del documento senza creare un modello di oggetto presentazione completo. Questo è utile quando è necessario classificare i file, creare un inventario o ispezionare le proprietà prima di decidere se caricare ed elaborare il contenuto della presentazione.

Questo articolo dimostra l’ispezione leggera tramite PresentationFactory e IPresentationInfo, così come gli aggiornamenti mirati tramite IDocumentProperties.

Verifica il formato di una presentazione

Se hai già una presentazione caricata, consulta Determine the Original Presentation Format per la rilevazione dopo il caricamento e le limitazioni dei flussi legacy PPT, PPS e POT.

Utilizza PresentationFactory.getPresentationInfo per ispezionare un file senza creare un’istanza di Presentation. Il metodo IPresentationInfo.getLoadFormat restituisce il formato rilevato, ad esempio PPTX, PPT o ODP.

import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;

String[] fileNames = { "pres.pptx", "pres.ppt", "pres.odp" };

for (String fileName : fileNames) {
    IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(fileName);
    int loadFormat = presentationInfo.getLoadFormat();
    String formatName = "Other (" + loadFormat + ")";

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

    System.out.println(fileName + ": " + formatName);
}

Crea un inventario di presentazioni leggero

Quando elabori molti file di presentazione, potresti aver bisogno di un inventario compatto per la convalida, l’indicizzazione o un sistema di gestione documentale. In questo scenario, utilizza PresentationFactory.getPresentationInfo per ottenere un oggetto IPresentationInfo e poi chiama IPresentationInfo.readDocumentProperties per leggere i metadati del documento. Questo approccio non crea un’istanza di Presentation né richiede di attraversare l’intero modello di oggetto della presentazione.

Le proprietà estese esposte da IDocumentProperties forniscono i seguenti valori di inventario:

Metodo	Valore dell’inventario
getSlides	Numero totale di diapositive.
getHiddenSlides	Numero di diapositive nascoste.
getNotes	Numero di diapositive che contengono note.
getParagraphs	Numero totale di paragrafi, se disponibile.
getWords	Numero totale di parole.
getMultimediaClips	Numero totale di clip audio e video.

Il seguente esempio legge questi valori senza creare un oggetto Presentation e stampa un inventario compatto. Combina inoltre getHeadingPairs con getTitlesOfParts per visualizzare i gruppi di contenuto come caratteri, temi e titoli delle diapositive.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IHeadingPair;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;
import java.nio.file.Paths;

String filePath = "sample.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(filePath);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

int loadFormat = presentationInfo.getLoadFormat();
String formatName = "Other (" + loadFormat + ")";

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

System.out.println("File: " + Paths.get(filePath).getFileName());
System.out.println("Format: " + formatName);
System.out.println("Title: " + documentProperties.getTitle());
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Statistics:");
System.out.println("  Slides: " + documentProperties.getSlides());
System.out.println("  Hidden slides: " + documentProperties.getHiddenSlides());
System.out.println("  Slides with notes: " + documentProperties.getNotes());
System.out.println("  Paragraphs: " + documentProperties.getParagraphs());
System.out.println("  Words: " + documentProperties.getWords());
System.out.println("  Multimedia clips: " + documentProperties.getMultimediaClips());

IHeadingPair[] headingPairs = documentProperties.getHeadingPairs();
String[] titlesOfParts = documentProperties.getTitlesOfParts();
headingPairs = headingPairs != null ? headingPairs : new IHeadingPair[0];
titlesOfParts = titlesOfParts != null ? titlesOfParts : new String[0];
int partIndex = 0;

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

    for (IHeadingPair headingPair : headingPairs) {
        System.out.println("  " + headingPair.getName() + " (" + headingPair.getCount() + ")");

        for (int partOffset = 0; partOffset < headingPair.getCount() && partIndex < titlesOfParts.length; partOffset++) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.length) {
        System.out.println("  Other parts:");

        while (partIndex < titlesOfParts.length) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }
}

Ogni IHeadingPair fornisce un nome di gruppo e il numero di elementi in quel gruppo. IDocumentProperties.getTitlesOfParts restituisce un array piatto e ordinato, quindi consumare il numero di titoli consecutivi specificato da ciascuna coppia di intestazioni.

Metadati memorizzati e limitazioni del formato

Le proprietà di inventario restituite da IPresentationInfo.readDocumentProperties riflettono i metadati disponibili nel documento di origine. Aspose.Slides non carica e attraversa il modello di oggetto della presentazione per ricalcolare questi valori per questa chiamata. Le proprietà mancanti sono rappresentate da valori predefiniti e i valori memorizzati potrebbero essere obsoleti se l’applicazione che ha salvato per ultima il file non ha aggiornato le proprietà del documento.

PPTX: Il formato fornisce proprietà di documento estese per il conteggio di diapositive, note, diapositive nascoste, paragrafi, parole e multimedia, nonché coppie di intestazioni e titoli delle parti. La disponibilità dipende da quali proprietà sono state scritte dal produttore del documento.
PPT: Il formato binario può memorizzare le corrispondenti proprietà di riepilogo del documento. Se una proprietà è assente o non è stata aggiornata dal produttore del documento, Aspose.Slides restituisce il suo valore memorizzato o predefinito anziché calcolarlo dalle diapositive.
ODP: I metadati OpenDocument forniscono statistiche generali del documento, come il conteggio di pagine, paragrafi e parole, ma questi valori non corrispondono a tutte le proprietà estese specifiche di PowerPoint. I metadati di diapositive nascoste, note, multimedia, coppie di intestazioni e titoli delle parti potrebbero non essere disponibili e le proprietà di inventario potrebbero restituire valori predefiniti. Non considerare un valore zero o un array vuoto come prova autorevole dell’assenza del contenuto corrispondente.

Utilizza l’approccio di metadati leggeri per inventari e verifiche preliminari. Carica la presentazione e ispeziona il suo modello di oggetto in tempo reale quando il risultato deve riflettere le modifiche in memoria o quando è necessario verificare il contenuto reale della presentazione.

Aggiorna le proprietà della presentazione

Le proprietà restituite da IPresentationInfo.readDocumentProperties possono anche essere modificate senza creare un’istanza di Presentation. Applica le modifiche con IPresentationInfo.updateDocumentProperties, e poi scrivi la presentazione associata con IPresentationInfo.writeBindedPresentation.

L’immagine seguente mostra le proprietà originali del documento.

Proprietà originali del documento della presentazione PowerPoint

Il seguente esempio modifica il titolo e l’ora di ultimo salvataggio e scrive il risultato in un nuovo file:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.PresentationFactory;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;

String sourceFile = "sample.pptx";
String outputFile = "sample_with_updated_properties.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(sourceFile);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

documentProperties.setTitle("Quarterly sales report");
documentProperties.setLastSavedTime(new Date());

presentationInfo.updateDocumentProperties(documentProperties);
try (OutputStream outputStream = new FileOutputStream(outputFile)) {
    presentationInfo.writeBindedPresentation(outputStream);
}

L’immagine seguente mostra le proprietà del documento modificate della presentazione PowerPoint.

Proprietà del documento modificate della presentazione PowerPoint

Link utili

Per i controlli di sicurezza correlati e le impostazioni di protezione, consulta i seguenti articoli:

FAQ

Come posso verificare se i caratteri sono incorporati e quali sono?

Carica la presentazione e utilizza Presentation.getFontsManager. Chiama IFontsManager.getEmbeddedFonts per ottenere i caratteri incorporati e IFontsManager.getFonts per ottenere i caratteri usati dalla presentazione. Confronta i due risultati per trovare i caratteri necessari per il rendering ma non incorporati.

Come posso capire rapidamente se il file contiene diapositive nascoste e quante?

Quando i metadati del documento memorizzati sono sufficienti, leggi IDocumentProperties.getHiddenSlides tramite PresentationFactory.getPresentationInfo e IPresentationInfo.readDocumentProperties. Questo è adatto a un inventario leggero. Se la presentazione è stata modificata in memoria, i metadati memorizzati potrebbero mancare o essere obsoleti, oppure è necessario verificare i valori in tempo reale; in tal caso itera attraverso Presentation.getSlides e ispeziona il metodo ISlide.getHidden di ciascuna diapositiva.

Posso rilevare se viene utilizzata una dimensione e un’orientamento di diapositiva personalizzati e se differiscono dai valori predefiniti?

Sì. Carica la presentazione e chiama Presentation.getSlideSize. Usa ISlideSize.getType, ISlideSize.getSize e ISlideSize.getOrientation per confrontare le impostazioni correnti con il preset e le dimensioni previste.

Esiste un modo rapido per verificare se i grafici fanno riferimento a fonti dati esterne?

Sì. Individua ogni Chart e chiama IChartData.getDataSourceType. Per una cartella di lavoro esterna, chiama IChartData.getExternalWorkbookPath. Il tipo di origine dati e il percorso identificano un riferimento esterno, ma verificare se il target è disponibile richiede un controllo di risorse separato.

Come posso valutare le diapositive ‘pesanti’ che potrebbero rallentare il rendering o l’esportazione PDF?

Non esiste una singola proprietà di complessità. Attraversa Presentation.getSlides e la collezione IBaseSlide.getShapes di ogni diapositiva. Usa il conteggio delle forme e la presenza di immagini di grandi dimensioni, effetti, animazioni o multimedia come segnali di valutazione, e misura un rendering o un’esportazione rappresentativa prima di considerare una diapositiva come un colpo di bottiglia di prestazioni confermato.

Aprire presentazioni su Android Determinare il formato originale della presentazione su Android