Node.js SDK til dokumentsamling og rapportgenerering
Integrer effektive dokumentassembleringsfunktioner i dine Node-applikationer ved hjælp af GroupDocs.Assembly Cloud REST API.
Integrer effektive dokumentassembleringsfunktioner i dine Node-applikationer ved hjælp af GroupDocs.Assembly Cloud REST API.
GroupDocs.Assembly Cloud er en fuldt administreret, REST-baseret tjeneste, der gør det muligt for udviklere at oprette rigt formaterede, printklare dokumenter fra genanvendelige skabeloner og eksterne datakilder.
Platformen understøtter en bred vifte af kilde- og målformater – fra klassiske Microsoft Office-filer (DOCX, XLSX, PPTX) til PDF, HTML, OpenDocument og mange grafikformater – hvilket giver dig mulighed for at generere kontrakter, fakturaer, rapporter, marketingbrochurer eller ethvert brugerdefineret dokument uden at installere tredjepartssoftware på dine egne servere. Alt tungt arbejde – skabelonparsing, databinding, billedgengivelse, stregkodegenerering, formelevaluering og filkonvertering – udføres i skyen, hvilket sikrer ensartede resultater på tværs af operativsystemer og reducerer infrastrukturomkostninger.
Hvorfor bruge Node.js SDK? Zero-install runtime – SDK’et er en tynd indpakning omkring Assembly Cloud REST API’en, så du behøver kun Node12+ og en npm-pakke. Cross-platform – fungerer ens på Windows, macOS, Linux eller i containere.
** * Sikker – al kommunikation krypteres via TLS, og godkendelse udføres med dit personlige App SID og App-nøgle.
Typisk arbejdsgang i en Node.js-applikation
Forbered en skabelon (DOCX, PPTX osv.), der indeholder pladsholderfelter og valgfri programmeringskonstruktioner såsom betingede blokke, løkker eller stregkodetags.
Opret en datakilde i XML eller JSON, der leverer de værdier, der skal flettes ind i skabelonen.
Upload skabelonen til GroupDocs Cloud Storage ved hjælp af SDK’ens uploadFile-metode.
Konfigurer AssembleOptions – angiv skabelonstien, datakilden, det ønskede outputformat (PDF, DOCX, HTML osv.) og eventuelle yderligere indstillinger (f.eks. generering af stregkoder, baggrundsfarve).
Kald assembleDocument – SDK’et sender en enkelt HTTP-anmodning, der udløser assembly-processen på serveren.
Modtag den assemblerede fil som et byte-array, gem den lokalt, eller stream den direkte til klienten.
Følgende eksempel (vist i afsnittet Flere funktioner) demonstrerer hvert af disse trin i et kompakt, produktionsklar kodestykke.
Kernefunktioner i Assembly Cloud API’en.
Understøttede dokumentformater til Assembly Cloud API.
Understøttede operativsystemer og udviklingsmiljøer.
Uddraget nedenfor demonstrerer et komplet flow: upload en skabelon, læs en JSON-datafil, konfigurer assembly-anmodningen, og modtag det assembly-dokument.
Trin
Upload DOCX-skabelonen til GroupDocs Cloud Storage.
Læs JSON-datafilen, der indeholder de værdier, der skal flettes.
Konfigurer AssembleOptions – vælg outputformatet, og bind dataene.
Kald assembleDocument for at generere rapporten.
Gem det returnerede byte-array som en PDF (eller et andet understøttet format).
GroupDocs.Assembly// 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);