Node.js SDK für die Dokumentzusammenstellung und Berichterstellung
Integrieren Sie mithilfe der GroupDocs.Assembly Cloud REST API leistungsstarke Funktionen zur Dokumentzusammenstellung in Ihre Node-Anwendungen.
Integrieren Sie mithilfe der GroupDocs.Assembly Cloud REST API leistungsstarke Funktionen zur Dokumentzusammenstellung in Ihre Node-Anwendungen.
GroupDocs.Assembly Cloud ist ein vollständig verwalteter, REST-basierter Dienst, der es Entwicklern ermöglicht, druckfertige Dokumente mit hoher Formatierung 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 hin zu PDF, HTML, OpenDocument und vielen Grafikformaten. So können Sie Verträge, Rechnungen, Berichte, Marketingbroschüren und beliebige benutzerdefinierte Dokumente erstellen, ohne Drittanbietersoftware auf Ihren eigenen Servern installieren zu müssen. Alle wichtigen Aufgaben – Vorlagenanalyse, Datenbindung, Bildwiedergabe, Barcode-Generierung, Formelauswertung und Dateikonvertierung – werden in der Cloud ausgeführt. Dies gewährleistet konsistente Ergebnisse über alle Betriebssysteme hinweg und reduziert die Infrastrukturkosten.
Warum das Node.js SDK verwenden?
Typischer Workflow in einer Node.js-Anwendung
Erstellen Sie eine Vorlage (DOCX, PPTX usw.), die Platzhalterfelder und optionale Programmierkonstrukte wie Bedingungsblöcke, Schleifen oder Barcode-Tags enthält.
Erstellen Sie eine Datenquelle in XML oder JSON, die die in die Vorlage einzufügenden Werte bereitstellt.
Laden Sie die Vorlage mit der Methode „uploadFile“ des SDK in den GroupDocs Cloud Storage hoch.
Konfigurieren Sie „AssembleOptions“ – geben Sie den Vorlagenpfad, die Datenquelle, das gewünschte Ausgabeformat (PDF, DOCX, HTML usw.) und alle weiteren Einstellungen (z. B. Barcode-Generierung, Hintergrundfarbe) an.
Rufen Sie „assembleDocument“ auf – das SDK sendet eine einzelne HTTP-Anfrage, die den Assemblierungsprozess auf dem Server auslöst.
Empfangen Sie die assemblierte Datei als Byte-Array, speichern Sie sie lokal oder streamen Sie sie direkt an den Client.
Das folgende Beispiel (siehe Abschnitt „Weitere Funktionen“) demonstriert jeden dieser Schritte in einem kompakten, produktionsbereiten Codeausschnitt.
Kernfunktionen der Assembly Cloud API.
Unterstützte Dokumentformate für die Assembly Cloud API.
Unterstützte Betriebssysteme und Entwicklungsumgebungen.
Der folgende Codeausschnitt veranschaulicht den vollständigen Ablauf: Vorlage hochladen, JSON-Datendatei lesen, Assembly-Anfrage konfigurieren und assembliertes Dokument erhalten.
Schritte
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);