Converti CFM in PDF

Una pagina ColdFusion spesso richiede una conversione quando un report generato dal server deve essere inviato, stampato, archiviato o condiviso come documento fisso. Il metodo richiesto dipende dal fatto che il PDF debba contenere la pagina renderizzata da ColdFusion oppure il codice sorgente CFM.

Che cos'è il formato CFM

.cfm è un file ColdFusion Markup contenente istruzioni CFML insieme a HTML, CSS, JavaScript e talvolta query di database. Adobe ColdFusion e Lucee eseguono i file CFM su un server per produrre pagine dinamiche, moduli, report e componenti applicativi. Un file CFM normalmente non è un documento finito: il codice lato server deve essere eseguito prima che il browser riceva l'HTML generato.

Che cos'è il formato PDF

PDF memorizza un layout di pagina fisso che può essere visualizzato e stampato in modo uniforme in Adobe Acrobat Reader, nei browser e nei visualizzatori PDF del sistema operativo. È adatto a fatture, report, invii e archiviazione perché i destinatari non hanno bisogno di ColdFusion né di accedere al database originale. PDF conserva l'aspetto renderizzato, non il comportamento CFML eseguibile o la fonte dati attiva.

Convertire la pagina ColdFusion renderizzata

1. Eseguire il file CFM tramite Adobe ColdFusion o Lucee su un web server locale o ospitato.
2. Aprire il relativo URL HTTP o HTTPS in un browser, ad esempio https://example.test/report.cfm?id=42. Eseguire prima l'autenticazione se la pagina è protetta.
3. Verificare i record, le immagini, i font, le tabelle, le interruzioni di pagina e i valori calcolati prima di creare il PDF.
4. Scegliere Print → Save as PDF in Chrome, Edge, Firefox o Safari. Impostare, secondo necessità, il formato della carta, l'orientamento, i margini, l'intervallo di pagine, la scala e la grafica di sfondo.

Questo metodo del browser acquisisce la pagina dopo che ColdFusion e i relativi script lato client hanno generato l'output. Di solito è la scelta migliore quando è importante che l'aspetto sia simile a quello della pagina web.

Generare il PDF in ColdFusion

Per un report sotto il proprio controllo, Adobe ColdFusion può eseguire il rendering diretto del markup con <cfdocument>:

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

Inserire il markup del report all'interno del blocco cfdocument oppure racchiudere in esso l'output generato esistente. Le versioni di Adobe ColdFusion e le installazioni di Lucee possono differire per il motore PDF e per il supporto a CSS, font, immagini e JavaScript; pertanto, testare la versione esatta del server. I moderni CSS responsive e il JavaScript specifico dei browser possono essere renderizzati in modo diverso rispetto alla pagina visualizzata in Chrome.

Per un output automatizzato e fedele al browser, usare un renderer aggiornato basato su Chromium, come Playwright, Puppeteer o Chromium headless, sull'URL renderizzato. Un comando Chromium di base è:

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

Una pagina protetta potrebbe richiedere un contesto del browser già autenticato, un cookie di sessione, un'intestazione HTTP o un endpoint di rendering interno. Non inserire le credenziali in un URL pubblico né presumere che un renderer da riga di comando possa accedere automaticamente alla sessione di un utente.

Convertire il codice sorgente CFM

Se il requisito è un resoconto leggibile del codice anziché del report generato, aprire il file in Visual Studio Code, Notepad++ o un altro editor di codice e scegliere Print → Save as PDF. Il PDF risultante contiene il codice sorgente e i commenti; non esegue CFML, non interroga il database e non include i record generati. L'evidenziazione della sintassi, i numeri di riga e i font monospaziati possono facilitare la revisione del codice, ma aumentano il numero di pagine.

Utilizzare un convertitore online

La conversione online è appropriata solo per HTML già renderizzato e non riservato o per un'altra esportazione che non contenga codice lato server. Un servizio come CloudConvert può convertire in PDF i caricamenti HTML supportati; verificare se il servizio attuale accetta la struttura HTML e gli asset necessari. Adobe Acrobat online è un'altra opzione per gli input di documenti supportati, ma non sostituisce un runtime ColdFusion.

Non caricare file CFM grezzi, credenziali del database, cookie di sessione, codice sorgente proprietario o dati riservati dei report a meno che i termini del provider relativi a crittografia, conservazione, trattamento ed eliminazione soddisfino i propri requisiti. Un convertitore generico normalmente non può eseguire ColdFusion, risolvere gli include lato server, accedere al database dell'applicazione o autenticarsi alle risorse protette.

Limiti di qualità e compatibilità

• La stampa dal browser può omettere i colori di sfondo CSS, i contenuti oltre il limite, i controlli interattivi, gli asset caricati pigramente o le immagini bloccate dall'autenticazione. Abilitare la grafica di sfondo e controllare ogni pagina del PDF risultante.
• cfdocument può produrre una paginazione e uno stile diversi da quelli del browser perché i CSS, i web font, il JavaScript e il motore PDF supportati possono differire.
• Usare URL assoluti o raggiungibili per gli asset e verificare che il processo di rendering possa accedere a immagini, fogli di stile e font. I percorsi relativi che funzionano in una sessione del browser possono non funzionare in un renderer lato server o headless.
• Per ottenere un output riproducibile, usare parametri URL fissi e uno snapshot stabile dei dati. Query in tempo reale, timestamp, valori casuali e sessioni specifiche dell'utente possono modificare ogni PDF.
• PDF conserva l'aspetto anziché il comportamento dell'applicazione; i collegamenti possono rimanere cliccabili, ma moduli, filtri, menu, aggiornamenti AJAX e altre funzionalità interattive possono essere rimossi o diventare non funzionanti.