Converti ASP in PDF

I report, le fatture e i moduli compilati generati da un sito Classic ASP sono spesso necessari come file fissi per l'invio tramite email, la stampa o l'archiviazione quando i destinatari non possono accedere all'applicazione IIS. Il PDF deve essere creato dalla pagina elaborata dal server, non dal file sorgente .asp.

Che cos'è un file ASP

Un file .asp contiene normalmente codice Classic Active Server Pages per Microsoft IIS. Può combinare HTML con VBScript o JScript, query di database, file include, valori di sessione e componenti lato server; IIS esegue tale codice e invia al browser l'HTML risultante.

Un file ASP non è un formato di documento portatile. L'apertura diretta di report.asp da Esplora file non lo esegue tramite IIS, quindi il codice lato server, i contenuti del database e gli include non produrranno la pagina prevista. Classic ASP è ancora disponibile come funzionalità di IIS, ma è una tecnologia obsoleta; è distinta dai file ASP.NET come .aspx, .cshtml e .razor.

Anche alcuni programmi non correlati utilizzano l'estensione .asp. Se il file non proviene da un progetto web IIS, identifica l'applicazione che lo ha creato prima di tentare la conversione.

Cosa offre il PDF

Il PDF memorizza una visualizzazione a layout fisso di testo, caratteri, immagini, grafica vettoriale e dimensioni delle pagine. I destinatari possono aprire il report esportato senza il web server, la connessione al database, l'account dell'applicazione o la sessione che lo ha generato.

Un PDF conserva l'output visibile al momento dell'esportazione, non il comportamento dell'applicazione web. Le query di database, l'invio dei moduli, lo stato di accesso, i controlli JavaScript e i grafici interattivi non rimangono funzionanti.

Convertire una pagina ASP elaborata con un browser

1. Esegui l'applicazione sul relativo server IIS o su un'installazione IIS locale configurata correttamente. Per Classic ASP locale, abilita il servizio ruolo IIS World Wide Web Services → Application Development Features → ASP e configura il sito, le autorizzazioni dell'application pool, i percorsi degli include e l'accesso al database.
2. Apri la pagina tramite il relativo indirizzo HTTP o HTTPS, ad esempio http://localhost/reports/monthly.asp. Non aprire il file sorgente con un percorso file://.
3. Accedi ed esegui i parametri del report prima dell'esportazione. Attendi il completamento del caricamento di tabelle, immagini e grafici generati da JavaScript.
4. In Microsoft Edge, Google Chrome, Firefox o un altro browser aggiornato, scegli Print → Save as PDF. Seleziona il formato della carta, l'orientamento, i margini, la scala e le intestazioni o i piè di pagina, quindi salva il PDF.

Edge e Chrome sono solitamente le scelte migliori per un output occasionale perché stampano la stessa visualizzazione corrente del browser utilizzata per visualizzare il report. Abilita Grafica di sfondo quando il layout utilizza intestazioni colorate, righe ombreggiate, sfondi con logo o immagini di sfondo CSS.

Automatizzare le esportazioni ripetute

Per una pagina accessibile e non autenticata, Chromium può stampare un URL dalla riga di comando: chrome.exe --headless --print-to-pdf=report.pdf http://localhost/reports/monthly.asp. Il browser deve poter raggiungere il sito IIS, incluse tutte le risorse necessarie.

Per le pagine autenticate o quelle che caricano i dati in modo asincrono, utilizza Playwright o Puppeteer per accedere, attendere un elemento che indichi che il report è pronto e chiamare la funzione PDF del browser. Questo è più affidabile della stampa immediata da un comando perché può conservare i cookie e attendere i grafici o le richieste API. Evita wkhtmltopdf per i siti moderni, a meno che il relativo output non sia stato testato; il suo vecchio motore WebKit può differire notevolmente nel supporto di CSS e JavaScript.

Conversione online e controlli dell'output

I servizi online come CloudConvert possono convertire HTML caricato o una pagina web pubblica in PDF, ma non possono eseguire un file sorgente ASP caricato come applicazione IIS. Utilizzali solo per HTML non sensibile già elaborato o per un URL pubblico; non caricare dati dei clienti, cookie di sessione, URL privati o codice sorgente.

Utilizza un foglio di stile per la stampa per rimuovere navigazione, controlli e barre laterali. Regole come @media print, @page e break-inside: avoid possono controllare la visibilità, i margini, le interruzioni di pagina e la suddivisione delle righe delle tabelle.

Esamina il PDF finale per verificare la presenza di tabelle larghe tagliate, caratteri mancanti, URL di immagini non funzionanti e grafici ritardati vuoti. I PDF generati dal browser non sono automaticamente conformi a PDF/A né completamente contrassegnati per l'accessibilità; quando tali requisiti sono applicabili, utilizza un flusso di lavoro PDF/A o per l'accessibilità convalidato.