Certa vez li em um texto que os sistemas de informação não existem para armazenar informações, e sim para consultar informações. Todo esforço dispendido para desenvolver, implantar e alimentar um sistema existe para que alguém possa extrair dele informações úteis, através das quais possa tomar suas decisões. É nesse contexto que entram os relatórios, através dos quais os usuários podem consultar informações importantes de forma estruturada. Existem diversos tipos de relatórios e diversas ferramentas para construí-los, para cada necessidade e tecnologia. O objetivo deste artigo é apresentar uma forma simples de, em sistemas web, estruturar relatórios não muito extensos através de templates Smarty e gerá-los como PDF. Estou considerando aqui que o leitor já conheça SQL e já saiba fazer filtros de relatório.

Pra quem não conhece, Smarty é uma engine de templates para PHP. Ele facilita o trabalho de separar regras de negócio da apresentação/interface. A princípio, podemos utilizar o Smarty para criar templates de páginas HTML, mas a boa notícia é que podemos templatizar qualquer coisa com ele: HTML, XML, RSS, CSV, qualquer coisa que seja gerado em texto. Já usei Smarty até para templatezar rotinas para um gerador de códigos PHP…

Primeiramente, vamos modelar visualmente nosso relatório através de HTML. Isso pode ser feito tranquilamente através de editores WYSIWYG ou, para os mais experientes, através de algum editor de textos qualquer. Para fazermos a conversão final para PDF, utilizaremos a biblioteca HTML2PDF, baseada na FPDF. Portanto, não é necessário se ater muito a web standards e instruções CSS mais complexas, porque a HTML2PDF provavelmente não vai reconhecê-las corretamente. Neste caso não tem problema utilizar tabelas para compor o layout ou usar recursos como a tag <font> ou atributos bgcolor… Antes de prosseguir, vamos ver alguns itens que são importantes estarem presentes em qualquer relatório, além dos dados:

• Título - O título do relatório identifica que tipo de informações ele traz. São nomes como "Relatório de clientes", "Vendas por cliente", "Saldo da Conta mês a mês"… Isso depende muito de cada necessidade. Em alguns casos pode ser interessante dar também um nome abreviado ou numeração a cada relatório, para ficar mais fácil o chefe do usuário pedir "imprime aí um R07, por favor…".
• Data - Como os dados dos sistemas estão sempre em movimento, é bastante útil que o relatório contenha a data em que foi gerado, para que um leitor possa avaliar a época do quadro apresentado nele.
• Nome do usuário - Para fins de controle, também é útil conhecer qual usuário gerou o relatório. Em alguns sistemas nem todos os usuários possuem acesso a todos os níveis de informações existentes, então em alguns casos usuários diferentes podem obter quadros diferentes.
• Filtro utilizado - Usualmente a geração de um relatório passa por uma tela de filtros, onde o usuário pode definir opções que limitem os resultados, como por exemplo período, categorias, intervalos de valores ou qualquer tipo de pesquisa referente às entidades envolvidas. Para que um relatório não vire um papel sem sentido, é muito importante que nele sejam especificados quais filtros geraram aqueles resultados.
• Nome/logomarca da empresa - Isso personaliza mais o seu relatório. Para esta função talvez seja necessário consultador o departamento responsável pela identidade visual da empresa. Em alguns casos não será necessário imprimir os dados da empresa no relatório, por já disporem de papel timbrado. De qual forma, é bom ter as duas opções.
• Número das páginas e total de páginas - Para que o leitor do relatório saiba se não está faltando páginas, quando pegar uma versão impressa.

Agora, mão na massa:

1 - Abaixo, vamos montar um modelo simples de relatório, para exibir uma lista de pessoas. Para isso estou utilizando um editor WYSIWYG qualquer (eu particularmente recomendaria o Dreamweaver), já utilizando algumas tags Smarty. Uma das principais vantagens deste método é poder trabalhar os relatórios visualmente, deixando essa personalização mais flexível para cada cliente ou situação.

2 - Agora vamos trabalhar um pouquinho nesse código HTML/Smarty dele, que, até o momento está mais ou menos assim:

Depois de alguns ajustes, ficou como este código abaixo (atente para os comentários).

3 - Agora, vamos construir a parte do relatório que extrai os dados (não estou montando aqui a lógica de construção dos filtros, que fica por sua conta).

O relatório HTML no navegador vai ficar desta forma:

4 -  Agora vamos passar o nosso relatório para PDF. Para isso utilizaremos a biblioteca HTML2PDF, disponível gratuitamente no website http://html2fpdf.sourceforge.net/ . Tive que fazer um pequeno ajuste nela para funcionar com PHP5. A versão ajustada estará disponível para download junto a todo o código fonte, no final deste artigo. O código final vai ficar assim:

…sendo exibido desta forma:

E está pronto o nosso relatório!

Algumas observações importantes:

• Não coloque um relatório para abrir na mesma janela em que está a tela anterior do sistema, envie sempre o usuário para uma nova janela. Isso vai facilitar as coisas quando o usuário quiser voltar às demais telas do sistema. Você pode fazer isso utilizando um target="_blank" no link o formulário que leva ao relatório.
• Por questão de compatibilidade com algumas versões do Internet Explorer, acrescente em algum lugar da URL o texto ".pdf". Por exemplo: relatorio_pessoas.php?sexo=M&_ext=.pdf, caso contrário pode ser que o navegador não reconheça o documento como um pdf e gere um resultado estranho na tela.
• Não use este tipo de abordagem para relatórios cujo tamanho possa ultrapassar a memória disponível de seu computador e configuração do PHP. Todo o conteúdo neste caso é gerado em memória, então conteúdos grandes demais vão gerar um erro que impedirá a exibição correta do relatório. Se o seu relatório vai ter milhares de página, é bom procurar outra solução…
• Provavelmente a aparência em PDF não ficar 100% igual ao HTML que você fez, e provavelmente seu código vai precisar passar por alguns ajustes antes que fique perfeito e correto, mas com o tempo você vai pegando o jeito com a HTML2PDF.
• A numeração das páginas a HTML2PDF faz automaticamente.

Então, é isso; espero que tenha gostado. Seque aqui o código fonte final com tudo.

No demais, vida longa e próspera!

RSS feed for comments on this post.
TrackBack URI