Aprire presentazioni in JavaScript

Di cosa tratta questa pagina

Scopri come aprire presentazioni PowerPoint e OpenDocument in JavaScript, fornire password di apertura, controllare il caricamento delle risorse e ridurre l’uso della memoria con Aspose.Slides per Node.js via Java.

Introduzione

Aspose.Slides for Node.js via Java può caricare presentazioni PowerPoint e OpenDocument da file e flussi. Dopo aver caricato una presentazione, è possibile ispezionarne la struttura, modificare le diapositive, gestire le risorse e salvarla nel formato originale o in un altro formato supportato.

Il comportamento di caricamento può essere personalizzato tramite la classe LoadOptions. Ad esempio, è possibile fornire una password di apertura, tenere oggetti binari di grandi dimensioni al di fuori della memoria di Node.js, controllare le risorse esterne o omettere i dati binari incorporati.

Aprire presentazioni

Dopo aver caricato un file o un flusso, è possibile determinare il formato originario della presentazione per scegliere come elaborare la presentazione nella propria applicazione.

Per aprire una presentazione esistente, passare il percorso del file al costruttore Presentation. Rilasciare (dispose) la presentazione dopo l’uso in modo che i handle dei file, i dati temporanei e le altre risorse vengano liberati tempestivamente.

Il seguente esempio JavaScript mostra come aprire una presentazione e ottenere il conteggio delle diapositive:

const slides = require("aspose.slides.via.java");

const presentation = new slides.Presentation("sample.pptx");
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Aprire presentazioni protette da password

Una password di apertura cifra il contenuto della presentazione. Per caricare l’intera presentazione, fornire la password corretta a LoadOptions.setPassword e passare le opzioni al costruttore Presentation. Il caricamento fallisce se la password è assente o errata.

const slides = require("aspose.slides.via.java");

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

const presentation = new slides.Presentation("encrypted-presentation.pptx", loadOptions);
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Per il rilevamento, la validazione e i flussi di lavoro di crittografia delle password, vedere Password-Protect Presentations. Se una presentazione crittata è stata deliberatamente salvata con proprietà del documento pubbliche, tali proprietà possono essere lette senza password; vedere Manage Presentation Properties.

Aprire presentazioni di grandi dimensioni

LoadOptions.getBlobManagementOptions restituisce le opzioni che controllano come Aspose.Slides gestisce BLOB binari di grandi dimensioni come immagini, audio e video. È possibile mantenere il file di origine bloccato, consentire file temporanei e limitare la quantità di dati BLOB mantenuti in memoria.

Il seguente codice JavaScript dimostra il caricamento di una presentazione di grandi dimensioni (ad esempio, 2 GB):

const slides = require("aspose.slides.via.java");

const filePath = "large-presentation.pptx";

const loadOptions = new slides.LoadOptions();
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(slides.PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024);

const presentation = new slides.Presentation(filePath, loadOptions);
try {
    presentation.getSlides().get_Item(0).setName("Large presentation");
    presentation.save("large-presentation-copy.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Note

Con PresentationLockingBehavior.KeepLocked, il file di origine rimane bloccato finché l’istanza della presentazione non viene rilasciata. Non spostare, sovrascrivere o eliminare il file di origine mentre quell’istanza è attiva.

Aspose.Slides può copiare il contenuto di un flusso di input durante il caricamento. Per presentazioni di grandi dimensioni, un percorso di file è generalmente più efficiente di un flusso. Vedere Manage BLOBs per ulteriori opzioni di archiviazione e gestione della memoria.

Controllare le risorse esterne

LoadOptions.setResourceLoadingCallback accetta un’implementazione di IResourceLoadingCallback. Il callback può fornire dati di sostituzione, reindirizzare una risorsa, utilizzare il loader predefinito o ignorare la risorsa. Questo è utile quando le presentazioni contengono immagini esterne che devono essere risolte secondo regole di sicurezza o di archiviazione specifiche dell’applicazione.

const slides = require("aspose.slides.via.java");
const fs = require("fs");
const java = require("java");

const imageLoadingHandler = java.newProxy("com.aspose.slides.IResourceLoadingCallback", {
    resourceLoading: function(args) {
        const isJpeg = args.getOriginalUri().toLowerCase().endsWith(".jpg");
        const approvedImagePath = "approved-image.jpg";
        if (!isJpeg || !fs.existsSync(approvedImagePath)) {
            return slides.ResourceLoadingAction.Skip;
        }

        try {
            const imageData = fs.readFileSync(approvedImagePath);
            args.setData(imageData);
            return slides.ResourceLoadingAction.UserProvided;
        } catch (error) {
            console.error("The approved replacement image could not be read.");
            return slides.ResourceLoadingAction.Skip;
        }
    }
});

const loadOptions = new slides.LoadOptions();
loadOptions.setResourceLoadingCallback(imageLoadingHandler);

const presentation = new slides.Presentation("presentation-with-external-images.pptx", loadOptions);
try {
    console.log("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Caricare presentazioni senza oggetti binari incorporati

Una presentazione può contenere dati binari incorporati che l’applicazione non necessita o non desidera conservare. Esempi includono:

• progetti VBA, disponibili tramite Presentation.getVbaProject;
• dati OLE incorporati, disponibili tramite OleEmbeddedDataInfo.getEmbeddedFileData;
• dati di controlli ActiveX, disponibili tramite Control.getActiveXControlBinary.

Impostare LoadOptions.setDeleteEmbeddedBinaryObjects su true per rimuovere questi dati binari durante il caricamento. Salvare la presentazione caricata per conservare il risultato sanificato.

Questa opzione riduce l’esposizione a payload incorporati indesiderati, ma non è un sistema completo di rilevamento malware o di sanificazione dei contenuti.

const slides = require("aspose.slides.via.java");

const loadOptions = new slides.LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

const presentation = new slides.Presentation("presentation-with-embedded-data.pptx", loadOptions);
try {
    presentation.save("presentation-without-embedded-data.pptx", slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Come posso capire se un file è corrotto e non può essere aperto?

Aspose.Slides genera un’eccezione di parsing o di formato durante il caricamento. Gestire questo fallimento separatamente dall’errore di password errata in modo che l’applicazione possa segnalare la causa con precisione.

Cosa succede se mancano i caratteri tipografici richiesti?

La presentazione può comunque essere caricata, ma il rendering e l’esportazione potrebbero sostituire i caratteri. È possibile configurare la sostituzione dei caratteri o fornire caratteri personalizzati per rendere l’output più prevedibile.

Il caricamento di una presentazione carica anche i media incorporati?

Audio e video incorporati diventano disponibili tramite il modello a oggetti della presentazione. Le risorse esterne vengono risolte in base al comportamento di caricamento configurato e possono non essere disponibili se le loro posizioni non sono accessibili.