Convertir CFM a PDF

Una página de ColdFusion a menudo necesita convertirse cuando un informe generado por el servidor debe enviarse, imprimirse, archivarse o compartirse como un documento fijo. El método requerido depende de si el PDF debe contener la página renderizada por ColdFusion o el código fuente de CFM.

Qué es el formato CFM

.cfm es un archivo de marcado de ColdFusion que contiene instrucciones de CFML junto con HTML, CSS, JavaScript y, en ocasiones, consultas a bases de datos. Adobe ColdFusion y Lucee ejecutan archivos CFM en un servidor para producir páginas dinámicas, formularios, informes y componentes de aplicaciones. Normalmente, un archivo CFM no es un documento terminado: el código del servidor debe ejecutarse antes de que el navegador reciba el HTML generado.

Qué es el formato PDF

PDF almacena un diseño de página fijo que puede visualizarse e imprimirse de forma coherente en Adobe Acrobat Reader, navegadores web y visores de PDF del sistema operativo. Es adecuado para facturas, informes, envíos y archivado porque los destinatarios no necesitan ColdFusion ni acceso a la base de datos original. PDF conserva el aspecto renderizado, no el comportamiento ejecutable de CFML ni la fuente de datos activa.

Convertir la página de ColdFusion renderizada

1. Ejecute el archivo CFM mediante Adobe ColdFusion o Lucee en un servidor web local o alojado.
2. Abra su URL HTTP o HTTPS en un navegador, por ejemplo https://example.test/report.cfm?id=42. Autentíquese primero si la página está protegida.
3. Verifique los registros, las imágenes, las fuentes, las tablas, los saltos de página y los valores calculados antes de crear el PDF.
4. Elija Print → Save as PDF en Chrome, Edge, Firefox o Safari. Configure el tamaño del papel, la orientación, los márgenes, el intervalo de páginas, la escala y los gráficos de fondo según sea necesario.

Este método del navegador captura la página después de que ColdFusion y sus scripts del lado del cliente hayan generado el resultado. Normalmente es la mejor opción cuando es importante que el aspecto sea similar al de la página web.

Generar el PDF en ColdFusion

Para un informe bajo su control, Adobe ColdFusion puede renderizar el marcado directamente con <cfdocument>:

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

Coloque el marcado del informe dentro del bloque cfdocument o incluya en él el resultado generado existente. Las versiones de Adobe ColdFusion y las instalaciones de Lucee pueden diferir en el motor de PDF y en la compatibilidad con CSS, fuentes, imágenes y JavaScript, por lo que debe probar la versión exacta del servidor. El CSS responsive moderno y el JavaScript que solo funciona en el navegador pueden renderizarse de forma diferente a la página visualizada en Chrome.

Para obtener resultados automatizados fieles al navegador, use un renderizador actual basado en Chromium, como Playwright, Puppeteer o Chromium headless, contra la URL renderizada. Un comando básico de Chromium es:

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

Una página protegida puede requerir un contexto de navegador previamente autenticado, una cookie de sesión, un encabezado HTTP o un endpoint de renderizado interno. No coloque credenciales en una URL pública ni suponga que un renderizador de línea de comandos puede acceder automáticamente a una sesión de usuario.

Convertir el código fuente de CFM

Si el requisito es un registro legible del código en lugar del informe generado, abra el archivo en Visual Studio Code, Notepad++ u otro editor de código y elija Print → Save as PDF. El PDF resultante contiene el código fuente y los comentarios; no ejecuta CFML, consulta la base de datos ni incluye los registros generados. El resaltado de sintaxis, los números de línea y las fuentes monoespaciadas pueden mejorar la revisión del código, pero aumentan el número de páginas.

Usar un convertidor en línea

La conversión en línea solo es adecuada para HTML ya renderizado y no confidencial, u otra exportación que no contenga código del servidor. Un servicio como CloudConvert puede convertir cargas de HTML compatibles a PDF; compruebe si el servicio actual acepta la estructura HTML y los recursos que necesita. Adobe Acrobat online es otra opción para los documentos de entrada compatibles, pero no sustituye a un runtime de ColdFusion.

No cargue archivos CFM sin procesar, credenciales de bases de datos, cookies de sesión, código fuente propietario ni datos confidenciales de informes a menos que los términos de cifrado, retención, procesamiento y eliminación del proveedor cumplan sus requisitos. Normalmente, un convertidor genérico no puede ejecutar ColdFusion, resolver inclusiones del servidor, acceder a la base de datos de la aplicación ni autenticarse en recursos protegidos.

Limitaciones de calidad y compatibilidad

• La impresión desde el navegador puede omitir colores de fondo CSS, contenido desbordado, controles interactivos, recursos cargados de forma diferida o imágenes bloqueadas por la autenticación. Active los gráficos de fondo y revise todas las páginas del PDF resultante.
• cfdocument puede producir una paginación y un estilo diferentes de los del navegador porque su CSS, sus fuentes web, su JavaScript y su motor de PDF compatibles pueden ser distintos.
• Use URL de recursos absolutas o accesibles y confirme que el proceso de renderizado pueda acceder a las imágenes, las hojas de estilos y las fuentes. Las rutas relativas que funcionan en una sesión del navegador pueden fallar en un renderizador del lado del servidor o headless.
• Para obtener resultados reproducibles, use parámetros de URL fijos y una instantánea de datos estable. Las consultas activas, las marcas de tiempo, los valores aleatorios y las sesiones específicas del usuario pueden cambiar cada PDF.
• PDF conserva el aspecto en lugar del comportamiento de la aplicación; los enlaces pueden seguir siendo interactivos, pero los formularios, filtros, menús, actualizaciones AJAX y otras funciones interactivas pueden eliminarse o dejar de funcionar.