Converter CFM para PDF

Uma página ColdFusion frequentemente precisa ser convertida quando um relatório gerado pelo servidor deve ser enviado, impresso, arquivado ou compartilhado como um documento fixo. O método necessário depende de o PDF dever conter a página renderizada pelo ColdFusion ou o código-fonte CFM.

O que é o formato CFM

.cfm é um arquivo ColdFusion Markup que contém instruções CFML junto com HTML, CSS, JavaScript e, às vezes, consultas a banco de dados. Adobe ColdFusion e Lucee executam arquivos CFM em um servidor para produzir páginas, formulários, relatórios e componentes de aplicativos dinâmicos. Um arquivo CFM normalmente não é um documento finalizado: o código do lado do servidor precisa ser executado antes que o navegador receba o HTML gerado.

O que é o formato PDF

PDF armazena um layout de página fixo que pode ser visualizado e impresso de forma consistente no Adobe Acrobat Reader, em navegadores da web e em visualizadores de PDF do sistema operacional. Ele é adequado para faturas, relatórios, envios e arquivamento, pois os destinatários não precisam do ColdFusion nem de acesso ao banco de dados original. PDF preserva a aparência renderizada, não o comportamento executável do CFML nem a fonte de dados ativa.

Converter a página ColdFusion renderizada

1. Execute o arquivo CFM por meio do Adobe ColdFusion ou Lucee em um servidor web local ou hospedado.
2. Abra a URL HTTP ou HTTPS em um navegador, por exemplo https://example.test/report.cfm?id=42. Faça a autenticação primeiro se a página estiver protegida.
3. Verifique os registros, imagens, fontes, tabelas, quebras de página e valores calculados antes de criar o PDF.
4. Escolha Print → Save as PDF no Chrome, Edge, Firefox ou Safari. Defina o tamanho do papel, a orientação, as margens, o intervalo de páginas, a escala e os gráficos de fundo conforme necessário.

Este método pelo navegador captura a página depois que o ColdFusion e seus scripts do lado do cliente geraram a saída. Geralmente, é a melhor opção quando a semelhança visual com a página da web é importante.

Gerar o PDF no ColdFusion

Para um relatório sob seu controle, o Adobe ColdFusion pode renderizar a marcação diretamente com <cfdocument>:

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

Coloque a marcação do relatório dentro do bloco cfdocument ou envolva com ele a saída gerada existente. As versões do Adobe ColdFusion e as instalações do Lucee podem apresentar diferenças no mecanismo de PDF e no suporte a CSS, fontes, imagens e JavaScript; portanto, teste a versão exata do servidor. CSS responsivo moderno e JavaScript exclusivo do navegador podem ser renderizados de forma diferente da página visualizada no Chrome.

Para uma saída automatizada e fiel ao navegador, use um renderizador atual baseado em Chromium, como Playwright, Puppeteer ou Chromium headless, tendo como destino a URL renderizada. Um comando básico do Chromium é:

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

Uma página protegida pode exigir um contexto de navegador pré-autenticado, cookie de sessão, cabeçalho HTTP ou endpoint de renderização interno. Não coloque credenciais em uma URL pública nem presuma que um renderizador de linha de comando possa acessar automaticamente uma sessão de usuário.

Converter o código-fonte CFM

Se o requisito for um registro legível do código, e não do relatório gerado, abra o arquivo no Visual Studio Code, Notepad++ ou outro editor de código e escolha Print → Save as PDF. O PDF resultante contém código-fonte e comentários; ele não executa CFML, consulta o banco de dados nem inclui registros gerados. Realce de sintaxe, números de linha e fontes monoespaçadas podem melhorar a revisão do código, mas aumentam o número de páginas.

Usar um conversor online

A conversão online é apropriada apenas para HTML já renderizado e não confidencial ou para outra exportação que não contenha código do lado do servidor. Um serviço como CloudConvert pode converter uploads de HTML compatíveis em PDF; verifique se o serviço atual aceita a estrutura HTML e os recursos necessários. Adobe Acrobat online é outra opção para entradas de documentos compatíveis, mas não substitui um runtime ColdFusion.

Não faça upload de arquivos CFM brutos, credenciais de banco de dados, cookies de sessão, código-fonte proprietário ou dados confidenciais de relatórios, a menos que os termos de criptografia, retenção, processamento e exclusão do provedor atendam aos seus requisitos. Um conversor genérico normalmente não consegue executar ColdFusion, resolver includes do lado do servidor, acessar o banco de dados do aplicativo nem autenticar-se em recursos protegidos.

Limitações de qualidade e compatibilidade

• A impressão pelo navegador pode omitir cores de fundo CSS, conteúdo excedente, controles interativos, recursos carregados sob demanda ou imagens bloqueadas por autenticação. Ative os gráficos de fundo e inspecione todas as páginas do PDF resultante.
• cfdocument pode produzir paginação e estilos diferentes dos de um navegador porque o CSS, as fontes web, o JavaScript e o mecanismo de PDF compatíveis podem ser diferentes.
• Use URLs absolutas ou acessíveis para os recursos e confirme que o processo de renderização pode acessar imagens, folhas de estilo e fontes. Caminhos relativos que funcionam em uma sessão do navegador podem falhar em um renderizador do lado do servidor ou headless.
• Para obter uma saída reproduzível, use parâmetros de URL fixos e um snapshot estável dos dados. Consultas dinâmicas, registros de data e hora, valores aleatórios e sessões específicas de usuários podem alterar cada PDF.
• PDF preserva a aparência, não o comportamento do aplicativo; os links podem continuar clicáveis, mas formulários, filtros, menus, atualizações AJAX e outros recursos interativos podem ser removidos ou deixar de funcionar.