Sei sulla pagina 1di 14

1

Comear j metade de toda a ao.


PROVRBIO GREGO

Conhecendo o iReport

OPEN SOURCE, capaz de criar visualmente os mais complexos relatrios para aplicaes Java no formato da biblioteca JasperReports. Como escrito em 100% Java, signica que tambm multiplataforma. Alm disso, seus cdigos fontes so distribudos gratuitamente de acordo com a GNU (General Public License). Atravs de uma interface grca intuitiva, o desenvolvedor capaz de criar qualquer tipo de relatrio de forma simples e rpida. Mesmo sabendo que o iReport desenvolve um formato XML usado pelo JasperReports, o que no difcil de manipular, h uma vantagem em usar esta ferramenta. Se o desenvolvedor um usurio iniciante no formato XML do JasperReports, o iReport supre suas necessidades evitando que seja necessrio fazer modicaes no cdigo fonte. Caso seja experiente neste formato, o iReport minimiza o tempo na criao dos mais complexos relatrios. Neste captulo voc aprender onde obter, os requerimentos necessrios para executar, como instalar, compilar e entender sobre algumas das mais importantes caractersticas do iReport.

IREPORT UM PROGRAMA

Antes de Utilizar o iReport


O iReport, por ser uma ferramenta Java, precisa do Sun Java 2 SDK 1.4 instalado em sua mquina, ou superior. Perceba que no apenas a JVM

D OMINANDO R ELATRIOS J ASPER R EPORTS

COM I R EPORT

(Java Virtual Machine) que deve estar instalada. Isso porque, para compilar os arquivos jasper, necessria a instalao da distribuio do Java SE, sendo impossvel somente com a JRE (Java Runtime Environment). Caso queira compilar o iReport, atravs de seus arquivos fontes, ser necessria a instalao do Jakarta Ant na verso 1.6 ou superior.

Obtendo e Instalando o Java SE


Atualmente, o JDK (Java SE Development Kit) est em sua verso 6 e possui suporte para as seguintes plataformas: Microsoft Windows; Linux; Sun Solaris; Mac Os; entre outros. A pgina Web ocial sobre a linguagem Java da Sun se encontra no endereo http://java.sun.com. A Sun publica periodicamente releases do JDK e costuma numer-los atravs do que chamam atualmente de updates. Para obter o Kit de Desenvolvimento Java, que at o momento em que este livro escrito est na verso 6 update 2 (JDK 6u2), conhecido como Java SE 6.0, acesse o endereo: http://java.sun.com/javase/downloads/ index.jsp. Na pgina de download do Java SE 6.0, existem vrios produtos para download. Logo a seguir h uma descrio de alguns dos produtos do qual voc encontra para download: JDK 6 Update 2 Este o kit de desenvolvimento Java. Este kit consiste em um compilador (javac), uma ferramenta de execuo (java), uma ferramenta para gerao de documentao (javadoc), um conjunto de bibliotecas prontas para o uso e etc. Java Runtime Environment (JRE) 6 Update 2 Este o ambiente runtime do Java, usado apenas para executar os programas feitos em Java. Java SE 6 Documentation A documentao do J2SE. Esta documentao contm as informaes sobre todas as bibliotecas do Java.

CONHECENDO

O I R E P O RT

Clique no boto-link Download. Para efetuar o download do JDK, voc deve aceitar os termos de uso do Java SE, clicando na opo Accept. Aps a pgina recarregar, haver a possibilidade de baixar a verso que voc precisa para a sua plataforma. Observe que na pgina de Downloads existem diversos Java SE. Existe Java SE para a plataforma Windows, Linux, Solaris SPARC, Solaris x86 e Linux AMD64. Efetue o download do Java SE para o seu sistema operacional clicando sobre o link do produto que utilizar para instalao.

A Instalao no Windows
Tendo em vista que o Windows no qual ser descrito est na verso XP ou superior, inicie o assistente com um duplo clique sobre o arquivo executvel, que como tantos outros desta plataforma, basta avanar at concluir. Para congurar qualquer varivel de ambiente em um sistema Windows na verso NT, voc deve entrar no Painel de Controle, Sistema e na guia Avanado clique no boto Variveis de Ambiente. As variveis de ambiente so seqncias de caracteres que contm informaes como unidade, caminho ou nome de arquivo. As variveis de ambiente controlam o comportamento de vrios programas. Como exemplo de variveis de ambiente: PATH, CLASSPATH, USER, TEMP, JAVA_HOME e etc. Estas variveis de ambiente so utilizadas por muitos programas, para denir um espao em memria principal (RAM), onde alguns processamentos sero executados Em Variveis do sistema, clique em Nova. Adicione o nome da varivel como JAVA_HOME e no valor o caminho onde voc instalou o JDK. A varivel JRE_HOME similar a anterior, mudando apenas para o valor onde se encontra a mquina virtual Java. Na varivel PATH, voc tem que adicionar a varivel JAVA_HOME, acrescida do caminho para os binrios. Aps o ltimo valor, coloque um ponto-e-vrgula (;) e adicione %JAVA_HOME%\bin. Ao conrmar as caixas de dilogo, teste se o Java est funcionando na sua mquina em um prompt de comando, como mostrado a seguir:
java -version

D OMINANDO R ELATRIOS J ASPER R EPORTS

COM I R EPORT

Em Windows Verso 9x
Voc deve editar o arquivo autoexec.bat, encontrado em C:\autoexec.bat e adicionar as variveis como o exemplo a seguir:
set JAVA_HOME= C:\jdk1.6.0_02

Onde o local indicado no exemplo, onde voc tem instalado o JDK.

A Instalao no Linux
No momento em que este livro est sendo escrito, a verso baixada para o sistema operacional Linux a jdk-6u2-linux-i586.bin. Entre no terminal do seu Linux, aps baixar o arquivo, e mude para o usurio Root ou administrativo do sistema e altere a permisso do arquivo para executvel, assim voc poder instal-lo:
shell# chmod +x jdk-6u2-linux-i586.bin

Execute o arquivo:
shell# ./ jdk-6u2-linux-i586.bin

Assim como ocorre em sistemas operacionais Windows, voc ter um assistente para instalao, s que com a diferena de no ser grco. Entre no arquivo prole em /etc/prole e adicione as linhas em seu nal:
JAVA_HOME=/ jdk1.6.0_02 JRE_HOME=/ jdk1.6.0_02/jre export JAVA_HOME export PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/lib export MANPATH=$MANPATH:$JAVA_HOME/man

As variveis usadas so explicadas rapidamente a seguir, dando a voc noo do que cada uma faz:

CONHECENDO

O I R E P O RT

JAVA_HOME Diretrio onde a JDK est instalada JRE_HOME Diretrio onde a mquina virtual est instalada PATH Diretrio dos executveis, onde inclui o do Java CLASSPATH Diretrio das libs MANPATH Diretrio do manual, acessvel por man javac. Faa logout no sistema e logon e execute no terminal o seguinte comando:
java -version

Surgindo as informaes mostradas a seguir, a instalao foi feita com sucesso.


java version 1.6.0_02 Java(TM) SE Runtime Environment (build 1.6.0_02-b06)

FIGURA 1.1 Vericando a verso de instalao do Java no Linux

Observao: No CD-ROM anexo ao livro existem os instaladores para as verses Windows e Linux.

Obtendo e Instalando o iReport


Para baixar o iReport, entre no endereo ocial http://jasperforge.org/sf/ projects/ireport ou http://ireport.sourceforge.net/. At o momento em

D OMINANDO R ELATRIOS J ASPER R EPORTS

COM I R EPORT

que este livro escrito a verso atual do iReport est em 2.0.2. Esta verso tem suporte completo ao JasperReports 2.0.2. Clique no link Download para ser redirecionado ao SourceForge. net, onde est alocado para baixar. Se voc estiver usando o sistema operacional Microsoft Windows, baixe a verso iReport-2.0.2-windows-installer.exe, ao qual inclui um instalador, ou o arquivo iReport-2.0.2.zip, sem instalador. Para os demais sistemas operacionais, incluindo Linux, baixe a verso iReport-2.0.2.tar.gz. O cdigo fonte pode ser encontrado baixando-se o arquivo iReport-2.0.2-src.zip.
Ateno: Com algumas mudanas, muitos dos exemplos vistos neste livro podero ser usados em verses anteriores, aps a verso 0.2.0 de iReport.

Observao: Embora estejam sendo citados os locais onde voc poder obter o iReport, no CD-ROM anexo ao livro existem todos estes arquivos.

Algumas Caractersticas do iReport


O iReport possui diversas caractersticas que o tornam uma ferramenta de desenvolvimento de relatrios prossional, no mesmo padro de outros do mesmo tipo consagrados pelo mundo do desenvolvimento. A seguir voc tem algumas de suas principais caractersticas que fazem deste programa visual o Ocial para desenvolvimento de relatrios JasperReports: Suporte a 100% das tags XML do JasperReports; Editor WYSIWYG para criao de relatrios, possuindo ferramentas que incluem desenhos de retngulos, linhas, elipses, caixas de texto, rtulos, grcos, sub-relatrios, cdigos de barras e etc.; Um editor para escrever as expresses incluindo destaques (highlights) nas sintaxes; Suporte para Unicode e lnguas no latinas como: Russo, Chins, Japons, Coreano e etc.;

CONHECENDO

O I R E P O RT

Integrao para compilar e exportar; Suporte para todos os bancos de dados acessveis pela ponte JDBC; Suporte virtual para todos os tipos de DataSources; Assistentes para criar relatrios rapidamente; Suporte para sub-relatrios; Backup para o cdigo fonte; Suporte para modelos de documentos (templates); Suporte para fontes TrueType; Extenso atravs de plug-ins; Suporte integrado para scriptlets; Suporte a grcos; Gerenciamento de bibliotecas de objetos padro tais como numerao de pginas; Arrastar e Soltar (Drag n Drop); Ilimitados Desfazer e Refazer; Biblioteca de estilos e etc.

Instalando o iReport
Como existem mais de uma forma de instalar o iReport, voc ver todas aqui. A primeira forma de instalao que ser mostrada no sistema operacional Windows com o assistente. A segunda forma ser sem o uso de assistente, neste caso tanto no sistema operacional Windows como no Linux ser mostrada.

No Windows com instalador


O assistente para instalar o iReport no Windows similar aos demais utilizados em outros programas neste sistema operacional. D um duplo clique no arquivo iReport-2.0.2-windows-installer.exe para iniciar o processo de instalao pelo assistente. Na primeira etapa voc tem a tela inicial do iReport 2.0.2. Clique no boto Next para prosseguir.

D OMINANDO R ELATRIOS J ASPER R EPORTS

COM I R EPORT

FIGURA 1.2 Primeiro passo: Tela inicial do assistente de instalao do iReport

Na segunda etapa do assistente voc deve aceitar a licena de uso do iReport. Caso voc no conhea a licena GNU (General Public License), recomendo l-la antes de prosseguir. Clique no boto I Agree para continuar.

FIGURA 1.3 Segundo passo: Termo de aceite de licena de uso do programa

CONHECENDO

O I R E P O RT

Na terceira etapa voc dene os componentes que sero instalados. Caso voc queira instalar com os fontes do iReport, deixe marcada a opo Sources. Clique no boto Next para prosseguir.

FIGURA 1.4 Terceiro passo: Componentes selecionados na instalao do iReport

A quarta etapa o local onde ser instalado o iReport. Por padro ele denido dentro do diretrio JasperSoft\iReport-2.0.2 em Arquivos de programas do seu sistema operacional Windows. Caso precise mudar, clique no boto Browse e selecione o novo local em que deseja instalar. Para prosseguir, clique no boto Next.

10

D OMINANDO R ELATRIOS J ASPER R EPORTS

COM I R EPORT

FIGURA 1.5 Quarto passo: Denindo o local de instalao

No quinto passo voc dene o local de acesso no menu Iniciar do Windows. Caso concorde com a atual congurao, basta clicar no boto Install para iniciar o processo de instalao. Caso deseje alterar o acesso, basta digitar no local selecionado, em JasperSoft\Report-2.0.2.

FIGURA 1.6 Quinto passo: Seleo da pasta para acesso no menu Iniciar

CONHECENDO

O I R E P O RT

11

Aps a instalao, a opo Run iReport 2.0.2 estar selecionada. Clicando no boto Finish, abrir imediatamente o iReport para trabalhar. O instalador tambm criar um atalho na rea de trabalho para acesso rpido ao programa, atravs do arquivo iReport.exe.

FIGURA 1.7 Finalizando o assistente aps a instalao

Ateno: O instalador cria, alm do arquivo iReport.exe, um arquivo chamado iReport.bat, que no caso de no ser possvel a inicializao pelo executvel, por qualquer motivo que seja, tente atravs deste, ou diretamente no diretrio bin atravs do arquivo startup.bat.

No Windows e Linux sem instalador


Caso voc prera a verso sem instalador, existem os dois arquivos compactados iReport-2.0.2.zip (recomendvel para o sistema operacional Windows) ou iReport-2.0.2.tar.gz (para o sistema operacional Linux). Descompacte o de sua preferncia em um local desejado. No Linux, voc deve executar antes o comando para descompactao:

12

D OMINANDO R ELATRIOS J ASPER R EPORTS

COM I R EPORT

shell# tar xpvzf iReport-2.0.2.tar.gz

Ao descompactar o iReport, entre no diretrio e execute a permisso de execuo:


shell# cd iReport-2.0.2/ shell# chmod +x iReport.sh

Para o Windows existem os arquivos iReport.exe e iReport.bat para inicializar, bastando um duplo clique. No sistema operacional Linux, basta entrar no terminal e executar o Shell, como mostrado a seguir:
shell# ./iReport.sh

FIGURA 1.8 Permisso e execuo do iReport no Linux

Compilando o iReport com a Ferramenta Ant


A compilao do iReport indicado para usurios avanados. Embora seja algo que exija algumas conguraes de ambiente de compilao, no complexo de se executar. A seguir voc tem os passos para compilar o iReport com a ferramenta Ant, incluindo inclusive sua instalao.

CONHECENDO

O I R E P O RT

13

Instalando e configurando o Ant


Para compilar o iReport, inicialmente voc precisa ter o Ant instalado em sua mquina. Caso queira instal-lo, baixe a ltima verso no endereo http:// ant.apache.org/. A verso no momento em que este livro escrito 1.7.0. No menu lateral do site, clique em Binary Distributions e faa o download do arquivo no formato que voc precisar. Descompacte o arquivo apache-ant-1.7.0-bin.tar.gz ou apache-ant1.7.0-bin.zip e adicione as variveis no seu sistema operacional.

Em Windows
No caso de ter instalado no sistema operacional Windows no drive C, entre no prompt de comando e digite a seqncia a seguir para congurar o ANT:
set ANT_HOME=C:\apache-ant-1.7.0 set PATH=%PATH%;%ANT_HOME%\bin

Ou congure nas Variveis de ambiente como na instalao do JDK.

Em Linux
No sistema operacional Linux, caso o ANT esteja em usr/local digite a seqncia a seguir no terminal:
export ANT_HOME=/usr/local/apache-ant-1.7.0 export PATH=$PATH:$ANT_HOME/bin

Ou congure no arquivo prole como na instalao do JDK.

Compilando o iReport
Para a compilao do iReport, primeiro, descompacte o arquivo iReport2.0.2-src.zip ou entre no diretrio onde h os sources da instalao. Os

14

D OMINANDO R ELATRIOS J ASPER R EPORTS

COM I R EPORT

arquivos fontes possuem um build.xml. Entre no terminal ou prompt de comando e execute a seqncia:
ant iReport

Os sources, que esto no diretrio src, quando compilados caro dentro de classes. Assim que compilar, o iReport iniciado automaticamente.
Ateno: No CD-ROM anexo ao livro existe o ANT para instalao caso voc necessite.