Relatórios

Criando o relatório

906 views 15/01/2018 07/03/2019 gian-pasqualini 0

O relatório será criado utilizando a ferramenta Jasper Studio. Ela é uma IDE baseada no Eclipse, criada para auxiliar na construção de relatórios com Jasper Reports.

No Jasper Studio criaremos um Data Adapter e o relatório em si.

Criando um Data Adapter

O Data Adapter configura uma fonte de dados (datasource), na qual é definida a base de dados de referência utilizada para criar o relatório.

  1. Na view Repository Explorer, clique como botão 2 (ou botão direito) do mouse em Data Adapters. No menu de contexto escolha Create Data Adapter:
  2. Selecione o tipo de Data Adapter, neste caso uma conexão JDBC:
  3. Informe os dados de conexão:
  4. Informe um nome para a conexão:

 

Criando o relatório

  1. Para a iniciar a criação do relatório clique em File > New > Jasper Reports:
  2. Escolha o modelo (template) para o relatório:
  3. Defina o nome do relatório:
  4. Selecione o Data Adapter recém criado;
  5. Defina a query:
    Obs: neste momento insira a consulta SQL sem filtro (query), isso facilitará a utilização do Wizard
  6. Escolha quais campos (fields) farão parte do relatório, eles serão posteriormente adicionados ao relatório.

Clicando em Next ainda é possível definir agrupadores, não veremos agrupamento neste tutorial, então apenas clique em Finish.

Com estas etapas concluídas, está criada a estrutura básica para o relatório.

Desenvolvendo o corpo do relatório:

Para o desenvolvimento do relatório utilizaremos principalmente as 3 views destacadas na imagem abaixo

  • Editor
  • Outline
  • Properties

Através delas é possível manipular o relatório, inserindo os campos e demais componentes nas bandas.

  1. Arraste os campos para a banda Detail, isso irá criar as colunas no relatório;
  2. Os títulos das colunas serão criados automaticamente na banda Column Header, os quais podem ser alterados através da propriedade Display. Da mesma forma é possível arrastar os componentes da paleta para o relatório, adicionando textos, imagens, etc.
  3. Selecionar um componente do relatório na view Editor e então veja que suas propriedades serão apresentadas e poderão ser alteradas na view Properties.

Criando os parâmetros para o relatório

  1. Clique com o botão 2 (direito) do mouse no item parameters da view Outline e então crie dois parâmetros no relatório:
  2. Defina os dois parâmetros criados com os nomes: data_inicial e data_final;
  3. Defina o campo Class como: java.sql.Timestamp:

    Observações: A propriedade Is for prompting do parâmetro indica a obrigatoriedade do parâmetro para a Senior X, ou seja, se estiver marcada, será obrigatório o preenchimento do parâmetro na execução do relatório pela Senior X. Caso a propriedade estiver desmarcada, o parâmetro será exibido na tela de entrada do relatório, porém, o preenchimento será opcional. Na execução pelo Jasper Studio, a propriedade indica apenas se o parâmetro deve ser exibido na tela de entrada, não há um controle para obrigatoriedade de campos.
  4. Clique com o botão 2 (direito) do mouse no nome do relatório (item root) e então selecione o item de menu “Dataset And Query“;
  5. Adicione a cláusula where no sql:
    select titulo, descricao, data from reference.view_tarefa
    <strong>where data between $P{data_inicial} and $P{data_final}</strong>

Caso queira, é possível adicionar imagens ao relatório. basta copiá-las para a mesma pasta onde se encontra o arquivo de relatório (.jrxml) e ao adicionar o componente de imagem ao relatório escolher a opção “Workspace resource (an element inside the workspace)”, apontando para o arquivo adicionado.

Executar o relatório em modo teste.

Para executar o relatório em modo teste basta clicar na guia preview do editor, informar os parâmetros de entrada e clicar em play:

O relatório será executado com os parâmetros informados.

Próxima etapa: Implantando o relatório.

Este artigo foi útil para você?