Node.js SDK untuk perakitan dokumen & pembuatan laporan

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

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

GroupDocs.Assembly Cloud adalah layanan yang dikelola sepenuhnya, berbasis REST, yang memungkinkan pengembang untuk membuat dokumen berformat kaya dan siap cetak dari templat yang dapat digunakan kembali serta sumber data eksternal.

Platform ini mendukung beragam format sumber dan target – mulai dari file Microsoft Office klasik (DOCX, XLSX, PPTX) hingga PDF, HTML, OpenDocument, serta banyak format grafis – memungkinkan anda menghasilkan kontrak, faktur, laporan, brosur pemasaran, atau dokumen khusus apa pun tanpa harus menginstal perangkat lunak pihak ketiga di server anda sendiri. Semua proses berat – parsing templat, pengikatan data, rendering gambar, pembuatan barcode, evaluasi formula, dan konversi file – dilakukan di cloud, yang memastikan hasil konsisten di semua sistem operasi dan mengurangi biaya infrastruktur.

Mengapa menggunakan Node.js SDK?

  • Runtime tanpa instalasi – SDK adalah lapisan tipis di atas Assembly Cloud REST API, sehingga anda hanya memerlukan Node 12+ dan paket npm.
  • Lintas platform – berfungsi sama pada Windows, macOS, Linux, atau di dalam kontainer.
  • Aman – semua komunikasi dienkripsi melalui TLS, dan autentikasi dilakukan dengan App SID pribadi anda serta App Key.
  • 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 endpoint REST; Node.js SDK hanya menyederhanakan konstruksi permintaan dan penanganan respons.

Alur kerja tipikal dalam aplikasi Node.js

  1. Siapkan templat (DOCX, PPTX, dll.) yang berisi bidang placeholder dan konstruksi pemrograman opsional seperti blok kondisional, loop, atau tag barcode.
  2. Buat sumber data di XML atau JSON yang menyediakan nilai-nilai untuk digabungkan ke dalam templat.
  3. Unggah templat ke GroupDocs Cloud Storage menggunakan metode uploadFile milik SDK.
  4. Konfigurasikan AssembleOptions – tentukan jalur templat, sumber data, format output yang diinginkan (PDF, DOCX, HTML, …) serta pengaturan tambahan apa pun (mis., pembuatan barcode, warna latar).
  5. Panggil assembleDocument – SDK mengirim satu permintaan HTTP yang memicu proses perakitan di server.
  6. Terima file yang telah dirakit sebagai array byte, simpan secara lokal atau streaming langsung ke klien.

Contoh berikut (ditampilkan di bagian More Feature) memperlihatkan setiap langkah ini dalam potongan kode yang ringkas dan siap produksi.

GroupDocs.Assembly Cloud API Fitur

Hasilkan dokumen dari templat menggunakan cloud REST API

Pengikatan data gaya LINQ untuk sumber XML dan JSON

Sisipkan gambar, diagram, 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 template

Hasilkan kode batang (QR, Code128, dll.)

Atur warna latar belakang untuk output HTML

Mail‑Merge untuk surat pribadi dalam batch

Hasilkan laporan dalam Node.js

Potongan kode di bawah menunjukkan alur lengkap: unggah sebuah template, baca file data JSON, konfigurasikan permintaan perakitan, dan terima dokumen yang telah dirakit.

Langkah

  1. Unggah template DOCX ke GroupDocs Cloud Storage.
  2. Baca file data JSON yang berisi nilai-nilai yang akan digabungkan.
  3. Konfigurasikan AssembleOptions – pilih format output dan kaitkan data.
  4. Panggil assembleDocument untuk menghasilkan laporan.
  5. Simpan array byte yang dikembalikan sebagai PDF (atau format lain yang didukung).
// 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);

Dukungan dan Sumber Belajar

GroupDocs.Assembly Cloud juga menawarkan SDKs untuk bahasa lain:

  Indonesia
f5cc89c32