Node.js SDK für die Dokumentenassemblierung und Berichtserstellung

Integrieren Sie leistungsstarke Dokumentenassemblierungsfunktionen in Ihre Node-Anwendungen mithilfe von GroupDocs.Assembly Cloud REST API.

  • GroupDocs.Assembly Cloud SDK für cURL
  • GroupDocs.Assembly Cloud SDK für .NET
  • GroupDocs.Assembly Cloud SDK für Java
  • GroupDocs.Assembly Cloud SDK für PHP
  • GroupDocs.Assembly Cloud SDK für Python
  • GroupDocs.Assembly Cloud SDK für Ruby
  • GroupDocs.Assembly Cloud SDK für Go
  • GroupDocs.Assembly Cloud SDK für C++
  • GroupDocs.Assembly Cloud SDK für Swift
Kostenlos testen

GroupDocs.Assembly Cloud ist ein vollständig verwalteter, auf REST‑basierter Service, der Entwicklern ermöglicht, reich formatierte, druckfertige Dokumente aus wiederverwendbaren Vorlagen und externen Datenquellen zu erstellen.

Die Plattform unterstützt eine Vielzahl von Quell‑ und Zielformaten – von klassischen Microsoft Office‑Dateien (DOCX, XLSX, PPTX) bis zu PDF, HTML, OpenDocument und vielen Grafikformaten – und erlaubt Ihnen, Verträge, Rechnungen, Berichte, Marketingbroschüren oder beliebige benutzerdefinierte Dokumente zu erzeugen, ohne Drittanbieter‑Software auf Ihren eigenen Servern installieren zu müssen. Alle schweren Aufgaben – Vorlagen‑Parsing, Datenbindung, Bildrendering, Barcode‑Erzeugung, Formelauswertung und Dateikonvertierung – werden in der Cloud durchgeführt, was konsistente Ergebnisse über Betriebssysteme hinweg sicherstellt und Infrastrukturkosten reduziert.

Warum das Node.js SDK verwenden?

  • Zero‑install‑Runtime – das SDK ist ein leichter Wrapper um die Assembly Cloud REST API, sodass Sie nur Node 12+ und ein npm‑Paket benötigen.
  • Cross‑platform – funktioniert identisch auf Windows, macOS, Linux oder in Containern.
  • Secure – die gesamte Kommunikation ist über TLS verschlüsselt, und die Authentifizierung erfolgt mit Ihrer persönlichen App‑SID und App Key.
  • Scalable – der Cloud‑Service kann sowohl Einzel‑Dokument‑Anfragen als auch hochvolumige Batch‑Mail‑Merge‑Jobs verarbeiten.
  • Extensible – dieselbe API kann aus jeder Sprache verwendet werden, die REST‑Endpunkte aufrufen kann; das Node.js SDK vereinfacht lediglich die Erstellung von Anfragen und die Verarbeitung von Antworten.

Typischer Workflow in einer Node.js‑Anwendung

  1. Vorlage vorbereiten (DOCX, PPTX usw.), die Platzhalterfelder und optionale Programmierkonstrukte wie bedingte Blöcke, Schleifen oder Barcode‑Tags enthält.
  2. Datenquelle erstellen in XML oder JSON, die die in die Vorlage zu übernehmenden Werte bereitstellt.
  3. Vorlage hochladen zu GroupDocs Cloud Storage mittels der SDK‑uploadFile‑Methode.
  4. AssembleOptions konfigurieren – geben Sie den Vorlagenpfad, die Datenquelle, das gewünschte Ausgabeformat (PDF, DOCX, HTML, …) und weitere Einstellungen (z. B. Barcode‑Erzeugung, Hintergrundfarbe) an.
  5. assembleDocument aufrufen – das SDK sendet eine einzelne HTTP‑Anfrage, die den Assemblierungsprozess auf dem Server auslöst.
  6. Das zusammengefügte Dokument empfangen als Byte‑Array, lokal speichern oder direkt an den Client streamen.

Das folgende Beispiel (angezeigt im Abschnitt Weitere Funktionen) demonstriert jeden dieser Schritte in einem kompakten, produktionsbereiten Code‑Snippet.

GroupDocs.Assembly Cloud API Funktionen

Erzeugen Sie Dokumente aus Vorlagen mithilfe von Cloud REST API

Datenbindung im LINQ‑Stil für XML‑ und JSON‑Quellen

Fügen Sie Bilder, Diagramme und externe Dokumenteninhalte ein

Dynamische Tabellen und Listen aus Array-Daten

Fügen Sie Hyperlinks, Lesezeichen und E-Mail-Anhänge hinzu

Wenden Sie Formeln und sequenzielle Datenoperationen an

Bedingte Inhaltsblöcke (IF‑ELSE) in Vorlagen

Erzeugen Sie Barcodes (QR, Code128 usw.)

Setzen Sie die Hintergrundfarben für die Ausgabe von HTML fest

Serienbrief für stapelweise personalisierte Briefe

Erzeugen Sie einen Bericht in Node.js

Das nachstehende Snippet demonstriert einen vollständigen Ablauf: Laden Sie eine Vorlage hoch, lesen Sie eine JSON-Datendatei, konfigurieren Sie die Assembly-Anfrage und erhalten Sie das zusammengefügte Dokument.

Schritte

  1. Hochladen der DOCX-Vorlage in GroupDocs Cloud Storage.
  2. Lesen der JSON-Datendatei, die die zu zusammenzuführenden Werte enthält.
  3. Konfigurieren von AssembleOptions – wählen Sie das Ausgabeformat und binden Sie die Daten.
  4. Aufrufen von assembleDocument, um den Bericht zu erzeugen.
  5. Speichern des zurückgegebenen Byte-Arrays als PDF (oder ein beliebiges unterstütztes 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- und Lernressourcen

GroupDocs.Assembly Cloud bietet außerdem SDKs für andere Sprachen an:

  Deutsch
aef9619ee