SDK Node.js per l'assemblaggio di documenti e la generazione di report
Integra potenti funzionalità di assemblaggio di documenti nelle tue applicazioni Node utilizzando l’API REST GroupDocs.Assembly Cloud.
Integra potenti funzionalità di assemblaggio di documenti nelle tue applicazioni Node utilizzando l’API REST GroupDocs.Assembly Cloud.
GroupDocs.Assembly Cloud è un servizio completamente gestito basato su REST che consente agli sviluppatori di creare documenti riccamente formattati e pronti per la stampa a partire da modelli riutilizzabili e fonti dati esterne.
La piattaforma supporta un’ampia varietà di formati sorgente e di destinazione, dai classici file di Microsoft Office (DOCX, XLSX, PPTX) a PDF, HTML, OpenDocument e molti formati grafici, consentendo di generare contratti, fatture, report, brochure di marketing o qualsiasi documento personalizzato senza dover installare software di terze parti sui propri server. Tutte le attività più complesse – analisi dei modelli, data binding, rendering delle immagini, generazione di codici a barre, valutazione delle formule e conversione dei file – vengono eseguite nel cloud, il che garantisce risultati coerenti su tutti i sistemi operativi e riduce i costi infrastrutturali.
Perché utilizzare l’SDK Node.js?
Flusso di lavoro tipico in un’applicazione Node.js
GroupDocs.AssemblyuploadFile dell’SDK.AssembleOptions: specifica il percorso del modello, l’origine dati, il formato di output desiderato (PDF, DOCX, HTML, ecc.) e qualsiasi impostazione aggiuntiva (ad esempio, generazione di codici a barre, colore di sfondo).assembleDocument: l’SDK invia una singola richiesta HTTP che attiva il processo di assemblaggio sul server.L’esempio seguente (mostrato nella sezione Altre funzionalità) illustra ciascuno di questi passaggi in uno snippet di codice compatto e pronto per la produzione.
Funzionalità principali dell’API Assembly Cloud.
Formati di documento supportati per l’API Assembly Cloud.
Sistemi operativi e ambienti di sviluppo supportati.
Il frammento di codice seguente illustra un flusso completo: caricamento di un modello, lettura di un file di dati JSON, configurazione della richiesta di assemblaggio e ricezione del documento assemblato.
Passaggi
AssembleOptions: scegliere il formato di output e associare i dati.assembleDocument per generare il report.// Replace with your App SID and App Key
const { AssemblyApi, AssembleDocumentRequest, AssembleOptions, TemplateFileInfo, model } = require("groupdocs-assembly-cloud");
const fs = require("fs");
const path = require("path");
// Authorization placeholder
const assemblyApi = new AssemblyApi(".#-.#-.#-.#-.#", "......");
// 1️⃣ Upload the template file
const templatePath = "Input1.docx";
const uploadRequest = new model.UploadFileRequest({
fileContent: fs.createReadStream(templatePath),
path: templatePath
});
await assemblyApi.uploadFile(uploadRequest);
// 2️⃣ Read the data source (JSON)
const dataPath = "Input2.docx";
const reportData = fs.readFileSync(dataPath, "utf8");
// 3️⃣ Set assembly options
const assembleOptions = new AssembleOptions({
saveFormat: "pdf",
reportData: reportData,
templateFileInfo: new TemplateFileInfo({ filePath: templatePath })
});
// 4️⃣ Create and send the assemble request
const request = new AssembleDocumentRequest({ assembleOptions });
const result = await assemblyApi.assembleDocument(request);
// 5️⃣ Save the resulting document
const outputPath = path.join(__dirname, "GeneratedReport.pdf");
fs.writeFileSync(outputPath, result.body);
console.log("Report generated successfully:", outputPath);