Automatizzare gli aggiornamenti dei fogli di calcolo è una necessità comune quando si costruiscono servizi web basati sui dati o pipeline di reporting. Il GroupDocs.Editor Cloud SDK for Node.js consente di modificare file Excel in Node.js tramite REST con poche righe di codice. In questo tutorial vedrai come configurare l’SDK, caricare una cartella di lavoro XLSX, modificare una cella, salvare le modifiche e ottenere lo stesso risultato usando chiamate cURL grezze. Discuteremo anche delle funzionalità chiave, delle opzioni di configurazione e delle considerazioni sulle prestazioni per aiutarti a integrare la modifica di Excel in modo efficiente.

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);
  1. 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);
  1. 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);
  1. 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";
}
  1. 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.

  1. 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"

  1. 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" }
               ]
           }
         }'

  2. 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ù