Cara Mengautomasikan Penciptaan Dokumen PDF dengan Penyampai HTML

Mengautomasikan penciptaan dokumen ialah ciri penting bagi kebanyakan produk SaaS, sama ada untuk menjana invois, laporan atau sijil. Menggunakan pemapar HTML, pembangun boleh menukar kandungan HTML dinamik kepada dokumen PDF atau imej PNG berkualiti tinggi dengan hanya beberapa baris kod. Dalam panduan ini, kami akan menunjukkan kepada anda cara untuk menyepadukan keupayaan pembuatan dokumen ExoAPI ke dalam produk SaaS anda, menjimatkan masa dan usaha.

Mengapa Mengautomasikan Penjanaan Dokumen?

Mengautomasikan penciptaan dokumen membolehkan perniagaan untuk:

• Jana dokumen yang konsisten dan kelihatan profesional pada skala.
• Jimat masa dengan mengautomasikan tugasan berulang seperti penginvoisan atau penjanaan laporan.
• Tingkatkan ketepatan dengan mengalih keluar penciptaan dokumen manual, mengurangkan risiko ralat.
• Tawarkan pelanggan dokumen tersuai berdasarkan data dinamik (cth., laporan diperibadikan).

Gunakan Kes untuk Penjanaan Dokumen Automatik

Berikut ialah beberapa contoh praktikal di mana keupayaan automasi dokumen boleh memudahkan aliran kerja produk SaaS anda:

• Sistem Invois: Menjana PDF invois pelanggan secara automatik berdasarkan butiran pesanan. Contoh: Selepas pelanggan membuat pesanan, jana PDF invois berjenama secara dinamik dan e-mel kepada mereka.
• Papan Pemuka Pelaporan: Benarkan pengguna memuat turun laporan sebagai PDF. Contoh: Produk SaaS yang menawarkan analitis boleh membenarkan pengguna mengeksport data mereka sebagai laporan PDF yang kelihatan profesional.
• Sijil dan Lencana: Cipta sijil atau lencana PNG yang boleh dimuat turun untuk penyiapan kursus, acara atau pencapaian. Contoh: Platform e-pembelajaran boleh menjana sijil tersuai secara automatik untuk pelajar selepas menamatkan kursus.
• Ringkasan Pesanan untuk E-dagang: Menjana pengesahan pesanan atau label penghantaran secara automatik dalam format PDF atau PNG. Contoh: Selepas pesanan dibuat, hasilkan label penghantaran sebagai PDF, sedia untuk dicetak.

Mari kita lihat cara menyediakan penjanaan dokumen automatik menggunakan Renderer HTML ExoAPI.

Prasyarat: Daftar untuk ExoAPI

Lawati ExoAPI dan daftar akaun untuk mendapatkan kunci API anda.

1. Pasang SDK:

npm install @flower-digital/exoapi-sdk

2. Buat Contoh ExoAPI:

Dalam aplikasi JavaScript atau Node.js anda, mulakan ExoAPI dengan kunci API anda:

import { ExoAPI } from "@flower-digital/exoapi-sdk";
const exoapi = new ExoAPI({ apiKey: YOUR_API_KEY });

Contoh Asas Penjanaan PDF

Sekarang, mari lihat contoh mudah untuk menjana PDF daripada kandungan HTML. Coretan kod berikut menunjukkan cara membuat dokumen PDF dengan penggayaan asas:

npm install @flower-digital/exoapi-sdk

Cara Ia Berfungsi:

• Fungsi htmlRenderer() menghantar rentetan HTML ke ExoAPI, yang memprosesnya dan mengembalikan dokumen PDF.
• Kami menyimpan PDF secara setempat menggunakan modul fs Node.js, menulis fail sebagai document.pdf.
• Anda boleh menggantikan rentetan HTML dengan kandungan atau templat dinamik berdasarkan keperluan aplikasi anda (cth., butiran pelanggan, ringkasan pesanan).

Penyesuaian PDF Lanjutan

ExoAPI menawarkan pelbagai pilihan untuk menyesuaikan PDF anda. Anda boleh mengawal saiz halaman, jidar, orientasi, pengepala, pengaki dan juga menyuntik CSS tersuai untuk penggayaan yang tepat.

Berikut ialah contoh lanjutan yang menunjukkan cara untuk menyesuaikan output PDF:

import { ExoAPI } from "@flower-digital/exoapi-sdk";
const exoapi = new ExoAPI({ apiKey: YOUR_API_KEY });

Parameter Utama:

• tajuk: Tajuk dokumen PDF, yang akan muncul dalam metadata.
• pageSize: Mentakrifkan saiz PDF (cth., A4, Letter, dsb.). Anda juga boleh menetapkan dimensi eksplisit menggunakan pageWidth dan pageHeight.
• margin: Menetapkan jidar seragam untuk dokumen, atau gunakan marginTop, marginLeft, dsb., untuk kawalan yang lebih terperinci.
• landskap: Tetapkan kepada benar untuk orientasi landskap atau palsu untuk potret.
• css: CSS tersuai boleh ditambah untuk menggayakan kandungan dokumen.
• pengepala & pengaki: Anda boleh menambah pengepala dan pengaki dengan ruang letak untuk pageNumber, jumlahHalaman dan tarikh.

Menjana Imej PNG

ExoAPI juga menyokong penjanaan imej PNG daripada kandungan HTML. Ini berguna apabila anda memerlukan output visual, seperti lencana, sijil atau laporan visual. Berikut ialah contoh cara menjana imej PNG:

import { ExoAPI } from "@flower-digital/exoapi-sdk";
import fs from "fs";

const exoapi = new ExoAPI({ apiKey: YOUR_API_KEY });

async function htmlRenderer() {
  try {
    const res = await exoapi.htmlRenderer({
      html: '<p style="padding:8px;font-size:36px">Hello <b style="color: green">world!</b></p>',
      format: "pdf",
    });
    fs.writeFileSync("document.pdf", Buffer.from(await res.arrayBuffer()));
    console.log("PDF document generated successfully!");
  } catch (err) {
    console.error("Error generating PDF:", err);
  }
}

htmlRenderer();

Menyesuaikan Dimensi Imej:

• Parameter ImageWidth dan imageHeight membolehkan anda menentukan saiz imej PNG dalam piksel.
• Jika imageHeight tidak diberikan, ia akan menyesuaikan diri secara automatik agar sesuai dengan kandungan.

Mulakan

Penyampai HTML ExoAPI menjadikan penciptaan dokumen dalam produk SaaS sangat mudah dan boleh disesuaikan. Dengan hanya beberapa baris kod, anda boleh mengautomasikan penjanaan PDF dan imej, memperkemas proses seperti invois, pelaporan dan mencipta dokumen yang menarik secara visual. Dengan menyepadukan ExoAPI ke dalam aliran kerja anda, anda boleh meningkatkan kefungsian aplikasi anda sambil menjimatkan masa pada tugasan pembuatan dokumen manual.

Cuba ExoAPI hari ini untuk melihat cara ia boleh memudahkan penciptaan dokumen dan meningkatkan produktiviti dalam aplikasi SaaS anda. Lihat dokumentasi rasmi ExoAPI untuk meneroka lebih banyak ciri dan pilihan penyesuaian.

Atas ialah kandungan terperinci Cara Mengautomasikan Penciptaan Dokumen PDF dengan Penyampai HTML. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!