Gestire le proprietà della presentazione su Android

Introduzione

Aspose.Slides for Android via Java supporta le proprietà dei documenti integrate e personalizzate. Utilizza queste proprietà per leggere e aggiornare i metadati della presentazione, come l’autore, il titolo e i valori definiti dall’utente.

Aspose.Slides consente di lavorare con le proprietà dei documenti della presentazione tramite l’interfaccia IDocumentProperties . Un’istanza di questa interfaccia è restituita da IPresentation.getDocumentProperties . I seguenti esempi mostrano come leggere, modificare e gestire queste proprietà.

Gestire le proprietà della presentazione

Le proprietà del documento memorizzano informazioni descrittive insieme al contenuto della presentazione. Si suddividono in due categorie:

  • Proprietà integrate contengono metadati standard, come titolo, autore e statistiche del documento.
  • Proprietà personalizzate memorizzano coppie nome/valore definite dall’utente.

Aspose.Slides for Android via Java fornisce l’accesso a entrambe le categorie. In PowerPoint, seleziona File → Info → Proprietà → Proprietà avanzate per esaminare i metadati del documento. La finestra raggruppa le informazioni in schede come Riepilogo, Statistiche, Contenuti e Personalizzate. Usa la scheda Personalizzate per gestire le proprietà definite dall’utente.

Leggere le proprietà pubbliche da una presentazione crittografata

Una password di apertura normalmente protegge sia il contenuto della presentazione sia le proprietà del documento. Quando una presentazione viene crittografata dopo aver chiamato IProtectionManager.setEncryptDocumentProperties con false, le sue proprietà del documento rimangono pubbliche. Un’applicazione può quindi chiamare LoadOptions.setOnlyLoadDocumentProperties con true e leggere i metadati pubblici senza fornire la password di apertura.

LoadOptions.setOnlyLoadDocumentProperties controlla cosa carica Aspose.Slides; non decripta nulla. Se le proprietà sono state incluse nella crittografia, il caricamento senza la password fallisce. Se la presentazione non è crittografata, l’opzione viene ignorata e viene caricata l’intera presentazione.

L’esempio richiede una presentazione crittografata le cui proprietà del documento sono state lasciate pubbliche. Verifica la modalità di caricamento tramite IProtectionManager.isOnlyDocumentPropertiesLoaded e quindi legge le proprietà integrate tramite IPresentation.getDocumentProperties :

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;

LoadOptions loadOptions = new LoadOptions();
loadOptions.setOnlyLoadDocumentProperties(true);

Presentation presentation = new Presentation("public-properties-encrypted.pptx", loadOptions);
try {
    if (presentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
        IDocumentProperties documentProperties = presentation.getDocumentProperties();

        System.out.println("Author: " + documentProperties.getAuthor());
        System.out.println("Title: " + documentProperties.getTitle());
        System.out.println("Keywords: " + documentProperties.getKeywords());
    } else {
        System.out.println("The presentation was not loaded in document-properties-only mode.");
    }
} finally {
    presentation.dispose();
}

In questa modalità, il contenuto delle diapositive non viene caricato. Diapositive, master, layout, forme, media e altri oggetti della presentazione non sono disponibili. Le applicazioni dovrebbero sempre verificare IProtectionManager.isOnlyDocumentPropertiesLoaded prima di eseguire un’operazione che richiede il modello completo degli oggetti della presentazione.

Aggiornare le proprietà di una presentazione crittografata

Per un file PPTX crittografato, una presentazione caricata dopo aver chiamato LoadOptions.setOnlyLoadDocumentProperties con true è destinata alla lettura dei metadati pubblici. Aspose.Slides non può salvare le proprietà modificate da quell’oggetto contenente solo metadati perché le proprietà pubbliche devono rimanere coerenti con i dati corrispondenti all’interno della presentazione crittografata. Pertanto l’aggiornamento richiede la password di apertura corretta e un caricamento completo.

L’esempio richiede una presentazione PPTX crittografata con proprietà del documento pubbliche e una password di apertura nota. Apre l’intera presentazione con LoadOptions.setPassword, aggiorna le proprietà integrate pubbliche e salva il risultato. Quindi utilizza IPresentationInfo.isEncrypted per verificare che la crittografia sia preservata e riapre i metadati pubblici senza password per verificare i nuovi valori:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.PresentationFactory;
import com.aspose.slides.SaveFormat;

final String inputPath = "public-properties-encrypted.pptx";
final String outputPath = "updated-public-properties-encrypted.pptx";

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("open_password");

Presentation presentation = new Presentation(inputPath, loadOptions);
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();
    documentProperties.setTitle("Updated Product Roadmap");
    documentProperties.setKeywords("roadmap, planning, indexed");
    
    presentation.save(outputPath, SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(outputPath);
System.out.println("The presentation is encrypted: " + presentationInfo.isEncrypted());

LoadOptions metadataLoadOptions = new LoadOptions();
metadataLoadOptions.setOnlyLoadDocumentProperties(true);

Presentation metadataPresentation = new Presentation(outputPath, metadataLoadOptions);
try {
    if (metadataPresentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
        System.out.println("Title: " + metadataPresentation.getDocumentProperties().getTitle());
        System.out.println("Keywords: " + metadataPresentation.getDocumentProperties().getKeywords());
    } else {
        System.out.println("The presentation was not loaded in document-properties-only mode.");
    }
} finally {
    metadataPresentation.dispose();
}

Se un’applicazione non è autorizzata a decrittare o caricare il contenuto della presentazione, deve trattare le proprietà pubbliche di un file PPTX crittografato come sola lettura.

Accedere alle proprietà integrate

L’interfaccia IDocumentProperties espone i metadati integrati tramite metodi getter, inclusi getAuthor, getTitle e getCreatedTime. Questo esempio apre una presentazione esistente e stampa i metadati memorizzati nella console. I valori dipendono dalla presentazione di input; alcuni campi potrebbero essere vuoti.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation("AccessBuiltInProperties.pptx");
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    System.out.println("Category: " + documentProperties.getCategory());
    System.out.println("Content status: " + documentProperties.getContentStatus());
    System.out.println("Creation date: " + documentProperties.getCreatedTime());
    System.out.println("Author: " + documentProperties.getAuthor());
    System.out.println("Comments: " + documentProperties.getComments());
    System.out.println("Keywords: " + documentProperties.getKeywords());
    System.out.println("Last modified by: " + documentProperties.getLastSavedBy());
    System.out.println("Manager: " + documentProperties.getManager());
    System.out.println("Modified date: " + documentProperties.getLastSavedTime());
    System.out.println("Presentation format: " + documentProperties.getPresentationFormat());
    System.out.println("Last print date: " + documentProperties.getLastPrinted());
    System.out.println("Is shared between producers: " + documentProperties.getSharedDoc());
    System.out.println("Subject: " + documentProperties.getSubject());
    System.out.println("Title: " + documentProperties.getTitle());
} finally {
    presentation.dispose();
}

Modificare le proprietà integrate

Per aggiornare i metadati integrati, utilizza i metodi setter sull’oggetto restituito da IPresentation.getDocumentProperties. Questo esempio apre una presentazione esistente, chiama setAuthor, setTitle, setSubject, setComments, e setManager, quindi salva la presentazione aggiornata con Presentation.save. Il PPTX salvato contiene i nuovi metadati.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("ModifyBuiltInProperties.pptx");
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    documentProperties.setAuthor("Aspose.Slides for Android via Java");
    documentProperties.setTitle("Manage PowerPoint Presentation Properties");
    documentProperties.setSubject("Modify Built-in Properties");
    documentProperties.setComments("Aspose description");
    documentProperties.setManager("Aspose manager");

    presentation.save("DocumentProperties_output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

IDocumentProperties.getHyperlinkBase restituisce la base a livello di documento per gli hyperlink relativi. Usa IDocumentProperties.setHyperlinkBase per modificarla o cancellarla. Questo è utile quando si sposta una presentazione e i suoi file collegati in un’altra posizione. È separato dall'IHyperlink.getExternalUrl di un hyperlink individuale: modificare la base non riscrive gli indirizzi dei collegamenti memorizzati né cambia le destinazioni assolute.

L’esempio richiede una presentazione contenente sia un collegamento relativo, come target.html, sia un collegamento assoluto, come https://example.org/absolute.html. Legge la base esistente, assegna un nuovo indirizzo di base, salva e riapre la presentazione per verificare il valore. Successivamente cancella la base con una stringa vuota e verifica il valore vuoto in un file salvato separato. Sostituisci l’indirizzo di base dell’esempio con la posizione dei tuoi file collegati.

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("hyperlinks.pptx");
try {
    System.out.println("Original base: " + presentation.getDocumentProperties().getHyperlinkBase());

    final String newBase = "https://example.com/new/";
    presentation.getDocumentProperties().setHyperlinkBase(newBase);
    presentation.save("hyperlinks-updated.pptx", SaveFormat.Pptx);

    Presentation updatedPresentation = new Presentation("hyperlinks-updated.pptx");
    try {
        System.out.println("Base preserved: " + newBase.equals(updatedPresentation.getDocumentProperties().getHyperlinkBase()));

        updatedPresentation.getDocumentProperties().setHyperlinkBase("");
        updatedPresentation.save("hyperlinks-cleared.pptx", SaveFormat.Pptx);

        Presentation clearedPresentation = new Presentation("hyperlinks-cleared.pptx");
        try {
            System.out.println("Base cleared: " + "".equals(clearedPresentation.getDocumentProperties().getHyperlinkBase()));
        } finally {
            clearedPresentation.dispose();
        }
    } finally {
        updatedPresentation.dispose();
    }
} finally {
    presentation.dispose();
}

I due messaggi di verifica dovrebbero stampare true. Cancellare la base lascia intatti gli indirizzi dei singoli hyperlink.

Un collegamento relativo a target.pptx apriva old/target.pptx quando la base puntava alla cartella old. Dopo aver cambiato la base nella cartella new, salvato e riaperto la presentazione, lo stesso collegamento apriva new/target.pptx. Un collegamento assoluto continuava ad aprire lo stesso file. Prova i tuoi collegamenti relativi in PowerPoint prima e dopo aver spostato la presentazione o cambiato la sua base.

Aggiungere proprietà personalizzate alla presentazione

Le proprietà personalizzate memorizzano metadati che non hanno un campo integrato corrispondente. Il metodo IDocumentProperties.set_Item consente di assegnare un valore tramite il nome della proprietà. Questo esempio crea una presentazione, aggiunge due valori di testo e un valore intero di versione, e salva la presentazione con Presentation.save. Assegnare un valore a un nome esistente sostituisce il valore di quella proprietà.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation();
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    documentProperties.set_Item("Reviewed by", "John Smith");
    documentProperties.set_Item("Confidentiality level", "Internal");
    documentProperties.set_Item("Document version", 2);

    presentation.save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Accedere e modificare le proprietà personalizzate

Questo esempio apre una presentazione contenente proprietà personalizzate e utilizza getCountOfCustomProperties per iterarle. getCustomPropertyName accetta un indice a base zero e restituisce il nome utilizzato da IDocumentProperties.set_Item. L’esempio stampa ogni nome e valore originale, sostituisce ogni valore con una stringa numerata indipendentemente dal tipo originale, e salva le modifiche. Se non ci sono proprietà personalizzate, il ciclo non apporta modifiche.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("AccessAndModifyProperties.pptx");
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    for (int i = 0; i < documentProperties.getCountOfCustomProperties(); i++) {
        String propertyName = documentProperties.getCustomPropertyName(i);
        Object propertyValue = documentProperties.get_Item(propertyName);

        System.out.println("Custom property name: " + propertyName);
        System.out.println("Custom property value: " + propertyValue);

        documentProperties.set_Item(propertyName, "New Value " + (i + 1));
    }

    presentation.save("CustomProperties_output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Esempio live

Prova l’app online View & Edit PowerPoint Metadata per vedere come lavorare con le proprietà del documento usando l’API Aspose.Slides:

View & Edit PowerPoint Metadata

FAQ

Come posso rimuovere una proprietà integrata da una presentazione?

Le proprietà integrate sono una parte integrante della presentazione e non possono essere rimosse completamente. Tuttavia, è possibile modificarne i valori o impostarle a vuoto se la proprietà specifica lo consente.

Cosa succede se aggiungo una proprietà personalizzata che esiste già?

Se aggiungi una proprietà personalizzata già esistente, il suo valore attuale verrà sovrascritto con quello nuovo. Non è necessario rimuovere o verificare la proprietà in anticipo, poiché Aspose.Slides aggiorna automaticamente il valore della proprietà.

Posso accedere alle proprietà della presentazione senza caricarla completamente?

Sì. Usa PresentationFactory.getPresentationInfo e poi IPresentationInfo.readDocumentProperties per leggere i metadati del documento memorizzati senza creare un’istanza di Presentation. Vedi Build a Lightweight Presentation Inventory per un esempio completo di reporting e le limitazioni specifiche del formato.

Posso leggere le proprietà pubbliche di una presentazione crittografata senza la sua password di apertura?

Sì. La presentazione deve essere stata crittografata dopo aver chiamato IProtectionManager.setEncryptDocumentProperties con false, e deve essere caricata dopo aver chiamato LoadOptions.setOnlyLoadDocumentProperties con true.

Posso aggiornare un file PPTX crittografato in modalità solo proprietà del documento?

No. Le proprietà pubbliche e crittografate devono rimanere coerenti, quindi l’aggiornamento di un file PPTX crittografato richiede il caricamento dell’intera presentazione con la password di apertura corretta.