Nesta etapa são apresentados os tipos de fontes de dados que podemos utilizar no processo de desenvolvimento de relatórios no iReport. A figura 29 ilustra as fontes de dados que podem ser utilizadas. Em nosso exemplo, utilizaremos uma fonte de dados JDBC.
Figura 29 – Interface de criação de fonte de dados para geração de relatórios.
Selecione o tipo de fonte de dados “Database JDBC connection” e clique no botão next para ter acesso à tela de configuração de uma nova fonte de dados JDBC, conforme ilustrado na figura 30.
Os passos para gerar um relatório são bem simples. O primeiro passo é compilar o relatório em XML. Depois da compilação, o resultado é um objeto do tipo JasperReport. O próximo passo é preencher o relatório com os dados, e o resultado dessa etapa fica armazenado em um objeto do tipo JasperPrint. Esse objeto já representa o relatório finalizado, a partir dele podemos enviar para impressão diretamente, ou podemos exportar para um outro formato, como PDF por exemplo. O diagrama apresentado na figura 28 ilustra o processo completo.
Figura 28 – Passos para geração de relatórios.
Desta forma, os desenvolvedores do iReport pensaram em três etapas que se fazem necessárias para a criação de relatórios, que são:
1ª etapa: Criação da conexão com o banco de dados ou com a fonte de dados a ser utilizada na geração do relatório
2ª etapa: Criação do novo relatório, por meio da escolha de layout pré-definidos ou pela criação de novos layouts. Nesta etapa é que se trabalha a disposição dos conteúdos selecionados da fonte de dados informada na etapa 1.
3ª etapa: Visualização do relatório em desenvolvimento para verificar se as informações e sua disposição estão de acordo com o projetado para o relatório e desenvolvimento.
Por fim, após a executação das três etapas descritas anteriormente, o programadador terá um arquivo que contém as informações necessárias para que a aplicação em desenvolvimento possa gerar relatórios de forma bem estruturada.
9.2 Exemplo de utilização das etapas para criação de relatórios
9.2.1 1ª Etapa – Criação da conexão
Nesta etapa são apresentados os tipos de fontes de dados que podemos utilizar no processo de desenvolvimento de relatórios no iReport. A figura 29 ilustra as fontes de dados que podem ser utilizadas. Em nosso exemplo, utilizaremos uma fonte de dados JDBC.
Figura 29 – Interface de criação de fonte de dados para geração de relatórios.
Selecione o tipo de fonte de dados “Database JDBC connection” e clique no botão next para ter acesso à tela de configuração de uma nova fonte de dados JDBC, conforme ilustrado na figura 30.
Figura 30 – Interface de configuração de fonte de dados JDBC.
Nesta tela deverá ser informado o nome para esta nova fonte de dados, nome este que será utilizado pela biblioteca JasperReports para encontrar a fonte de dados para a geração do relatório, bem como as informações sobre o Driver JDBC, a URL com a localização da fonte de dados, e usuário e senha para autenticação da conexão com a fonte de dados informada.
Utilize o botão “TEST” para testar se a conexão será realizada com sucesso e, se estiver tudo certo, clique no botão “SAVE” para salvar esta nova fonte de dados que será utilizada na geração de relatórios na interface do iReport.
9.2.2 2ª Etapa – Criação da conexão
Nesta etapa são serão solicitadas as informações para a contrução do relatório em desenvolvimento, tais como nome do relatório, qual a fonte de dados, qual a consulta SQL que será utilizada para a geração de relatórios que utilizam fonte de dados JDBC, dentre outras. A figura 31 ilusta a interface inicial da 2ª etapa do processo de criação de relatórios na interface iReport.
Figura 31 – Interface de configuração do layout do relatório.
O primeiro passo é a escolha do layout para a geração do relatório. O iReport sugere alguns layouts que podemos utilizar para no processo de criação de relatório, ou se preferir o desenvolvedor pode optar por uma folha em banco que possibilita a criação do relatório sem a especificação de um layout inicial. Este é uma opção que dará mais trabalho na criação do relatório.
No nosso exemplo iremos utilizar o layout “Leaf Gray”. Selecione este layout e clique no botão “Launch Report Wizard” para dar inícia às configurações necessárias à geração do relatório.
O segundo passo é a solicitação do nome e localização do arquivo fonte de geração do layout do relatório em desenvolvimento. Este arquivo tem a extensão .jrxml e é o arquivo que contem as informações necessárias para a biblioteca JasperReports consigua compilar o arquivo com o resultado do processo de desenvolvimento do relatório que será utilizado na aplicação java em desenvolvimento. A figura 32 ilusta o segundo passo.
Figura 30 – Interface de configuração de fonte de dados JDBC.
Nesta tela deverá ser informado o nome para esta nova fonte de dados, nome este que será utilizado pela biblioteca JasperReports para encontrar a fonte de dados para a geração do relatório, bem como as informações sobre o Driver JDBC, a URL com a localização da fonte de dados, e usuário e senha para autenticação da conexão com a fonte de dados informada.
Utilize o botão “TEST” para testar se a conexão será realizada com sucesso e, se estiver tudo certo, clique no botão “SAVE” para salvar esta nova fonte de dados que será utilizada na geração de relatórios na interface do iReport.
9.2.2 2ª Etapa – Criação da conexão
Nesta etapa são serão solicitadas as informações para a contrução do relatório em desenvolvimento, tais como nome do relatório, qual a fonte de dados, qual a consulta SQL que será utilizada para a geração de relatórios que utilizam fonte de dados JDBC, dentre outras. A figura 31 ilusta a interface inicial da 2ª etapa do processo de criação de relatórios na interface iReport.
Figura 31 – Interface de configuração do layout do relatório.
O primeiro passo é a escolha do layout para a geração do relatório. O iReport sugere alguns layouts que podemos utilizar para no processo de criação de relatório, ou se preferir o desenvolvedor pode optar por uma folha em banco que possibilita a criação do relatório sem a especificação de um layout inicial. Este é uma opção que dará mais trabalho na criação do relatório.
No nosso exemplo iremos utilizar o layout “Leaf Gray”. Selecione este layout e clique no botão “Launch Report Wizard” para dar inícia às configurações necessárias à geração do relatório.
O segundo passo é a solicitação do nome e localização do arquivo fonte de geração do layout do relatório em desenvolvimento. Este arquivo tem a extensão .jrxml e é o arquivo que contem as informações necessárias para a biblioteca JasperReports consigua compilar o arquivo com o resultado do processo de desenvolvimento do relatório que será utilizado na aplicação java em desenvolvimento. A figura 32 ilusta o segundo passo.
Figura 32 – Interface para informar o nome e localização do relatório.
O terceiro passo é onde se informa a fonte de dados para geração do relatório, bem como a consulta que será executada na fonte de dados. Inicialmente deverá ser selecionada a fonte de dados criada na primeira etapa e em seguida deverá ser escrita a consulta SQL que irá fornecer os dados para a geração do relatório, conforme ilustrado na figura 33.
Figura 33 – Especificação dos dados para geração do relatório.
No quarto passo será necessário informar os campos de dados que serão visualizados no relatório em desenvolvimento. Neste ponto o iReport irá disponibilizar para seleção apenas os campos informados com resultado da consulta SQL informada.
Selecione a ordem de inclusão dos campos, sendo a orientação da esquerda para a direita. A figura 34 ilusta a sequencia de campos selecionados para a geração das linhas de dados do relatório.
Figura 34 – Campos de dados do relatório.
O passo cinco é onde podemos informar os agrupadores de informações do relatório, conforme ilustrado na figura 35.
Figura 32 – Interface para informar o nome e localização do relatório.
O terceiro passo é onde se informa a fonte de dados para geração do relatório, bem como a consulta que será executada na fonte de dados. Inicialmente deverá ser selecionada a fonte de dados criada na primeira etapa e em seguida deverá ser escrita a consulta SQL que irá fornecer os dados para a geração do relatório, conforme ilustrado na figura 33.
Figura 33 – Especificação dos dados para geração do relatório.
No quarto passo será necessário informar os campos de dados que serão visualizados no relatório em desenvolvimento. Neste ponto o iReport irá disponibilizar para seleção apenas os campos informados com resultado da consulta SQL informada.
Selecione a ordem de inclusão dos campos, sendo a orientação da esquerda para a direita. A figura 34 ilusta a sequencia de campos selecionados para a geração das linhas de dados do relatório.
Figura 34 – Campos de dados do relatório.
O passo cinco é onde podemos informar os agrupadores de informações do relatório, conforme ilustrado na figura 35.
Figura 35 – Agrupadores de dados do relatório.
O sexto é último passo informa que você informou os dados de maneira correta para a geração de um novo relatório na interface do iReport. Clique no botão “Finalizar” para que você possa visualizar o layout do relatório desenvolvido.
Como resultado você irá visualizar a área de edição do layout do relatório criado para que você possa fazer as alterações necessárias para finalizar o relatório a ser disponibilizado na aplicação Java em desenvolvimento.
O relatório que foi gerado apresenta um conjunto de camadas de informações que são conhecidas como seções, quais sejam:
1. Title: como o nome o indica, esta seção contém o título do relatório. Esta
informação só aparece na primeira página do relatório;
2. Page Header: esta seção aparece no topo de cada página. Geralmente utilizada
para colocar datas, numeração de páginas, etc.;
3. Column Header: esta seção aparece no topo de cada coluna de dado de se
pretende imprimir no relatório;
4. Detail: nesta área serão colocadas as informações para cada item de registro. O
JasperReports gera uma seção de detalhe para cada registro retornado pela consulta realizada na fonte de dados do relatório;
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.
A figura 36 ilustra o layout sugerido para a criação do relatório onde você poderá realizar alterações no título e rótulo das colunas de dados do relatório em construção.
Figura 36 – Layout criado pelo wizard do iReport.
Já a figura 37 apresenta o relatório após as alterações dos dados que serão visualizados no relatório quando este estiver disponível dentro de uma aplicação Java.
Figura 35 – Agrupadores de dados do relatório.
O sexto é último passo informa que você informou os dados de maneira correta para a geração de um novo relatório na interface do iReport. Clique no botão “Finalizar” para que você possa visualizar o layout do relatório desenvolvido.
Como resultado você irá visualizar a área de edição do layout do relatório criado para que você possa fazer as alterações necessárias para finalizar o relatório a ser disponibilizado na aplicação Java em desenvolvimento.
O relatório que foi gerado apresenta um conjunto de camadas de informações que são conhecidas como seções, quais sejam:
1. Title: como o nome o indica, esta seção contém o título do relatório. Esta
informação só aparece na primeira página do relatório;
2. Page Header: esta seção aparece no topo de cada página. Geralmente utilizada
para colocar datas, numeração de páginas, etc.;
3. Column Header: esta seção aparece no topo de cada coluna de dado de se
pretende imprimir no relatório;
4. Detail: nesta área serão colocadas as informações para cada item de registro. O
JasperReports gera uma seção de detalhe para cada registro retornado pela consulta realizada na fonte de dados do relatório;
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.
A figura 36 ilustra o layout sugerido para a criação do relatório onde você poderá realizar alterações no título e rótulo das colunas de dados do relatório em construção.
Figura 36 – Layout criado pelo wizard do iReport.
Já a figura 37 apresenta o relatório após as alterações dos dados que serão visualizados no relatório quando este estiver disponível dentro de uma aplicação Java.
9.2.3 3ª Etapa – Visualização do relatório
Após, ou mesmo durante, a reconfiguração dos dados a serem visualizados no relatório, o iReport possibilita da visualização para que possamos ter uma ideia de como os dados serão visualizados após a inclusão deste relatório dentro da aplicação Java em desenvolvimento. A figura 38 ilustra o processo de visualização interna, disponibilizada pelo clique no botão “Preview”.
Figura 38 – Layout reconfigurado pelo programador.
Por default, o iReport disponibiliza a visualização interna. Você pode configurar a visualização para PDF, por exemplo, clicando na opção de menu Perview do iReport e selecionando a opção PDF Preview.
Outra possibilidade é a visualização do código XML sendo gerado e que será utilizado pela biblioteca JasperReports para a geração do relatório dentro da aplicação Java. O código XML ilustrado na figura 39 é parte do código a ser utilizado para a geração do arquivo . jasper, que será importado dentro da aplicação Java.
Figura 39 – Código XML iReport-JasperReports.