Node.js SDK pour l'assemblage de documents et la génération de rapports
Intégrez des capacités puissantes d’assemblage de documents dans vos applications Node en utilisant GroupDocs.Assembly Cloud REST API.
Intégrez des capacités puissantes d’assemblage de documents dans vos applications Node en utilisant GroupDocs.Assembly Cloud REST API.
GroupDocs.Assembly Cloud est un service entièrement géré, basé sur REST‑, qui permet aux développeurs de créer des documents richement formatés, prêts à l’impression, à partir de modèles réutilisables et de sources de données externes.
La plateforme prend en charge une grande variété de formats source et cible – des fichiers classiques Microsoft Office (DOCX, XLSX, PPTX) aux formats PDF, HTML, OpenDocument et de nombreux formats graphiques – vous permettant de générer des contrats, factures, rapports, brochures marketing ou tout document personnalisé sans installer de logiciel tiers sur vos propres serveurs. Toutes les opérations lourdes – analyse de modèles, liaison de données, rendu d’images, génération de codes-barres, évaluation de formules et conversion de fichiers – sont effectuées dans le cloud, ce qui garantit des résultats cohérents sur tous les systèmes d’exploitation et réduit les coûts d’infrastructure.
Pourquoi utiliser le Node.js SDK ?
Flux de travail typique dans une application Node.js
GroupDocs.AssemblyuploadFile du SDK.AssembleOptions – indiquez le chemin du modèle, la source de données, le format de sortie souhaité (PDF, DOCX, HTML, …) ainsi que les paramètres supplémentaires (par ex., génération de code‑barres, couleur d’arrière‑plan).assembleDocument – le SDK envoie une requête unique HTTP qui déclenche le processus d’assemblage sur le serveur.L’exemple suivant (présenté dans la section More Feature) illustre chacune de ces étapes dans un extrait de code compact et prêt pour la production.
Fonctionnalités de base de l’Assembly Cloud API.
Formats de documents pris en charge par l’Assembly Cloud API.
Systèmes d’exploitation et environnements de développement pris en charge.
Le fragment ci-dessous montre un flux complet : téléversez un modèle, lisez un fichier de données JSON, configurez la requête d’assemblage et recevez le document assemblé.
Étapes
AssembleOptions – choisissez le format de sortie et liez les données.assembleDocument pour générer le rapport.// 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);