TI - APOSTILA - Manual Utilização IReport

8/6/2019 TI - APOSTILA - Manual Utilizao IReport

1/19

Manual Utilizao IReport

Criando novo relatrio

Neste 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 pode-

se criar relatrios de nvel intermedirio.


2/19

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 conexesonde se pode criar uma nova conexo ou selecionar uma existente.

Figura 3 Tela Conexes


3/19

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 deconsultas. 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.emp_codg,

f.func_cidade, f.func_uf from funcionarios f

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 esteexemplo selecione todos os campos da consulta como mostra a figura 5.


4/19

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 funcionriossero 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.


5/19

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


6/19

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.


7/19

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


8/19

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 maislegvel 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


9/19

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, alterandoEMP_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


10/19

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 aomodo 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.


11/19

Figura 18- Blank when null ativado


12/19

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.


13/19

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.


14/19

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.


15/19

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.


16/19

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.


17/19

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.


18/19

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


19/19

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... oqual 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.

Documents

TI - APOSTILA - Manual Utilização IReport