Konversi CFM menjadi PDF

Halaman ColdFusion sering perlu dikonversi ketika laporan yang dibuat server harus dikirimkan, dicetak, diarsipkan, atau dibagikan sebagai dokumen tetap. Metode yang diperlukan bergantung pada apakah PDF harus berisi halaman yang dirender oleh ColdFusion atau kode sumber CFM.

Apa itu format CFM

.cfm adalah file ColdFusion Markup yang berisi instruksi CFML bersama HTML, CSS, JavaScript, dan terkadang kueri database. Adobe ColdFusion dan Lucee mengeksekusi file CFM di server untuk menghasilkan halaman dinamis, formulir, laporan, dan komponen aplikasi. File CFM biasanya bukan dokumen akhir: kode sisi server harus dijalankan sebelum browser menerima HTML yang dihasilkannya.

Apa itu format PDF

PDF menyimpan tata letak halaman tetap yang dapat dilihat dan dicetak secara konsisten di Adobe Acrobat Reader, browser web, dan penampil PDF sistem operasi. Format ini sesuai untuk faktur, laporan, pengajuan, dan pengarsipan karena penerima tidak memerlukan ColdFusion atau akses ke database asli. PDF mempertahankan tampilan hasil render, bukan perilaku CFML yang dapat dieksekusi atau sumber data langsung.

Mengonversi halaman ColdFusion yang telah dirender

1. Jalankan file CFM melalui Adobe ColdFusion atau Lucee di web server lokal atau yang di-host.
2. Buka URL HTTP atau HTTPS-nya di browser, misalnya https://example.test/report.cfm?id=42. Lakukan autentikasi terlebih dahulu jika halaman dilindungi.
3. Periksa catatan, gambar, font, tabel, pemisah halaman, dan nilai terhitung sebelum membuat PDF.
4. Pilih Print → Save as PDF di Chrome, Edge, Firefox, atau Safari. Atur ukuran kertas, orientasi, margin, rentang halaman, skala, dan grafik latar belakang sesuai kebutuhan.

Metode browser ini menangkap halaman setelah ColdFusion dan skrip sisi kliennya menghasilkan output. Metode ini biasanya merupakan pilihan terbaik jika kesamaan visual dengan halaman web penting.

Membuat PDF di ColdFusion

Untuk laporan yang Anda kendalikan, Adobe ColdFusion dapat merender markup secara langsung dengan <cfdocument>:

<cfdocument format="pdf" filename="report.pdf" overwrite="true">
    <h1>Sales report</h1>
    <cfoutput>#reportHtml#</cfoutput>
</cfdocument>

Letakkan markup laporan di dalam blok cfdocument, atau bungkus output yang telah dibuat di dalamnya. Versi Adobe ColdFusion dan instalasi Lucee dapat berbeda dalam dukungan mesin PDF, CSS, font, gambar, dan JavaScript, jadi uji versi server yang sebenarnya digunakan. CSS responsif modern dan JavaScript yang hanya berjalan di browser dapat dirender secara berbeda dari halaman yang dilihat di Chrome.

Untuk output otomatis yang sesuai dengan browser, gunakan renderer berbasis Chromium terkini seperti Playwright, Puppeteer, atau Chromium headless terhadap URL yang telah dirender. Perintah Chromium dasar adalah:

chromium --headless --disable-gpu --print-to-pdf=report.pdf "https://example.test/report.cfm?id=42"

Halaman yang dilindungi mungkin memerlukan konteks browser yang telah diautentikasi, cookie sesi, header HTTP, atau endpoint rendering internal. Jangan menempatkan kredensial di URL publik atau menganggap renderer baris perintah dapat mengakses sesi pengguna secara otomatis.

Mengonversi kode sumber CFM

Jika yang diperlukan adalah catatan kode yang dapat dibaca, bukan laporan yang dihasilkan, buka file tersebut di Visual Studio Code, Notepad++, atau code editor lainnya, lalu pilih Print → Save as PDF. PDF yang dihasilkan berisi kode sumber dan komentar; PDF tersebut tidak mengeksekusi CFML, melakukan kueri ke database, atau menyertakan catatan yang dihasilkan. Penyorotan sintaks, nomor baris, dan font monospace dapat meningkatkan kemudahan peninjauan kode, tetapi juga menambah jumlah halaman.

Menggunakan konverter online

Konversi online hanya sesuai untuk HTML yang sudah dirender dan tidak bersifat rahasia, atau ekspor lain yang tidak berisi kode sisi server. Layanan seperti CloudConvert dapat mengonversi upload HTML yang didukung menjadi PDF; periksa apakah layanan saat ini menerima struktur HTML dan aset yang Anda perlukan. Adobe Acrobat online juga merupakan opsi untuk input dokumen yang didukung, tetapi bukan pengganti runtime ColdFusion.

Jangan mengupload file CFM mentah, kredensial database, cookie sesi, source code milik perusahaan, atau data laporan rahasia kecuali ketentuan enkripsi, penyimpanan, pemrosesan, dan penghapusan dari penyedia layanan memenuhi persyaratan Anda. Konverter umum biasanya tidak dapat mengeksekusi ColdFusion, menyelesaikan server-side include, mengakses database aplikasi, atau melakukan autentikasi ke resource yang dilindungi.

Batasan kualitas dan kompatibilitas

• Pencetakan browser dapat menghilangkan warna latar belakang CSS, konten yang melampaui batas, kontrol interaktif, aset yang dimuat secara lazy, atau gambar yang diblokir oleh autentikasi. Aktifkan grafik latar belakang dan periksa setiap halaman PDF yang dihasilkan.
• cfdocument dapat menghasilkan penomoran halaman dan gaya yang berbeda dari browser karena CSS, web font, JavaScript, dan mesin PDF yang didukungnya mungkin berbeda.
• Gunakan URL aset absolut atau yang dapat dijangkau, lalu pastikan proses rendering dapat mengakses gambar, stylesheet, dan font. Path relatif yang berfungsi dalam sesi browser dapat gagal di renderer sisi server atau headless.
• Untuk output yang dapat direproduksi, gunakan parameter URL tetap dan snapshot data yang stabil. Kueri langsung, timestamp, nilai acak, dan sesi khusus pengguna dapat mengubah setiap PDF.
• PDF mempertahankan tampilan, bukan perilaku aplikasi; tautan mungkin tetap dapat diklik, tetapi formulir, filter, menu, pembaruan AJAX, dan fitur interaktif lainnya dapat dihapus atau tidak lagi berfungsi.