Upload
anderson-marques-neto
View
252
Download
0
Embed Size (px)
Citation preview
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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/6/2019 TI - APOSTILA - Manual Utilizao IReport
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
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
11/19
Figura 18- Blank when null ativado
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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
8/6/2019 TI - APOSTILA - Manual Utilizao IReport
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.