Konversi ASP menjadi PDF

Report, invoice, dan formulir yang telah selesai yang dihasilkan oleh situs Classic ASP sering kali diperlukan sebagai file tetap untuk email, pencetakan, atau arsip ketika penerima tidak dapat mengakses aplikasi IIS. PDF harus dibuat dari halaman yang dirender server, bukan dari file sumber .asp.

Apa itu file ASP

File .asp biasanya berisi kode Classic Active Server Pages untuk Microsoft IIS. File tersebut dapat menggabungkan HTML dengan VBScript atau JScript, kueri database, file include, nilai session, dan komponen sisi server; IIS menjalankan kode tersebut dan mengirimkan HTML yang dihasilkan ke browser.

File ASP bukan format dokumen portabel. Membuka report.asp langsung dari File Explorer tidak menjalankannya melalui IIS, sehingga kode sisi server, konten database, dan include tidak akan menghasilkan halaman yang dimaksud. Classic ASP masih tersedia sebagai fitur IIS, tetapi merupakan teknologi yang lebih lama; teknologi ini berbeda dari file ASP.NET seperti .aspx, .cshtml, dan .razor.

Beberapa program yang tidak berkaitan juga menggunakan ekstensi .asp. Jika file tersebut tidak berasal dari proyek web IIS, identifikasi aplikasi yang membuatnya sebelum mencoba melakukan konversi.

Apa yang disediakan PDF

PDF menyimpan tampilan tata letak tetap dari teks, font, gambar, grafik vektor, dan dimensi halaman. Penerima dapat membuka report yang diekspor tanpa web server, koneksi database, akun aplikasi, atau session yang menghasilkannya.

PDF mempertahankan output yang terlihat pada saat ekspor, bukan perilaku aplikasi web. Kueri database, pengiriman formulir, status login, kontrol JavaScript, dan grafik interaktif tidak akan tetap berfungsi.

Konversi halaman ASP yang dirender dengan browser

1. Jalankan aplikasi di server IIS atau instalasi IIS lokal yang dikonfigurasi dengan benar. Untuk Classic ASP lokal, aktifkan layanan peran IIS World Wide Web Services → Application Development Features → ASP dan konfigurasikan situs, izin application pool, jalur include, serta akses database.
2. Buka halaman melalui alamat HTTP atau HTTPS-nya, seperti http://localhost/reports/monthly.asp. Jangan membuka file sumber dengan jalur file://.
3. Masuk dan masukkan parameter report sebelum ekspor. Tunggu hingga tabel, gambar, dan grafik yang dibuat JavaScript selesai dimuat.
4. Di Microsoft Edge, Google Chrome, Firefox, atau browser terbaru lainnya, pilih Print → Save as PDF. Pilih ukuran kertas, orientasi, margin, skala, serta header atau footer, lalu simpan PDF.

Edge dan Chrome biasanya merupakan pilihan terbaik untuk output satu kali karena keduanya mencetak rendering browser terkini yang sama dengan yang digunakan untuk melihat report. Aktifkan Grafik latar belakang ketika tata letak menggunakan judul berwarna, baris berarsir, latar belakang logo, atau gambar latar belakang CSS.

Mengotomatiskan ekspor berulang

Untuk halaman yang dapat diakses dan tidak memerlukan autentikasi, Chromium dapat mencetak URL dari command line: chrome.exe --headless --print-to-pdf=report.pdf http://localhost/reports/monthly.asp. Browser harus dapat menjangkau situs IIS, termasuk aset apa pun yang diperlukan.

Untuk halaman yang memerlukan autentikasi atau halaman yang memuat data secara asynchronous, gunakan Playwright atau Puppeteer untuk masuk, menunggu elemen report siap, lalu memanggil fungsi PDF browser. Cara ini lebih andal daripada langsung mencetak dari command karena dapat mempertahankan cookie dan menunggu grafik atau permintaan API. Hindari wkhtmltopdf untuk situs modern kecuali outputnya telah diuji; engine WebKit lamanya dapat sangat berbeda dalam dukungan CSS dan JavaScript.

Konversi online dan pemeriksaan output

Layanan online seperti CloudConvert dapat mengonversi HTML yang diunggah atau halaman web publik menjadi PDF, tetapi layanan tersebut tidak dapat menjalankan file sumber ASP yang diunggah sebagai aplikasi IIS. Gunakan layanan tersebut hanya untuk HTML yang sudah dirender dan tidak sensitif atau URL publik; jangan unggah data pelanggan, cookie session, URL privat, atau kode sumber.

Gunakan print stylesheet untuk menghapus navigasi, kontrol, dan sidebar. Aturan seperti @media print, @page, dan break-inside: avoid dapat mengontrol visibilitas, margin, pemisah halaman, dan pemisahan baris tabel.

Periksa PDF akhir untuk mengetahui apakah ada tabel lebar yang terpotong, font yang hilang, URL gambar yang rusak, dan grafik tertunda yang kosong. PDF yang dibuat browser tidak otomatis memenuhi standar PDF/A atau sepenuhnya diberi tag untuk aksesibilitas; gunakan alur kerja PDF/A atau aksesibilitas yang telah divalidasi jika persyaratan tersebut berlaku.