Node.js SDK per l'assemblaggio di documenti e la generazione di report
Integra potenti capacità di assemblaggio di documenti nelle tue applicazioni Node usando GroupDocs.Assembly Cloud REST API.
Integra potenti capacità di assemblaggio di documenti nelle tue applicazioni Node usando GroupDocs.Assembly Cloud REST API.
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 di dati esterne.
La piattaforma supporta una vasta gamma di formati di origine e destinazione – dai classici file Microsoft Office (DOCX, XLSX, PPTX) a PDF, HTML, OpenDocument e molti formati grafici – permettendoti di generare contratti, fatture, report, brochure di marketing o qualsiasi documento personalizzato senza installare alcun software di terze parti sui tuoi server. Tutto il lavoro pesante – parsing dei modelli, binding dei dati, rendering delle immagini, generazione di codici a barre, valutazione di formule e conversione dei file – viene eseguito nel cloud, garantendo risultati coerenti su tutti i sistemi operativi e riducendo i costi di infrastruttura.
Perché usare Node.js SDK?
Flusso di lavoro tipico in un’applicazione Node.js
GroupDocs.AssemblyuploadFile di SDK.AssembleOptions – specifica il percorso del modello, la fonte dati, il formato di output desiderato (PDF, DOCX, HTML, …) e eventuali impostazioni aggiuntive (es. generazione di codici a barre, colore di sfondo).assembleDocument – SDK invia una singola richiesta HTTP che avvia il processo di assemblaggio sul server.Il seguente esempio (mostrato nella sezione More Feature) dimostra ciascuno di questi passaggi in uno snippet di codice compatto e pronto per la produzione.
Funzionalità principali dell’Assembly Cloud API.
Formati di documento supportati per Assembly Cloud API.
Sistemi operativi e ambienti di sviluppo supportati.
Il frammento seguente dimostra un flusso completo: carica un modello, leggi un file dati JSON, configura la richiesta di assemblaggio e ricevi il documento assemblato.
Passaggi
AssembleOptions – scegli il formato di output e associa 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);