Node.js SDK til dokument-samling og rapportgenerering

Integrer kraftfulde dokument-samlingsevner i dine Node-applikationer ved hjælp af GroupDocs.Assembly Cloud REST API.

  • GroupDocs.Assembly Cloud SDK for cURL
  • GroupDocs.Assembly Cloud SDK for .NET
  • GroupDocs.Assembly Cloud SDK for Java
  • GroupDocs.Assembly Cloud SDK for PHP
  • GroupDocs.Assembly Cloud SDK for Python
  • GroupDocs.Assembly Cloud SDK for Ruby
  • GroupDocs.Assembly Cloud SDK for Go
  • GroupDocs.Assembly Cloud SDK for C++
  • GroupDocs.Assembly Cloud SDK til Swift
Start gratis prøveperiode

GroupDocs.Assembly Cloud er en fuldt administreret, REST‑baseret tjeneste, der gør det muligt for udviklere at skabe rigt formaterede, klar‑til‑print dokumenter fra genanvendelige skabeloner og eksterne datakilder.

Platformen understøtter et bredt udvalg af kilde‑ og målformater – fra klassiske Microsoft Office‑filer (DOCX, XLSX, PPTX) til PDF, HTML, OpenDocument og mange grafiske formater – så du kan generere kontrakter, fakturaer, rapporter, marketing‑brochurer eller ethvert tilpasset dokument uden at installere tredjepartssoftware på dine egne servere. Al tungt arbejde – skabelon‑parsing, databinding, billedrendering, stregkode‑generering, formel‑evaluering og filkonvertering – udføres i skyen, hvilket sikrer konsistente resultater på tværs af operativsystemer og reducerer infrastrukturomkostninger.

Hvorfor bruge Node.js SDK?

  • Zero‑install runtime – SDK er en tynd wrapper omkring Assembly Cloud REST API, så du kun behøver Node 12+ og en npm‑pakke.
  • Cross‑platform – fungerer ens på Windows, macOS, Linux eller i containere.
  • Secure – al kommunikation er krypteret via TLS, og godkendelse udføres med din personlige App SID og App Key.
  • Scalable – sky‑tjenesten kan håndtere enkelt‑dokument‑anmodninger såvel som høj‑volumen batch‑Mail‑Merge‑jobs.
  • Extensible – den samme API kan bruges fra ethvert sprog, der kan kalde REST‑endpoints; Node.js SDK forenkler blot anmodnings‑konstruktion og svar‑håndtering.

Typisk arbejdsgang i en Node.js‑applikation

  1. Forbered en skabelon (DOCX, PPTX osv.), der indeholder pladsholder‑felter og valgfrie programmeringskonstruktioner såsom betingede blokke, løkker eller stregkode‑tags.
  2. Opret en datakilde i XML eller JSON, som leverer de værdier, der skal flettes ind i skabelonen.
  3. Upload skabelonen til GroupDocs Cloud Storage ved hjælp af SDK’s uploadFile‑metode.
  4. Konfigurer AssembleOptions – angiv skabelon‑stien, datakilden, det ønskede outputformat (PDF, DOCX, HTML …) og eventuelle ekstra indstillinger (fx stregkode‑generering, baggrundsfarve).
  5. Kald assembleDocument – SDK sender en enkelt HTTP‑anmodning, der udløser samlingsprocessen på serveren.
  6. Modtag den samlede fil som en byte‑array, gem den lokalt eller stream den direkte til klienten.

Det følgende eksempel (vist i afsnittet More Feature) demonstrerer hvert af disse trin i en kompakt, produktionsklar kode‑snippet.

GroupDocs.Assembly Cloud API-funktioner

Generér dokumenter fra skabeloner ved hjælp af cloud-REST API

LINQ‑stil data‑binding til XML og JSON‑kilder

Indsæt billeder, diagrammer og eksternt dokumentindhold

Dynamiske tabeller og lister fra array-data

Tilføj hyperlinks, bogmærker og e-mail-vedhæftninger

Anvend formler og sekventielle dataoperationer

Betingede indholdsblokke (IF‑ELSE) i skabeloner

Generér stregkoder (QR, Code128 osv.)

Angiv baggrundsfarver for HTML-output

Mail‑merge til batch‑personlige breve

Generér en rapport i Node.js

Uddraget nedenfor demonstrerer en komplet flow: upload en skabelon, læs en JSON-datafil, konfigurer samlingsanmodningen og modtag det samlede dokument.

Steps

  1. Upload DOCX-skabelonen til GroupDocs Cloud Storage.
  2. Læs JSON-datafilen som indeholder de værdier, der skal flettes.
  3. Konfigurer AssembleOptions – vælg outputformatet og bind dataene.
  4. Kald assembleDocument for at generere rapporten.
  5. Gem den returnerede byte-array som en PDF (eller et andet understøttet format).
// 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);

Support and Learning Resources

GroupDocs.Assembly Cloud tilbyder også SDKs for andre sprog:

  Dansk
d60a5e453