Node.js SDK untuk Perakitan Dokumen & Pembuatan Laporan

Integrasikan kemampuan perakitan dokumen yang canggih ke dalam aplikasi Node Anda menggunakan GroupDocs.Assembly Cloud REST API.

  • GroupDocs.Assembly Cloud SDK for cURL
  • GroupDocs.Assembly Cloud SDK for .NET
  • GroupDocs.Assembly Cloud SDK for Java
  • GroupDocs.Assembly Cloud SDK for PHP
  • GroupDocs.Assembly Cloud SDK for Python
  • GroupDocs.Assembly Cloud SDK for Ruby
  • GroupDocs.Assembly Cloud SDK for Go
  • GroupDocs.Assembly Cloud SDK for C++
  • GroupDocs.Assembly Cloud SDK for Swift
Mulai Uji Coba Gratis

GroupDocs.Assembly Cloud adalah layanan berbasis REST yang terkelola sepenuhnya, memungkinkan pengembang membuat dokumen siap cetak dengan format kaya dari templat yang dapat digunakan kembali dan sumber data eksternal.

Platform ini mendukung beragam format sumber dan target – mulai dari berkas Microsoft Office klasik (DOCX, XLSX, PPTX) hingga PDF, HTML, OpenDocument, dan berbagai format grafik – memungkinkan Anda membuat kontrak, faktur, laporan, brosur pemasaran, atau dokumen kustom apa pun tanpa perlu menginstal perangkat lunak pihak ketiga di server Anda sendiri. Semua pekerjaan berat – penguraian templat, pengikatan data, rendering gambar, pembuatan kode batang, evaluasi rumus, dan konversi berkas – dilakukan di cloud, yang memastikan hasil yang konsisten di seluruh sistem operasi dan mengurangi biaya infrastruktur.

Mengapa menggunakan Node.js SDK?

  • Runtime tanpa instalasi – SDK ini merupakan pembungkus tipis di sekitar Assembly Cloud REST API, jadi Anda hanya memerlukan Node12+ dan paket npm. * Lintas-platform – berfungsi sama di Windows, macOS, Linux, atau di dalam kontainer.
  • Aman – semua komunikasi dienkripsi melalui TLS, dan autentikasi dilakukan dengan SID Aplikasi dan Kunci Aplikasi pribadi Anda.
  • Skalabel – layanan cloud dapat menangani permintaan dokumen tunggal maupun pekerjaan Mail-Merge batch bervolume tinggi.
  • Dapat diperluas – API yang sama dapat digunakan dari bahasa apa pun yang dapat memanggil titik akhir REST; SDK Node.js menyederhanakan konstruksi permintaan dan penanganan respons.

Alur kerja umum dalam aplikasi Node.js

  1. Siapkan templat (DOCX, PPTX, dll.) yang berisi kolom placeholder dan konstruksi pemrograman opsional seperti blok kondisional, loop, atau tag kode batang.
  2. Buat sumber data dalam XML atau JSON yang menyediakan nilai yang akan digabungkan ke dalam templat. 3. Unggah templat ke GroupDocs Cloud Storage menggunakan metode uploadFile SDK.
  3. Konfigurasikan AssembleOptions – tentukan jalur templat, sumber data, format keluaran yang diinginkan (PDF, DOCX, HTML, …) dan pengaturan tambahan apa pun (misalnya, pembuatan kode batang, warna latar belakang).
  4. Panggil assembleDocument – SDK mengirimkan satu permintaan HTTP yang memicu proses perakitan di server.
  5. Terima berkas rakitan sebagai array byte, simpan secara lokal, atau alirkan langsung ke klien.

Contoh berikut (ditampilkan di bagian Fitur Lainnya) mendemonstrasikan setiap langkah ini dalam cuplikan kode yang ringkas dan siap produksi.

Fitur API Cloud GroupDocs.Assembly

Hasilkan dokumen dari template menggunakan REST API cloud

Pengikatan data gaya LINQ untuk sumber XML dan JSON

Sisipkan gambar, bagan, dan konten dokumen eksternal

Tabel dan daftar dinamis dari data array

Tambahkan hyperlink, bookmark, dan lampiran email

Terapkan rumus dan operasi data berurutan

Blok konten bersyarat (IF‑ELSE) dalam templat

Hasilkan kode batang (QR, Code128, dll.)

Mengatur warna latar belakang untuk keluaran HTML

Mail‑Merge untuk surat batch yang dipersonalisasi

Hasilkan laporan di Node.js

Cuplikan di bawah ini menunjukkan alur lengkapnya: mengunggah templat, membaca berkas data JSON, mengonfigurasi permintaan assembly, dan menerima dokumen yang telah di-assembly.

Langkah-langkah

  1. Unggah templat DOCX ke GroupDocs Cloud Storage.
  2. Baca berkas data JSON yang berisi nilai-nilai yang akan digabungkan.
  3. Konfigurasi AssembleOptions – pilih format output dan ikat datanya.
  4. Panggil assembleDocument untuk menghasilkan laporan.
  5. Simpan array byte yang dikembalikan sebagai PDF (atau format apa pun yang didukung).
// Ganti dengan App SID dan App Key Anda
const { AssemblyApi, AssembleDocumentRequest, AssembleOptions, TemplateFileInfo, model } = require("groupdocs-assembly-cloud");
const fs = require("fs");
const path = require("path");

// Placeholder otorisasi
const assemblyApi = new AssemblyApi(".#-.#-.#-.#-.#", "......");

// 1️⃣ Unggah berkas templat
const templatePath = "Input1.docx";
const uploadRequest = new model.UploadFileRequest({
fileContent: fs.createReadStream(templatePath),
path: templatePath
});
await assemblyApi.uploadFile(uploadRequest);

// 2️⃣ Baca sumber data (JSON)
const dataPath = "Input2.docx";
const reportData = fs.readFileSync(dataPath, "utf8");

// 3️⃣ Mengatur opsi assembly
const assembleOptions = new AssembleOptions({
saveFormat: "pdf",
reportData: reportData,
templateFileInfo: new TemplateFileInfo({ filePath: templatePath })
});

// 4️⃣ Membuat dan mengirim permintaan assembly
const request = new AssembleDocumentRequest({ assembleOptions });
const result = await assemblyApi.assembleDocument(request);

// 5️⃣ Menyimpan dokumen yang dihasilkan
const outputPath = path.join(__dirname, "GeneratedReport.pdf");
fs.writeFileSync(outputPath, result.body);

console.log("Laporan berhasil dibuat:", outputPath);

Dukungan dan Sumber Belajar

GroupDocs.Assembly Cloud juga menawarkan SDK untuk bahasa lain:

  Indonesia