Esempio completo funzionante per rimuovere gli oggetti di annotazione da PDF con REST in Node.JS

Questo esempio dimostra come caricare un PDF, eliminare tutte le sue annotazioni e scaricare il file pulito utilizzando il GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Elimina le annotazioni PDF tramite REST API usando cURL

Di seguito sono riportati i comandi cURL che eseguono lo stesso flusso di rimozione delle annotazioni tramite gli endpoint REST di GroupDocs.Annotation Cloud.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Per un elenco completo di endpoint e parametri, consulta la documentazione ufficiale dell’API.

Come rimuovere gli oggetti di annotazione da PDF con REST in Node.JS

1. Configurazione dell’autenticazione - La classe Configuration viene istanziata con il tuo clientId e clientSecret, creando un contesto autenticato per tutte le successive chiamate API.

   const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
   

2. Caricamento del file - UploadFileRequest invia i byte PDF locali allo storage di GroupDocs Cloud. Il metodo storageApi.uploadFile gestisce il trasferimento.

   const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
       path: remoteFilePath,
       file: fileBytes
   });
   await storageApi.uploadFile(uploadRequest);
   

3. Recupero delle annotazioni - GetAnnotationsRequest costruisce un oggetto di richiesta con un riferimento FileInfo. La chiamata annotationsApi.getAnnotations restituisce una collezione di oggetti annotazione, da cui vengono estratti gli ID.

   const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
       fileInfo: fileInfo
   });
   const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
   

4. Eliminazione delle annotazioni - Se esistono ID, DeleteAnnotationsRequest viene popolato e passato a annotationsApi.deleteAnnotations, che rimuove permanentemente le annotazioni dal PDF memorizzato.

   const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
       fileInfo: fileInfo,
       annotationIds: annotationIds
   });
   await annotationsApi.deleteAnnotations(deleteRequest);
   

5. Download del PDF pulito - Infine, DownloadFileRequest recupera il file aggiornato e fs.writeFileSync lo scrive nel filesystem locale.

   const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
       path: remoteFilePath
   });
   const fileStream = await storageApi.downloadFile(downloadRequest);
   fs.writeFileSync(localOutputPath, fileStream);
   

Per le definizioni dettagliate di classi e metodi, fare riferimento al riferimento API.

Installazione e configurazione di GroupDocs.Annotation Cloud SDK for Node.js

L’SDK è distribuito come pacchetto npm. Installalo con il comando riportato di seguito e poi richiedilo nel tuo progetto.

npm install groupdocs-annotation-cloud

Puoi anche scaricare l’ultimo pacchetto direttamente dalla pagina dei rilasci su GitHub o dall’URL di download ufficiale.

Dopo l’installazione, importa la libreria e crea un oggetto di configurazione come mostrato nell’esempio di codice:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Assicurati che il tuo ambiente di runtime soddisfi i requisiti della versione di Node.js e che tu abbia un account GroupDocs valido per ottenere le credenziali client.

Opzioni e impostazioni per la rimozione delle annotazioni

L’SDK espone diversi parametri che è possibile regolare:

• clientId / clientSecret - Credenziali per l’autenticazione OAuth. Impostale nel costruttore Configuration.
• fileInfo.filePath - Il percorso del PDF nello storage di GroupDocs Cloud. Modificalo se memorizzi i file in una cartella diversa.
• annotationIds - Un array di ID restituiti da GetAnnotations. Fornire un sottoinsieme consente la cancellazione selettiva.

Impostazioni aggiuntive come i timeout delle richieste e la configurazione del proxy sono disponibili nella documentazione SDK; consulta la documentazione ufficiale per l’elenco completo.

Best Practices per la rimozione delle annotazioni PDF tramite REST

• Convalida gli ID delle annotazioni - Verifica sempre che gli ID che intendi eliminare esistano; tentare di eliminare ID inesistenti può causare un errore 404.
• Usa HTTPS - Tutte le chiamate API devono essere eseguite tramite HTTPS per proteggere le tue credenziali e i dati dei documenti.
• Gestisci file di grandi dimensioni con upload a blocchi - Per i PDF più grandi di 100 MB, preferisci l’endpoint di upload multipart per evitare timeout.
• Registra le risposte API - Memorizza gli ID delle richieste e le risposte per tracce di audit e una più facile risoluzione dei problemi.
• Riutilizza i token di accesso - Memorizza nella cache il token OAuth fino alla scadenza per ridurre il carico di autenticazione.

Domande comuni

• Come posso autenticarmi con l’API GroupDocs.Annotation Cloud?
  Ottieni un client ID e un segreto dal tuo account GroupDocs, quindi richiedi un token di accesso tramite l’endpoint OAuth. Consulta la documentazione ufficiale per i dettagli.

• Posso eliminare annotazioni specifiche invece di tutte?
  Sì, fornisci gli ID delle annotazioni che desideri rimuovere nella DeleteAnnotationsRequest. L’SDK restituisce l’elenco degli ID delle annotazioni dopo una chiamata GetAnnotations.

• Come posso rimuovere gli oggetti Annotation da PDF con REST in Node.JS?
  Utilizza il GroupDocs.Annotation Cloud SDK for Node.js per chiamare l’endpoint DeleteAnnotations dopo aver recuperato gli ID delle annotazioni. Il flusso completo è mostrato nell’esempio di codice e nella sezione cURL di questa guida.

• Quale licenza è necessaria per l’uso in produzione?
  È necessaria una licenza a pagamento per la produzione. È possibile ottenere una licenza temporanea dalla pagina della licenza temporanea durante la valutazione.

Further Reading

• Estrai o rimuovi le annotazioni da PDF usando l’API REST in Node.js
• Testo barrato in un PDF con Node.js e API REST
• Rimuovi le annotazioni da PDF usando l’API REST in Python

Modifica file Excel in Node.js tramite REST - Guida in 5 passaggi

1. Installa l’SDK e configura le credenziali: Imposta il tuo CLIENT_ID e CLIENT_SECRET in modo che la libreria possa autenticarsi con GroupDocs Cloud.

const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
const editApi = new GroupDocsEditorCloud.EditApi(config);

2. Carica la cartella di lavoro Excel per la modifica: Usa EditDocumentRequest per aprire il file memorizzato nel tuo cloud storage.

const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
    fileInfo: new GroupDocsEditorCloud.FileInfo({ filePath: "input.xlsx" })
});
const editResult = await editApi.editDocument(editRequest);

3. Recupera il primo foglio di lavoro e individua la cella di destinazione: L’SDK restituisce un oggetto document che contiene fogli di lavoro e celle.

const worksheet = editResult.document.worksheets[0];
let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);

4. Aggiorna o crea il valore della cella: Modifica il contenuto della cella A1 (oppure aggiungila se non esiste).

if (!targetCell) {
    targetCell = new GroupDocsEditorCloud.Cell({
        rowIndex: 0,
        columnIndex: 0,
        value: "Edited via GroupDocs Editor Cloud"
    });
    worksheet.cells.push(targetCell);
} else {
    targetCell.value = "Edited via GroupDocs Editor Cloud";
}

5. Salva la cartella di lavoro modificata nello storage: Fornisci un outputPath e chiama saveDocument.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({ outputPath: "output.xlsx" });
const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
    documentId: editResult.documentId,
    document: editResult.document,
    saveOptions: saveOptions
});
await editApi.saveDocument(saveRequest);

Per un elenco completo di classi e metodi, consulta la riferimento API.

Modifica file Excel in Node.js tramite REST - Esempio di codice completo

Il seguente esempio dimostra come modificare un file Excel in Node.js tramite REST utilizzando GroupDocs.Editor Cloud SDK.

const GroupDocsEditorCloud = require("@groupdocs/editor-cloud");

// Replace with your actual GroupDocs Cloud credentials
const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

// Paths for the source Excel file and the edited result
const INPUT_FILE_PATH = "input.xlsx";
const OUTPUT_FILE_PATH = "output.xlsx";

async function editExcel() {
    // Configure the SDK
    const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
    const editApi = new GroupDocsEditorCloud.EditApi(config);

// 1. Load the Excel workbook for editing
    const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
        fileInfo: new GroupDocsEditorCloud.FileInfo({
            filePath: INPUT_FILE_PATH
        })
    });

const editResult = await editApi.editDocument(editRequest);
    const documentId = editResult.documentId;
    const document = editResult.document;

// 2. Retrieve the first worksheet
    const worksheet = document.worksheets[0];

// 3. Update cell A1 (rowIndex = 0, columnIndex = 0) with a new value
    let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);
    if (!targetCell) {
        targetCell = new GroupDocsEditorCloud.Cell({
            rowIndex: 0,
            columnIndex: 0,
            value: "Edited via GroupDocs Editor Cloud"
        });
        worksheet.cells.push(targetCell);
    } else {
        targetCell.value = "Edited via GroupDocs Editor Cloud";
    }

// 4. Save the edited workbook back to storage
    const saveOptions = new GroupDocsEditorCloud.SaveOptions({
        outputPath: OUTPUT_FILE_PATH
    });

const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
        documentId: documentId,
        document: document,
        saveOptions: saveOptions
    });

const saveResult = await editApi.saveDocument(saveRequest);
    console.log(`Edited file saved to: ${saveResult.path}`);
}

// Execute the edit operation
editExcel().catch(error => {
    console.error("Error during Excel editing:", error);
});

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Aggiorna foglio XLSX usando l’API REST in Node.js via cURL

Di seguito è una rapida panoramica della stessa operazione usando chiamate HTTP grezze. Sostituisci i valori segnaposto con le tue credenziali effettive e i nomi dei file.

1. Ottieni un token di accesso

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

La risposta contiene access_token.

2. Carica il file XLSX di origine

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@input.xlsx"

3. Modifica la cartella di lavoro (modifica la cella A1)

   curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{
              "fileInfo": { "filePath": "input.xlsx" },
              "options": {
                  "cells": [
                      { "rowIndex": 0, "columnIndex": 0, "value": "Edited via GroupDocs Editor Cloud" }
                  ]
              }
            }'
   

4. Scarica il file modificato

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.xlsx

Per ulteriori dettagli sui payload di richiesta, vedere la documentazione ufficiale dell’API.

Prerequisiti e configurazione per GroupDocs.Editor Cloud SDK per Node.js

Per iniziare a utilizzare l’SDK, è necessario Node.js 14 o versioni successive e un account GroupDocs Cloud.

npm install groupdocs-editor-cloud

Puoi anche scaricare l’ultimo pacchetto dalla pagina di rilascio. Dopo l’installazione, crea un client_id e un client_secret nella tua dashboard di GroupDocs Cloud e conservali al sicuro.

Cosa rende GroupDocs.Editor Cloud SDK for Node.js ideale per modificare i fogli di lavoro Excel

• Full XLSX support - Carica, modifica e salva le cartelle di lavoro preservando formule, stili e convalida dei dati.
• Cell‑level editing - Accedi a singole celle, righe o colonne programmaticamente, ideale per aggiornare report o dashboard.
• Cloud storage integration - Lavora direttamente con i file archiviati in GroupDocs Cloud senza scaricarli localmente.
• Secure REST communication - Tutte le operazioni avvengono su HTTPS e l’SDK gestisce per te la gestione dei token.

Per un’analisi più approfondita, fai riferimento alla documentazione.

Ottimizzazione delle opzioni di modifica di Excel in GroupDocs.Editor Cloud

Il SDK espone diverse opzioni che consentono di controllare come viene salvato il workbook modificato.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({
    outputPath: "output.xlsx",
    // You can also set compression level, password protection, etc.
});

• outputPath - Percorso di destinazione nell’archiviazione cloud.
• compressionLevel - Riduce le dimensioni del file per cartelle di lavoro di grandi dimensioni (disponibile nella documentazione API).
• password - Proteggi il file risultante con una password, se necessario.

Regola queste impostazioni per soddisfare le esigenze di sicurezza e prestazioni del tuo progetto.

Considerazioni sulle prestazioni per la modifica di cartelle di lavoro XLSX tramite REST

1. Riutilizza l’oggetto di configurazione - Creare una nuova Configuration per ogni richiesta aggiunge overhead. Mantieni un’unica istanza per tutta la durata della tua applicazione.
2. Aggiorna le celle in batch - Se devi modificare molte celle, raccoglile in un array e invia una singola richiesta di modifica invece di più chiamate.
3. Limita le dimensioni del foglio di lavoro - Fogli di lavoro molto grandi aumentano il consumo di memoria. Considera di suddividere i dati su più fogli quando possibile.
4. Evita salvataggi non necessari - Chiama saveDocument solo dopo che tutte le modifiche richieste sono state applicate per ridurre le operazioni di I/O.

Conclusione

Modificare un file Excel in Node.js tramite REST diventa semplice con il GroupDocs.Editor Cloud SDK for Node.js. È possibile caricare programmaticamente una cartella di lavoro, modificare le celle e salvare il risultato utilizzando solo poche chiamate API o semplici comandi cURL. L’architettura basata sul cloud dell’SDK elimina la necessità di installazioni locali di Office e si adatta al carico di lavoro della tua applicazione. Per le distribuzioni in produzione, acquista una licenza che si adatti al tuo modello di utilizzo, e puoi anche ottenere una licenza temporanea per i test dalla pagina della licenza temporanea. Inizia a integrare la modifica di Excel oggi stesso e ottimizza i tuoi flussi di elaborazione dei dati.

FAQs

Come modificare un file Excel in Node.js tramite REST senza scrivere codice HTTP personalizzato?
Utilizza il GroupDocs.Editor Cloud SDK for Node.js, che astrae le chiamate REST e ti consente di modificare un file Excel in Node.js tramite REST con semplici invocazioni di metodo.

Posso aggiornare un foglio XLSX usando l’API REST Node.js per file di grandi dimensioni?
Sì. L’SDK trasmette i dati in streaming e supporta aggiornamenti batch, rendendolo adatto a cartelle di lavoro di grandi dimensioni. Regola compressionLevel e le modifiche batch delle celle per migliorare le prestazioni.

Qual è il modo migliore per modificare un foglio di lavoro Excel programmaticamente con Node.js?
Lavora con gli oggetti worksheet e cell restituiti da editDocument. Questo ti dà il pieno controllo su righe, colonne e valori delle celle senza uscire dall’ambiente Node.js.

Dove posso trovare informazioni su prezzi e licenze?
Tutti i dettagli della licenza, inclusi i livelli di prezzo e una licenza temporanea per la valutazione, sono disponibili nella pagina della licenza temporanea.

Leggi di più

• Modifica foglio Excel tramite REST in Java
• Modifica foglio Excel usando l’API REST in Python
• Migliori pratiche per lo sviluppo dell’editor CSV in Java