Antes de continuar nas configurações do iReport, você vai se ambientar na ferra- menta, criando um primeiro relatório. Isso possibilitará uma melhor compreensão da geração de relatórios JasperReports.
Para a geração deste relatório, você vai utilizar o assistente de relatórios existen- te na ferramenta. Isso facilitará na velocidade do desenvolvimento.
O
BANCO DE DADOSUSADOO MySQL 5 será o gerenciador de banco de dados usado neste livro para a exe- cução dos exemplos de relatórios. Apesar de ser o MySQL, os exemplos mostrados poderão ser feitos em Oracle, SQL Server, PostgreSQL e etc.
O banco de dados chamado de relatorios será usado em todos os capítulos ao lon- go do livro, sendo as tabelas que o compõe são apresentadas na Figura 2.2 a seguir.
Figura 2.2 – Diagramação do banco de dados usado no livro
Observação: As tabelas foram baseadas no banco de dados de exemplo Nor-
thwind, encontrado no MS Office Access ® e no banco de dados MS SQL Server ®, ambos da Microsoft (MS).
Atenção: O arquivo relatorios.sql contendo o banco de dados relatorios e suas ta- belas devidamente populadas se encontra no site do autor, citado no início deste
livro, em “Códigos dos exemplos criados no livro”.
O
PRIMEIRO RELATÓRIO NOIR
EPORT PARAN
ETB
EANSNA VERSÃOS
TANDALONEO banco de dados a ser criado é composto por cinco entidades, sendo quatro delas principais para o cenário proposto. Para o exemplo, você vai criar o primeiro relatório usando apenas a tabela de produtos.
Vá ao menu File do iReport para NetBeans e selecione no menu o item Report
Wizard.
Figura 2.3 – Selecionando o item de menu Report Wizard
Ao surgir à caixa de diálogo do assistente, chamada de New Report, você deverá seguir os seguintes passos para criar seu relatório:
1. Para a primeira etapa, coloque o nome do seu relatório em Report name.
Chame de PrimeiroRelatorio se quiser ter um nome similar ao do livro. No botão Browse você pode alterar a localização de onde será salvo o relatório. Clique no botão Next para prosseguir.
2. A segunda etapa necessita da criação de uma conexão com o banco de dados.
Como ainda não fora feito nenhuma, clique no botão New, ao lado do campo Con-
nections/Data Sources.
a. Na caixa de diálogo de Datasource selecione o item Database JDBC connec- tion. Clique no botão Next para prosseguir.
b. Como o driver JDBC usado é do MySQL, por padrão, a segunda etapa das pro-
priedades de conexão surgirá com esta opção selecionada no campo JDBC Driver, contendo com.mysql.jdbc.Driver. Não há necessidade, neste caso, de se adicionar a biblioteca JDBC na sua aplicação.
c. No campo Name digite relatorios. No campo JDBC URL complete deixando jdbc:mysql://localhost/relatorios. Coloque o nome de usuário no campo User Name
e sua respectiva senha em Password. Marque a opção Save password.
Figura 2.4 – Definindo as propriedades de conexão
d. Clique no botão Test para verificar se a conexão foi estabelecida com sucesso.
Caso apareça a mensagem “Connection test successful!”, significa que você configu- rou tudo corretamente e que agora há uma comunicação com o banco de dados.
e. Salve as informações de conexão com o banco de dados através do botão Save
da caixa de diálogo.
Onde o iReport armazena minha conexão?
O iReport guarda as informações da configuração da conexão no diretório .ireport/
dev/config/Preferences/com/jaspersoft, dentro do arquivo ireport.properties.
Neste arquivo há a propriedade connection seguida por um “ponto” e um núme- ro, que indica a conexão, onde a primeira é zero, a segunda é um e assim por dian- te. A string que existe como valor possui um XML, contendo uma compatibilidade com a versão do iReport que não está sobre a plataforma NetBeans.
f. Retornando ao assistente de relatório, na segunda etapa, concluída a conexão,
você só precisa definir a tabela e dados que serão exibidos. No campo Query (SQL) digite a instrução SQL, a seguir, que selecionará somente a tabela de produtos e, em seguida, clique no botão Next para prosseguir:
SELECT * FROM produtos
Figura 2.5 – Criando a consulta SQL na segunda etapa do assistente
3. Na terceira etapa do assistente, em Fields, adicione todos os campos exceto CategoriaID (utilizando o botão “>”) e clique no botão Next.
Figura 2.6 – Seleção de campos para a geração do relatório
4. Na quarta etapa simplesmente avance clicando no botão Next.
5. Na quinta etapa, você vai selecionar o layout que deseja utilizar em seu rela-
tório. Mantenha na opção Columnar layout e clique no botão Next.
6. Na última etapa, clique simplesmente no botão Finish para concluir o assistente.
Ao final você terá um relatório gerado com os campos selecionados em formato tabular, contendo sua visualização apenas estrutural.
Figura 2.7 - Estrutura do relatório gerado pelo assistente
Observação: O driver JDBC do MySQL já vem com o iReport, no diretório ide8/ modules/ext de sua instalação. Caso você deseje utilizar outro banco de dados ou
atualizar a versão JDBC da biblioteca do MySQL, que se encontra na versão mysql-
connector-java-5.0.7-bin.jar, adicione neste diretório.
V
ISUALIZANDOO PRIMEIRO RELATÓRIOAntes de iniciar qualquer alteração, você vai visualizar o relatório da forma bruta como foi criado.
Clique em Preview (ou pelo menu View>Editors>Preview) e aguarde a rende- rização do relatório.
O visualizador de relatórios para o formato JasperReports está embutido no iReport para NetBeans, diferente do que acontecia em versões que não utilizam a plataforma NetBeans.