Tutorial de iReport para uso no SIGA O que é isso? O JasperReports é um gerador de relatórios de código livre. É fácil de ser integrado a aplicações empresariais, embora não contenha um editor de relatórios visual integrado. Portanto, para usar diretamente o JasperReports, precisaríamos manipular sua estrutura de relatórios XML - uma atividade relativamente complexa. Uma alternativa é usar uma ferramenta gráfica para facilitar o seu uso. Este tutorial demonstra como uma dessas ferramentas, o iReport, pode aproveitar todo o poder do JasperReports, sem entrar nas complexidades do formato XML nativo. Objetivo A idéia é utilizar o iReport para criar relatórios sobre a base de dados do SIGA, em vez de soluções comerciais como PDFs ou relatórios do Crystal Reports. Uma vez criados, estes relatórios poderão ser incorporados ao SIGA. Uma boa notícia é que quem já usou o Crystal encontrará muitas semelhanças com esta ferramenta. Instalação Neste CD se encontram os arquivos necessários para instalar e usar o iReport (que já inclui o próprio JasperReports). Siga os passos abaixo: 1) O cliente Oracle precisa estar instalado na sua máquina e com o JDBC (Java DataBase Connectivity - o que permite a conexão entre aplicativos Java e os bancos de dados). Dependendo da versão do cliente Oracle, a pasta que nos interessa pode ser c:\Oracle\Ora81\jdbc\lib ou c:\orant\jdbc\lib. Verifique a existência de uma destas pastas em sua máquina (ela deve conter alguns arquivos como classes102.zip ou classes111.zip; se o diretório não existir, reinstale o cliente Oracle). Copie o arquivo classes12.zip do CD neste diretório. 2) Instale o Java na sua máquina (se já não o tiver). No CD encontra-se o JDK 1.6 completo (jdk-6-windows-i586.exe). 3) Instale o iReport. No CD rode iReport-1.3.1-windows-installer.exe. Obs.: Esta instalação é para uso em Windows. Para instalação em Linux ou outras plataformas, tanto o Java como o iReport tem versões que podem ser usadas e vale tudo que estiver descrito neste tutorial. O único detalhe que mereceria estudo adicional é o cliente Oracle com seu driver JDBC. 1 Configurando o iReport Após a instalação, conforme acima, rode o iReport. 1) Entre em “Options – Classpath” e clique em “Add JAR”. Indique ao iReport o arquivo classes12.zip, instalado no item anterior. Clique no botão “Save Classpath”. 2) Adicione uma nova conexão referente ao banco de dados. Use o menu "Data Connections/Datasources" para tal. A janela estará vazia. Clique no botão “New”. Entre com os dados conforme figura abaixo: O exemplo acima usa o banco de teste (a senha está mascarada, mas você sabe qual é...). Clique no botão “Test”. Se estiver tudo certo, deve funcionar. Salve com “Save”. 3) Crie uma nova conexão para o banco “quente”, trocando o “Name” para ufjfq (por exemplo) e altere os campos “Server Adress”, “User Name” e “Password” de acordo. 4) Na janela que surgir após a criação da conexão, marque qual banco deve ser o “default”, com o botão “Set as Default”. 2 Criando um Relatório de Teste Crie um novo documento JasperReports usando o item de menu "File/New Document". Apenas daremos um nome ao relatório: “Paises”. Podemos ignorar todas as demais opções por enquanto. Clique em “OK”. Teremos assim um relatório vazio. Um relatório JasperReport é dividido nas seções de exibição mostradas na tela iReport: 1. Title: como o nome o indica, esta seção contém o título do relatório; 2. Page Header: esta seção aparece no topo de cada página (como esperado). É um bom lugar para colocar datas, numeração de páginas, etc.; 3. Column Header: esta seção aparece no topo de cada coluna; 4. Detail: nesta área serão colocadas as informações para cada item de registro. O JasperReports gera uma seção de detalhe para todo e cada registro processado; 5. Column Footer: esta seção aparece ao final de cada coluna; 6. Page Footer: esta seção aparece ao final de cada página; 7. Last Page Footer: esta seção aparece ao final da última página; 8. Summary: esta seção aparece ao término do relatório, logo após o último registro. Quem já usou o Crystal Reports ou outro gerador gráfico vai começar a entender só de olhar... Para começar, especificamos uma consulta SQL apropriada para o relatório, utilizando o menu “Data - Report Query”. Inclua o texto “select idpais,pais from cm_pais”, conforme figura abaixo: Agora clique em “OK”, para voltar à janela principal. Lá, dê um duplo clique na entrada “Fields” da janela “Library” no canto inferior direito da janela. Devem aparecer os campos IDPAIS e PAIS, como abaixo: 3 Arraste-os para a seção “detail” do layout e acione o menu “Build-Execute (with active connection)” (ou use a última setinha do primeiro toolbar). Salve o relatório em alguma pasta apropriada, aguarde alguns segundos e... pronto! Aí está o Jasper em ação! 4 Note os componentes do toolbar. Querendo adicionar um texto de título, por exemplo, use o botão . Ajuste as dimensões das seções do relatório conforme desejado, inclua títulos, data, número de página, etc. Enfim, explore o ambiente, pois ele tem muito a oferecer. Ao final poderíamos ter um layout como abaixo: O que geraria um relatório como o seguinte: Esta é a parte inicial de nossa experiência com o iReport (instalação, criação de conexão e primeiros passos). Maiores detalhes, “perfumarias” e congêneres serão discutidos e aprendidos em conjunto... 5