Converter ASP para PDF

Relatórios, faturas e formulários preenchidos gerados por um site Classic ASP são frequentemente necessários como arquivos fixos para email, impressão ou registros quando os destinatários não podem acessar a aplicação IIS. O PDF deve ser criado a partir da página renderizada pelo servidor, não do arquivo-fonte .asp.

O que é um arquivo ASP

Um arquivo .asp normalmente contém código Classic Active Server Pages para Microsoft IIS. Ele pode combinar HTML com VBScript ou JScript, consultas a bancos de dados, include files, valores de sessão e componentes do servidor; o IIS executa esse código e envia o HTML resultante ao navegador.

Um arquivo ASP não é um formato de documento portátil. Abrir report.asp diretamente no File Explorer não o executa por meio do IIS, portanto o código do lado do servidor, o conteúdo do banco de dados e os includes não produzirão a página pretendida. O Classic ASP continua disponível como um recurso do IIS, mas é uma tecnologia antiga; ele é distinto dos arquivos ASP.NET, como .aspx, .cshtml e .razor.

Alguns programas não relacionados também usam a extensão .asp. Se o arquivo não tiver sido originado de um projeto web IIS, identifique a aplicação que o criou antes de tentar convertê-lo.

O que o PDF oferece

O PDF armazena uma visualização de layout fixo de texto, fontes, imagens, gráficos vetoriais e dimensões de página. Os destinatários podem abrir o relatório exportado sem o servidor web, a conexão com o banco de dados, a conta da aplicação ou a sessão que o gerou.

Um PDF preserva a saída visível no momento da exportação, não o comportamento da aplicação web. Consultas ao banco de dados, envio de formulários, estado de login, controles JavaScript e gráficos interativos não permanecem funcionais.

Converter uma página ASP renderizada com um navegador

1. Execute a aplicação no servidor IIS ou em uma instalação local do IIS configurada corretamente. Para o Classic ASP local, habilite o serviço de função do IIS World Wide Web Services → Application Development Features → ASP e configure o site, as permissões do application pool, os caminhos dos includes e o acesso ao banco de dados.
2. Abra a página por meio de seu endereço HTTP ou HTTPS, como http://localhost/reports/monthly.asp. Não abra o arquivo-fonte usando um caminho file://.
3. Faça login e insira os parâmetros do relatório antes da exportação. Aguarde o carregamento completo das tabelas, imagens e gráficos gerados por JavaScript.
4. No Microsoft Edge, Google Chrome, Firefox ou outro navegador atual, escolha Print → Save as PDF. Selecione o tamanho do papel, a orientação, as margens, a escala e os cabeçalhos ou rodapés; em seguida, salve o PDF.

Edge e Chrome geralmente são as melhores opções para uma saída ocasional, pois imprimem a mesma renderização atual do navegador usada para visualizar o relatório. Habilite Background graphics quando o layout usar cabeçalhos coloridos, linhas sombreadas, fundos de logotipo ou imagens de fundo CSS.

Automatizar exportações recorrentes

Para uma página acessível e não autenticada, o Chromium pode imprimir uma URL pela linha de comando: chrome.exe --headless --print-to-pdf=report.pdf http://localhost/reports/monthly.asp. O navegador deve conseguir acessar o site IIS, incluindo todos os assets necessários.

Para páginas autenticadas ou páginas que carregam dados de forma assíncrona, use Playwright ou Puppeteer para fazer login, aguardar um elemento que indique que o relatório está pronto e chamar a função de PDF do navegador. Isso é mais confiável do que imprimir imediatamente a partir de um comando, pois pode manter cookies e aguardar gráficos ou solicitações de API. Evite wkhtmltopdf em sites modernos, a menos que a saída tenha sido testada; seu antigo mecanismo WebKit pode apresentar diferenças substanciais no suporte a CSS e JavaScript.

Conversão online e verificações da saída

Serviços online como CloudConvert podem converter HTML enviado ou uma página web pública em PDF, mas não podem executar um arquivo-fonte ASP enviado como uma aplicação IIS. Use-os somente para HTML já renderizado e não sensível ou para uma URL pública; não envie dados de clientes, cookies de sessão, URLs privadas ou código-fonte.

Use uma folha de estilos de impressão para remover navegação, controles e barras laterais. Regras como @media print, @page e break-inside: avoid podem controlar a visibilidade, as margens, as quebras de página e a divisão de linhas de tabelas.

Inspecione o PDF final em busca de tabelas largas cortadas, fontes ausentes, URLs de imagens quebradas e gráficos atrasados em branco. PDFs gerados pelo navegador não são automaticamente compatíveis com PDF/A nem totalmente marcados para acessibilidade; use um fluxo de trabalho validado de PDF/A ou de acessibilidade quando esses requisitos se aplicarem.