Node.js SDK להרכבת מסמכים ויצירת דוחות
שלבו יכולות עוצמתיות של הרכבת מסמכים ביישומי Node שלכם באמצעות ממשק ה-REST API של GroupDocs.Assembly Cloud.
שלבו יכולות עוצמתיות של הרכבת מסמכים ביישומי Node שלכם באמצעות ממשק ה-REST API של GroupDocs.Assembly Cloud.
GroupDocs.Assembly Cloud הוא שירות מנוהל במלואו, מבוסס REST, המאפשר למפתחים ליצור מסמכים מעוצבים ועשירים ומוכנים להדפסה מתבניות לשימוש חוזר וממקורות נתונים חיצוניים.
הפלטפורמה תומכת במגוון רחב של פורמטים של מקור ויעד - החל מקבצי Microsoft Office קלאסיים (DOCX, XLSX, PPTX) ועד PDF, HTML, OpenDocument ופורמטים גרפיים רבים - ומאפשרת לך ליצור חוזים, חשבוניות, דוחות, חוברות שיווק או כל מסמך מותאם אישית מבלי להתקין תוכנה של צד שלישי בשרתים שלך. כל העבודה הכבדה - ניתוח תבניות, קשירת נתונים, עיבוד תמונות, יצירת ברקודים, הערכת נוסחאות והמרת קבצים - מתבצעת בענן, מה שמבטיח תוצאות עקביות במערכות הפעלה שונות ומפחית את עלויות התשתית.
מדוע להשתמש ב-SDK Node.js? זמן ריצה ללא התקנה - ה-SDK הוא עטיפה דקה סביב ממשק ה-API של Assembly Cloud REST, כך שאתה זקוק רק ל-Node12+ ולחבילת npm. פלטפורמה צולבת - פועלת אותו הדבר ב-Windows, macOS, Linux או בתוך מכולות.
** * מאובטח – כל התקשורת מוצפנת באמצעות TLS, והאימות מתבצע באמצעות מזהה ה-SID האישי ומפתח האפליקציה שלך.
זרימת עבודה אופיינית ביישום Node.js
הכן תבנית (DOCX, PPTX וכו’) המכילה שדות placeholder ומבני תכנות אופציונליים כגון בלוקים מותנים, לולאות או תגי ברקוד.
צור מקור נתונים ב-XML או JSON המספק את הערכים שיש למזוג לתבנית.
העלה את התבנית ל-GroupDocs Cloud Storage באמצעות שיטת uploadFile של ה-SDK.
הגדר את AssembleOptions – ציין את נתיב התבנית, מקור הנתונים, פורמט הפלט הרצוי (PDF, DOCX, HTML, …) וכל הגדרה נוספת (למשל, יצירת ברקוד, צבע רקע).
קרא ל-assembleDocument – ה-SDK שולח בקשת HTTP אחת שמפעילה את תהליך ההרכבה בשרת.
קבל את הקובץ המורכב כמערך בתים, שמור אותו באופן מקומי או הזרם אותו ישירות ללקוח.
הדוגמה הבאה (המוצגת בסעיף תכונות נוספות) מדגימה כל אחד מהשלבים הללו בקטע קוד קומפקטי ומוכן לייצור.
יכולות ליבה של ממשק ה-API של Assembly Cloud.
פורמטים נתמכים של מסמכים עבור Assembly Cloud API.
מערכות הפעלה וסביבות פיתוח נתמכות.
הקטע למטה מדגים תהליך מלא: העלאת תבנית, קריאת קובץ נתוני JSON, הגדרת בקשת ההרכבה וקבלת המסמך המורכב.
שלבים
העלאת את תבנית ה-DOCX לאחסון ענן GroupDocs.
קריאת קובץ נתוני ה-JSON המכיל את הערכים שיש למזג.
הגדרת AssembleOptions – בחירת פורמט הפלט וקשירת הנתונים.
קריאה ל-assembleDocument כדי ליצור את הדוח.
שמירה של מערך הבייטים המוחזר כקובץ PDF (או כל פורמט נתמך).
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);