Molti sviluppatori hanno bisogno di combinare più documenti Word in Node.JS per generare report consolidati o pacchetti. GroupDocs.Merger Cloud SDK for Node.js fornisce un’API potente che gestisce l’unione di Word sul lato server senza codice complesso di gestione dei file. In questa guida vedrai un’implementazione completa, chiamate cURL equivalenti, passaggi di installazione e consigli di best‑practice per unire rapidamente i tuoi documenti.

Unire più documenti Word in Node.JS - Esempio di codice completo

Questo esempio dimostra come unire tre file DOCX in un unico documento utilizzando il GroupDocs.Merger Cloud SDK for Node.js.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input1.docx, combined_output.docx, ecc.) per corrispondere alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Unire documenti Word tramite REST API usando cURL

Se preferisci un approccio REST puro, la stessa operazione di unione può essere eseguita con comandi cURL. Di seguito è riportato un flusso di lavoro conciso che autentica, carica i file di origine, esegue l’unione e scarica il risultato.

1. Autenticazione e Ottenimento del Token di Accesso

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/authenticate" \
-H "Content-Type: application/json" \
-d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

La risposta contiene un access_token utilizzato nelle chiamate successive.

2. Carica i file di origine

Ripeti questo passaggio per ogni file DOCX che desideri unire.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. Esegui l’operazione di unione

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

L’API restituisce il percorso del file unito.

4. Scarica il documento unito

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=documents/combined_output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o combined_output.docx

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

Come funziona l’unione di più documenti Word in Node.JS

L’SDK astrae il processo di unione in alcuni passaggi logici:

  1. Creazione della configurazione - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) crea il contesto di autenticazione. Vedi il riferimento della classe nella Riferimento API.
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
  1. API Instance - new GroupDocsMergerCloud.MergeApi(config) fornisce l’accesso alle operazioni di unione.
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

  1. Voci del documento - Ogni file di origine è avvolto in un DocumentEntry che contiene un FileInfo con il percorso del file.

    const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
    });
});

  2. Richiesta di Unione - MergeDocumentsRequest raggruppa le voci e il percorso di output desiderato.

    const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

  3. Esecuzione - mergeApi.mergeDocuments(mergeRequest) invia la richiesta al servizio cloud. La promessa si risolve con un oggetto risultato contenente il percorso del file di output.

    const result = await mergeApi.mergeDocuments(mergeRequest);
console.log(`Merge completed successfully. Output file: ${result.path}`);

Questi passaggi insieme ti consentono di combinare più documenti Word in modo efficiente senza gestire flussi di file a basso livello.

Preparare l’ambiente per GroupDocs.Merger

  1. Installa l’SDK
npm install groupdocs-merger-cloud

Il pacchetto è disponibile dalla pagina ufficiale di download.

  1. Versione Node.js - Assicurati di eseguire Node.js 12 o versioni successive.

  2. Configura le credenziali - Sostituisci YOUR_CLIENT_ID e YOUR_CLIENT_SECRET nel codice con i valori del tuo account GroupDocs Cloud.

  3. Crea una cartella di progetto - Posiziona i file DOCX di origine in una sottocartella documents/ come mostrato nell’esempio.

Con questi passaggi completati, sei pronto per eseguire lo script di unione o richiamare gli endpoint REST.

Conclusione

Combinare più documenti Word in Node.JS diventa semplice con il GroupDocs.Merger Cloud SDK for Node.js. L’SDK gestisce il caricamento dei file, la logica di unione e la generazione dell’output, consentendoti di concentrarti sulla logica di business anziché sulla manipolazione a basso livello dei file. Ricorda di ottenere una licenza adeguata per l’uso in produzione; puoi iniziare con una licenza temporanea e passare a un abbonamento completo man mano che le tue esigenze crescono. Inizia a unire oggi e ottimizza i flussi di lavoro dei tuoi documenti.

FAQs

  • Come posso combinare più documenti Word in Node.JS usando l’SDK?
    Usa la classe MergeApi per creare una MergeDocumentsRequest che elenca ogni file DOCX come DocumentEntry. L’SDK li unisce nell’ordine fornito e salva il risultato nel percorso di output specificato.

  • È possibile unire PDF insieme con lo stesso SDK?
    Sì, il Merger SDK supporta PDF, DOCX, ODT, e diversi altri formati. Basta modificare le estensioni dei file nell’array inputFiles e l’SDK gestirà automaticamente la conversione. Consulta la documentazione ufficiale per i dettagli sui formati.

  • Quali sono i limiti sul numero di documenti che posso unire in una singola richiesta?
    Il servizio cloud impone un limite di dimensione piuttosto che un conteggio rigido. Finché la dimensione combinata rimane entro la quota del tuo account, puoi unire decine di file. Per batch molto grandi, considera di caricare i file su GroupDocs storage prima e fare riferimento a essi tramite ID.

  • Devo preoccuparmi della licenza per lo sviluppo rispetto alla produzione?
    Lo sviluppo e i test possono utilizzare una licenza temporanea ottenuta dalla pagina della licenza temporanea. Per le distribuzioni in produzione, acquista una licenza completa per sbloccare fusioni illimitate e supporto prioritario.

Read More