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‑based service ที่ช่วยให้นักพัฒนาสร้างเอกสารที่มีรูปแบบสวยงามพร้อมพิมพ์จากเทมเพลตที่ใช้ซ้ำได้และแหล่งข้อมูลภายนอก.

แพลตฟอร์มรองรับรูปแบบแหล่งและเป้าหมายที่หลากหลาย – ตั้งแต่ไฟล์ Microsoft Office แบบคลาสสิก (DOCX, XLSX, PPTX) ไปจนถึง PDF, HTML, OpenDocument และรูปแบบกราฟิกหลายประเภท – ทำให้คุณสามารถสร้างสัญญา ใบแจ้งหนี้ รายงาน โบรชัวร์การตลาด หรือเอกสารที่กำหนดเองใด ๆ ได้โดยไม่ต้องติดตั้งซอฟต์แวร์ของบุคคลที่สามบนเซิร์ฟเวอร์ของคุณเอง ทุกการทำงานหนัก – การแยกวิเคราะห์เทมเพลต, การผูกข้อมูล, การเรนเดอร์ภาพ, การสร้างบาร์โค้ด, การประเมินสูตร, และการแปลงไฟล์ – ถูกดำเนินการในคลาวด์ ซึ่งทำให้ผลลัพธ์สม่ำเสมอข้ามระบบปฏิบัติการและลดค่าใช้จ่ายโครงสร้างพื้นฐาน.

ทำไมต้องใช้ Node.js SDK?

  • รันไทม์แบบไม่มีการติดตั้ง – SDK เป็นตัวหุ้มบาง ๆ รอบ Assembly Cloud REST API ดังนั้นคุณเพียงต้องการ Node 12+ และแพคเกจ npm.
  • ข้ามแพลตฟอร์ม – ทำงานเช่นเดียวกันบน Windows, macOS, Linux หรือภายในคอนเทนเนอร์.
  • ปลอดภัย – การสื่อสารทั้งหมดถูกเข้ารหัสผ่าน TLS และการตรวจสอบสิทธิ์ดำเนินการด้วย App SID ส่วนบุคคลของคุณและ App Key.
  • ขยายได้ – บริการคลาวด์สามารถจัดการคำขอเอกสารเดี่ยวรวมถึงงาน Mail‑Merge แบบแบตช์ปริมาณสูง.
  • ขยายได้ – API เดียวกันสามารถใช้จากภาษาใดก็ได้ที่สามารถเรียก endpoint ของ 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. รับไฟล์ที่ประกอบแล้ว เป็นอาร์เรย์ไบต์, บันทึกลงในเครื่องหรือสตรีมโดยตรงไปยังไคลเอนต์.

ตัวอย่างต่อไปนี้ (แสดงในส่วน More Feature) แสดงขั้นตอนเหล่านี้ทั้งหมดในโค้ดสแนปช็อตที่กระชับและพร้อมใช้งานในสภาพแวดล้อมการผลิต.

GroupDocs.Assembly Cloud API คุณลักษณะ

สร้างเอกสารจากเทมเพลตโดยใช้คลาวด์ REST API

การผูกข้อมูลแบบ LINQ‑style สำหรับแหล่งข้อมูล XML และ JSON

แทรกรูปภาพ, แผนภูมิและเนื้อหาเอกสารภายนอก

ตารางและรายการแบบไดนามิกจากข้อมูลอาร์เรย์

เพิ่มไฮเปอร์ลิงก์, ที่คั่นหน้าและไฟล์แนบอีเมล

ใช้สูตรและการดำเนินการข้อมูลแบบต่อเนื่อง

บล็อกเนื้อหาแบบมีเงื่อนไข (IF‑ELSE) ในเทมเพลต

สร้างบาร์โค้ด (QR, Code128, ฯลฯ)

ตั้งค่าสีพื้นหลังสำหรับผลลัพธ์ HTML

เมลเมิร์จสำหรับจดหมายส่วนบุคคลแบบชุด

สร้างรายงานในรูปแบบ Node.js

โค้ดตัวอย่างด้านล่างแสดงกระบวนการครบวงจร: อัปโหลดเทมเพลต, อ่านไฟล์ข้อมูล JSON, กำหนดค่าคำขอการประกอบและรับเอกสารที่ประกอบเสร็จแล้ว

Steps

  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 สำหรับภาษาอื่น ๆ:

  แบบไทย
dcd632280