Tutorial de iReport para uso no SIGA

O que isso?
O JasperReports um gerador de relatrios de cdigo livre. fcil de ser integrado
a aplicaes empresariais, embora no contena um editor de relatrios visual integrado.
!ortanto, para usar diretamente o JasperReports, precisar"amos manipular sua estrutura
de relatrios #$% & uma atividade relativamente comple'a. (ma alternativa usar uma
ferramenta grfica para facilitar o seu uso. )ste tutorial demonstra como uma dessas
ferramentas, o iReport, pode aproveitar todo o poder do JasperReports, sem entrar nas
comple'idades do formato #$% nativo.
Objetivo
* idia utili+ar o iReport para criar relatrios sobre a base de dados do ,-.*, em
ve+ de solues comerciais como !/0s ou relatrios do 1r2stal Reports. (ma ve+
criados, estes relatrios podero ser incorporados ao ,-.*.
(ma boa not"cia 3ue 3uem 4 usou o 1r2stal encontrar muitas semelanas com
esta ferramenta.
Instalao
5este 1/ se encontram os ar3uivos necessrios para instalar e usar o iReport 63ue
4 inclui o prprio JasperReports7. ,iga os passos abai'o8
97 O cliente Oracle precisa estar instalado na sua m3uina e com o J/:1 6Java /ata:ase
1onnectivit2 & o 3ue permite a cone'o entre aplicativos Java e os bancos de dados7.
/ependendo da verso do cliente Oracle, a pasta 3ue nos interessa pode ser
c8;Oracle;Ora<9;4dbc;lib ou c8;orant;4dbc;lib. =erifi3ue a e'ist>ncia de uma destas pastas
em sua m3uina 6ela deve conter alguns ar3uivos como classes9?@.+ip ou classes999.+ipA
se o diretrio no e'istir, reinstale o cliente Oracle7. 1opie o ar3uivo classes9@.+ip do 1/
neste diretrio.
@7 -nstale o Java na sua m3uina 6se 4 no o tiver7. 5o 1/ encontra&se o J/B 9.C
completo 64dD&C&EindoEs&iF<C.e'e7.
G7 -nstale o iReport. 5o 1/ rode iReport&9.G.9&EindoEs&installer.e'e.
Obs.8 )sta instalao para uso em HindoEs. !ara instalao em %inu' ou outras
plataformas, tanto o Java como o iReport tem verses 3ue podem ser usadas e vale tudo
3ue estiver descrito neste tutorial. O Inico detale 3ue mereceria estudo adicional o
cliente Oracle com seu driver J/:1.

1
Configurando o iReport
*ps a instalao, conforme acima, rode o iReport.
97 )ntre em JOptions K 1lasspatL e cli3ue em J*dd J*RL. -ndi3ue ao iReport o ar3uivo
classes9@.+ip, instalado no item anterior. 1li3ue no boto J,ave 1lasspatL.
@7 *dicione uma nova cone'o referente ao banco de dados. (se o menu M/ata &
1onnectionsN/atasourcesM para tal. * 4anela estar va+ia. 1li3ue no boto J5eEL. )ntre
com os dados conforme figura abai'o8
O e'emplo acima usa o banco de teste 6a sena est mascarada, mas voc> sabe
3ual ...7. 1li3ue no boto JOestL. ,e estiver tudo certo, deve funcionar. ,alve com J,aveL.
G7 1rie uma nova cone'o para o banco J3uenteL, trocando o J5ameL para uf4f3 6por
e'emplo7 e altere os campos J,erver *dressL, J(ser 5ameL e J!assEordL de acordo.
P7 5a 4anela 3ue surgir aps a criao da cone'o, mar3ue 3ual banco deve ser o
JdefaultL, com o boto J,et as /efaultL.
2
Criando u Relat!rio de Teste

1rie um novo documento JasperReports usando o item de menu M0ileN5eE
/ocumentM. *penas daremos um nome ao relatrio8 J!aisesL. !odemos ignorar todas as
demais opes por en3uanto. 1li3ue em JOBL. Oeremos assim um relatrio va+io. (m
relatrio JasperReport dividido nas sees de e'ibio mostradas na tela iReport8

"# Title$ como o nome o indica, esta seo contm o t"tulo do relatrioA
%# &age 'eader$ esta seo aparece no topo de cada pgina 6como esperado7. um
bom lugar para colocar datas, numerao de pginas, etc.A
(# Colun 'eader$ esta seo aparece no topo de cada colunaA
)# *etail$ nesta rea sero colocadas as informaes para cada item de registro. O
JasperReports gera uma seo de detale para todo e cada registro processadoA
+# Colun ,ooter$ esta seo aparece ao final de cada colunaA
-# &age ,ooter$ esta seo aparece ao final de cada pginaA
.# /ast &age ,ooter$ esta seo aparece ao final da Iltima pginaA
0# Suar18 esta seo aparece ao trmino do relatrio, logo aps o Iltimo registro.
Quem 4 usou o 1r2stal Reports ou outro gerador grfico vai comear a entender
s de olar... !ara comear, especificamos uma consulta ,Q% apropriada para o relatrio,
utili+ando o menu J/ata & Report Quer2L. -nclua o te'to Jselect idpais,pais from cmRpaisL,
conforme figura abai'o8

*gora cli3ue em JOBL, para voltar S 4anela principal. %, d> um duplo cli3ue na
entrada J0ieldsL da 4anela J%ibrar2L no canto inferior direito da 4anela. /evem aparecer os
campos -/!*-, e !*-,, como abai'o8
3
*rraste&os para a seo JdetailL do la2out e acione o menu J:uild&)'ecute 6Eit
active connection7L 6ou use a Iltima setina do primeiro toolbar7.
,alve o relatrio em alguma pasta apropriada, aguarde alguns segundos e...
prontoT *" est o Jasper em aoT
4
5ote os componentes do toolbar. Querendo adicionar um te'to de t"tulo, por
e'emplo, use o boto . *4uste as dimenses das sees do relatrio conforme
dese4ado, inclua t"tulos, data, nImero de pgina, etc. )nfim, e'plore o ambiente, pois ele
tem muito a oferecer. *o final poder"amos ter um la2out como abai'o8
O 3ue geraria um relatrio como o seguinte8
)sta a parte inicial de nossa
e'peri>ncia com o iReport 6instalao, criao
de cone'o e primeiros passos7. $aiores
detales, JperfumariasL e cong>neres sero
discutidos e aprendidos em con4unto...
5