Node.js SDK להרכבת מסמכים ויצירת דוחות

שלב יכולות הרכבת מסמכים חזקות ביישומי Node שלך באמצעות GroupDocs.Assembly Cloud REST ו-API.

  • GroupDocs.Assembly Cloud SDK עבור cURL
  • GroupDocs.Assembly Cloud SDK עבור .NET
  • GroupDocs.Assembly Cloud SDK עבור Java
  • GroupDocs.Assembly Cloud SDK עבור PHP
  • GroupDocs.Assembly Cloud SDK עבור Python
  • GroupDocs.Assembly Cloud SDK עבור Ruby
  • GroupDocs.Assembly Cloud SDK עבור Go
  • GroupDocs.Assembly Cloud SDK עבור C++
  • GroupDocs.Assembly Cloud SDK לSwift
התחל ניסיון חינם

GroupDocs.Assembly Cloud הוא שירות מנוהל במלואו, מבוסס REST המאפשר למפתחים ליצור מסמכים עשירים בפורמט, מוכנים להדפסה, מתבניות ניתנות לשימוש חוזר ומקורות נתונים חיצוניים.

הפלטפורמה תומכת במגוון רחב של פורמטים מקור ויעד – מקבצי Microsoft Office קלאסיים (DOCX, XLSX, PPTX) ועד PDF, HTML, OpenDocument ורבות פורמטים גרפיים – ומאפשרת לך ליצור חוזים, חשבוניות, דוחות, חוברות שיווק או כל מסמך מותאם ללא צורך בהתקנת תוכנה של צד שלישי בשרתים שלך. כל העיבוד הכבד – ניתוח תבניות, קישור נתונים, רינדור תמונות, יצירת ברקוד, הערכת נוסחאות והמרת קבצים – מתבצע בענן, מה שמבטיח תוצאות עקביות בין מערכות הפעלה ומפחית עלויות תשתית.

למה להשתמש ב‑Node.js SDK?

  • Zero‑install runtime – ה‑SDK הוא עטיפה קלה סביב Assembly Cloud REST API, ולכן אתה זקוק רק ל‑Node 12+ ולחבילת npm.
  • Cross‑platform – פועל באופן זהה על Windows, macOS, Linux או בתוך קונטיינרים.
  • Secure – כל התקשורת מוצפנת באמצעות TLS, והאימות מתבצע עם ה‑App SID האישי שלך ו‑App Key.
  • Scalable – שירות הענן יכול להתמודד עם בקשות מסמך יחיד וגם עם משימות מיזוג דואר בכמויות גבוהות.
  • Extensible – ניתן להשתמש ב‑API מאותה שפה שמסוגלת לקרוא לנקודות הקצה של REST; ה‑Node.js SDK פשוט מפשט את בניית הבקשה וטיפול בתגובה.

תהליך עבודה טיפוסי ביישום Node.js

  1. הכן תבנית (DOCX, PPTX וכו’) המכילה שדות מצביעים ובנויים תכנותיים אופציונליים כגון בלוקים תנאים, לולאות או תגי ברקוד.
  2. צור מקור נתונים ב‑XML או ב‑JSON המספק את הערכים למיזוג לתבנית.
  3. העלה את התבנית ל‑GroupDocs Cloud Storage באמצעות שיטת uploadFile של ה‑SDK.
  4. הגדר את AssembleOptions – ציין את נתיב התבנית, מקור הנתונים, פורמט הפלט הרצוי (PDF, DOCX, HTML, …) וכל הגדרה נוספת (למשל, יצירת ברקוד, צבע רקע).
  5. קרא ל‑assembleDocument – ה‑SDK שולח בקשת HTTP יחידה שמפעילה את תהליך ההרכבה בשרת.
  6. קבל את הקובץ המורכב כמערך בתים, שמור אותו מקומית או זרום אותו ישירות ללקוח.

הדוגמה הבאה (המוצגת בקטע תכונה נוספת) מדגימה כל אחד מהשלבים בקוד קצר, מוכן לייצור.

GroupDocs.Assembly Cloud API תכונות

צור מסמכים מתבניות באמצעות REST API ענן

קישור נתונים בסגנון LINQ עבור מקורות XML ו‑JSON

הוסף תמונות, תרשימים ותוכן מסמכים חיצוניים

טבלאות ורשימות דינמיות מנתוני מערך

הוסף קישורים, סימניות וקבצי מצורפים לדוא״ל

הפעל נוסחאות ופעולות נתונים סדרתיות

בלוקי תוכן מותנים (IF‑ELSE) בתבניות

צור ברקודים (QR, Code128 וכדומה)

הגדר צבעי רקע עבור פלט HTML

מיזוג דואר למכתבים מותאמים אישית בצורת אצווה

צור דוח ב-Node.js

הקטע שלהלן מדגים זרימה מלאה: העלה תבנית, קרא קובץ הנתונים JSON, הגדר את בקשת האסמבליה וקבל את המסמך המורכב.

שלבים

  1. העלה את תבנית DOCX ל-GroupDocs Cloud Storage.
  2. קרא את קובץ הנתונים JSON שמכיל את הערכים למיזוג.
  3. הגדר את AssembleOptions – בחר פורמט פלט וקשר את הנתונים.
  4. קרא ל-assembleDocument כדי ליצור את הדוח.
  5. שמור את מערך הבייטים שהוחזר כ-PDF (או כל פורמט נתמך).
// 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 מציע גם SDKs לשפות אחרות:

  עִברִית
bacb502d9