Manual Utilizao IReport

Criando novo relatrioNeste manual sero ensinados os passos para criao de um relatrio simples, para exemplificar o manual ser criado um relatrio de funcionrios do sistema, para criar um novo relatrio deve-se acessar o menu Arquivo na tela principal do IReport onde temos duas opes Novo Relatrio vazio ou Assistente de relatrio, como mostra a figura 1.

Figura 1 Criando novo relatrio.

Em Novo relatrio vazio um relatrio vazio ser criado porem nosso foco ser ao menu Assistente relatrio atravs do qual em poucos passos podese criar relatrios de nvel intermedirio.

Na tela inicial do assistente, deve-se informar o nome do relatrio e localizao ilustra a figura 2.

Figura 2 Assistente relatrio

Aps informar o nome do relatrio e definir sua localizao v para prxima tela atravs do boto Prximo que a tela de configurao de conexes onde se pode criar uma nova conexo ou selecionar uma existente.

Figura 3 Tela Conexes

Parar Criar conexes ver apndice I, aps criar ou selecionar a conexo a tela ser alterada e voc poder criar uma consulta ao banco de dados a qual ser usada no relatrio, a tela de criao de consultas pode ser vista na figura 4

Figura 4 Tela Criao Consultas Nesta tela existem as opes de digitar uma consulta, carregar uma existente, salvar consultas criadas ou usar o assistente de criao de consultas. Neste manual ser utilizada uma consulta que busca todos os funcionrios do sistema. Digite a seguinte consulta: select f.func_codg, f.func_usuario, f.func_nome, f.func_cidade, f.func_uf from funcionarios f f.emp_codg,

Aps inserir a consulta v a prxima tela que a Tela de seleo de campos da consulta nesta tela selecione os campos que sero usados no relatrio, os enviando para o lado direito atravs das setas de navegao, para este exemplo selecione todos os campos da consulta como mostra a figura 5.

Figura 5 seleo campos

A prxima tela onde se pode criar agrupamentos para o relatrio. A criao de grupos no obrigatria mais pode ser til para melhor organizao das informaes do relatrio. Para este exemplo os funcionrios sero de acordo com as empresas as quais pertencem. Para isso selecione o campo EMP_CODG que representa o cdigo da empresa, no Grupo 1 como pode ser visto na figura 6.

Figura 6 Agrupamentos do relatrio Na prxima tela escolha a disposio dos dados no relatrio que podem ser de em forma de colunas ou tabelas ficando a cargo do criador decidir qual deles e o melhor em seu caso. Neste exemplo usaremos o layout de Tabelas.

Figura 7 Escolha layout.

Depois de selecionar um layout a prxima tela exibira a mensagem de finalizao do relatrio, para gerar o relatrio pressione finalizar. Se tudo

correu bem a tela central do IReport dever exibir um relatrio semelhante a imagem 8.

Figura 8 Relatrio em modo de designer Para visualizar uma previa do relatrio, basta alterar o IReport para modo Preview, clicando no boto preview como destacado na figura 8, Uma previa com todos os funcionrios cadastrados no banco de dados ser mostrada.

Figura 9 Relatrio Funcionrios em modo Preview Como pode-se observar o agrupamento se repete varias vezes no relatrio, isto acontece devido ao fato do mesmo ser montado na ordem que os dados so recebidos do banco de dados. Para organizar melhor o relatrio vamos editar nossa consulta e orden-la. Para isso deve-se voltar ao modo Designer e clicar no Designer Query que se localiza no topo da aba Designer como visto na figura 10.

Figura 10 Atalho para o Report Query Na tela do Report Query adicione ao final do comando SQL a seguinte instruo order by f.emp_codg Ela ordenara os resultados da consulta com base no cdigo da empresa.

Figura 11 Report Query

Aps alterar a consulta pressione OK para a mesma ser salva. Visualize o preview do relatrio para ver o efeito desta alterao.

Figura 13- Relatrio Ordenado O relatrio deve estar semelhante a figura 13, para deixar o relatrio mais legvel deve-se alterar os textos do mesmo e efetuar pequenas modificaes. Para alterar o titulo ou qualquer outro texto esttico basta estar em modo Designer e dar um duplo clique no mesmo, assim ele entrara em modo de edio permitindo que o texto do mesmo seja alterado como mostra a figura 14.

Figura 14 Texto esttico em edio

Altere o contedo do texto para Relatrio Funcionrios, tambm possvel editar a fonte, tamanho, posicionamento e demais configuraes do texto, semelhante ao Microsoft Office Word atravs da barra acima do relatrio como destacado na figura 15.

Figura 15 Editor Configuraes de texto.

Efetue a mesma operao com as outros textos estticos do relatrio, comeando pelo cabealho das colunas, (a faixa cinza com letras brancas) alterando o titulo dos mesmo de func_codg, para Cdigo Funcionrio, func_usuario para Usurio, func_nome para Nome Funcionrio, func_cidade para Cidade e func_uf para Estado, e alinhe os mesmo ao centro da caixa de texto. Altere agora o grupo cdigo empresa, alterando EMP_CODG para Cdigo Empresa: , j se pode visualizar o resultado das alteraes alterando o IReport para modo Preview o resultado deve ser semelhante ao apresentado na figura 16.

Figura 16 Relatrio Formatado

Pode-se visualizar que em alguns campos que no possuem dados inseridos o relatrio exibe null no mesmo. Em alguns casos isto til para tratar informaes mais neste caso no, por isso trate os campos para que exibam texto em branco caso no exista dados a serem exibidos. Para isso volte ao modo designer e edite as caixas de texto, que se encontram abaixo do cabealho Cdigo Empresa, para efetuar a mudana basta selecion-la e marcar a propriedade Blank when null da caixa de propriedades do IReport como mostra a figura 17, efetue esta operao em todas as caixas de texto desta linha.

Figura 17 Customizando caixas de texto Quando se seleciona um caixa de texto as mesmas opes de customizao de texto do texto esttico esto disponveis para melhorar o relatrio. A figura 18 mostra o relatrio com a opo blank when null selecionada, pode-se ver a diferena comparando a com a figura 16.

Figura 18- Blank when null ativado

Apndice I Manual de Conexo Com o banco de dados. Para criar um relatrio deve-se ter uma conexo configurada no IReport, para isso pode-se criar uma atravs do assistente de conexes do IReport acessando o cone na barra principal ou pelo menu Ferramentas Conexes do Relatrio.

Figura 1 Atalho assistente configurao Ambas as opes iram abrir uma janela onde se pode administrar as conexes do IReport como mostra a Figura 2.

Figura 2 Gerenciador Conexes

Neste gerenciador existe a possibilidade de criar, alterar, deletar, definir como padro, importar e exportar as conexes. Ao criar uma nova conexo um assistente ser iniciado na primeira tela iremos selecionar o tipo da conexo selecione Database JDBC connection como mostra a Figura 3.

Figura 3 tipo Conexo Na prxima tela digite um nome para identificar sua conexo no meu caso escolhi SUPORTE, em JDBC Driver selecione o driver Oracle e pule para a parte do endereo do servidor, nome do banco usurio e senha, aps informar estes campos (caso no saiba consulta o DBA de sua empresa) clique no boto Assistente como destaca a figura 4.

Figura 4 Dados da conexo. Depois deste passo o campo JDBC URL deve ser atualizado com as informaes digitadas, depois disto Pressione o boto Test no assistente, digite a senha, se nenhuma mensagem de erro for exibida pode salvar sua conexo caso contrario verifique os dados informados. Assim que for salva a mesma ser adicionada ao gerenciador de conexo e poderemos utiliz-la na criao de relatrios.

Utilizando o Query Designer.

A tela inicial do Query Designer no parece muito amigvel primeira vista, mais nela bem pequena e simples, a primeira coisa a se fazer selecionar o usurio que tem acesso as tabelas como mostra a Figura 1.

Figura 1 Tela inicial Query Builder

No meu caso o usurio com acesso geral o TESTE, aps selecion-lo as tabelas disponveis sero mostradas abaixo, para usarmos uma tabela podemos arrast-las ate a rea preta ou dar um duplo clique na mesma.

Figura 2 Adicionando Tabelas

Na Figura 2 temos o exemplo de duas tabelas selecionadas, as quais possuem um relacionamento entre elas que automaticamente detectado, assim que adicionamos tabelas a clausura from e atualizada, para adicionarmos campos a consulta basta selecionarmos os desejados nas tabelas e o clausura select ser automaticamente atualizada como vemos na figura 3.

Figura 3 Selecionando Campos. A clausura where um pouco mais complicada para cri-la devemos clicar com o boto direito na mesma, e em add condition.

Figura 4 - Adicionando Condies

A condio deve ser do tipo AND e ou OR ou na primeiro campo digitamos a condio numero 1 e depois o tipo da mesma que pode ser =, maior, menor, diferente e etc. Depois informamos no segundo campo a segunda condio, as condies devem ser no formato NOME_DA_TABELA.NOME_DO_CAMPO . Para facilitar o trabalho podemos clicar com o boto direito na tabela e selecionar add where condition... o qual abrira um tela de insero de condio com a primeira condio j adicionada. Para adicionarmos clausuras group by e order by, basta selecionarmos as mesmas na clausura select e selecionar uma das duas opes add to group-by ou add to order-by. Com isso j podemos criar consultas simples com muita rapidez e utiliz-las em nossos relatrios.