O JasperReports Studio é uma ferramenta de software que oferece um ambiente visual para criar relatórios para a plataforma Java. É open source.

Transcrição

1 Introdução ao JasperReports O JasperReports Studio é uma ferramenta de software que oferece um ambiente visual para criar relatórios para a plataforma Java. É open source. Para efetuar o seu download acesse o link: Essa é a página principal. Acesse o link de download e escolha a versão que melhor se adapte ao seu ambiente de desenvolvimento. Provavelmente, será solicitado um registro para download. Após o download, descompacte o arquivo em um diretório de sua preferência e execute o JasperReports Studio. Este documento apresenta, nos próximos tópicos, uma introdução geral para a criação de relatórios com essa ferramenta. O Ambiente de desenvolvimento do JasperReports Studio (JRS) Após aberto, o JRS apresenta a seguinte tela: Note que é um ambiente semelhante ao do Eclipse. Um Novo Projeto figura. Crie um novo projeto utilizando File / New / Project..., conforme indicado na próxima

2 A janela New Project será apresentada, como se segue Selecione a opção indicada na figura anterior e confirme em Next. Será apresentada a janela New Jasper Project Wizard, como indicado a seguir.

3 Informe o nome do projeto como Estoque, como indicado na figura anterior. Clique na aba Project Explorer para ver a estrutura do projeto criado, como ilustra a próxima figura. Criando uma conexão com banco de dados Acesse a aba Repository Explorer, como indicado a seguir.

4 Vamos utilizar um banco de dados simples, cujo script das estruturas das tabelas e dos seus respectivos dados está indicado a seguir. -- Copiando estrutura para tabela estoquejavafx.grupo CREATE TABLE IF NOT EXISTS `grupo` ( `codgrupo` int(11) NOT NULL AUTO_INCREMENT, `descgrupo` varchar(30) COLLATE latin1_general_ci NOT NULL, PRIMARY KEY (`codgrupo`) ) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=latin1 COLLATE=latin1_general_ci; INSERT INTO `grupo` (`codgrupo`, `descgrupo`) VALUES (1, 'LIMPEZA'), (2, 'ESCRITÓRIO'), (3, 'INFORMÁTICA'), (4, 'PAPEL'); -- Copiando estrutura para tabela estoquejavafx.estoque CREATE TABLE IF NOT EXISTS `estoque` ( `codestoque` int(11) NOT NULL AUTO_INCREMENT, `descestoque` varchar(30) COLLATE latin1_general_ci NOT NULL, `quant` int(11) DEFAULT NULL, `codgrupo` int(11) DEFAULT NULL, PRIMARY KEY (`codestoque`), KEY `codgrupo` (`codgrupo`), CONSTRAINT `estoque_ibfk_1` FOREIGN KEY (`codgrupo`) REFERENCES `grupo` (`codgrupo`) ) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=latin1 COLLATE=latin1_general_ci; INSERT INTO `estoque` (`codestoque`, `descestoque`, `quant`, `codgrupo`) VALUES (1, 'CANETA ESFEROGRÁFICA AZUL', 100, 2), (2, 'BALDE DE PLÁSTICO', 20, 1), (3, 'PENDRIVE DE 8GB', 10, 3), (4, 'BORRACHA BICOLOR', 50, 2), (5, 'MOUSE X', 12, 3);

5 Crie um banco de dados MySQL e execute o script SQL indicado anteriormente, para criar as tabelas e seus respectivos dados. Com o banco de dados criado e com suas tabelas e dados ajustados, acesse o botão indicado na figura seguinte: O referido botão criará uma conexão com o banco de dados desejado através da janela Data Adapter Wizard, mostrada na próxima figura. Selecione Database JDBC Connection e Clique no botão Next.

6 Na janela seguinte, indicada na próxima figura, informe como está indicado para a primeira caixa de texto e, em seguida, informe os dados adequados para o nome do seu banco de dados, usuário e senha. Em seguida, acesse a aba Driver ClassPath na parte inferior da janela. A nova aba será mostrada como se segue.

7 Clique no botão Add e selecione a pasta onde está o arquivo.jar do conector de banco de dados MySQL. A próxima figura ilustra o conector já selecionado na referida aba. Clique no botão Test para verificar se a conexão está correta. Caso esta estiver correta, aparecerá a mensagem de sucesso, como está ilustrado a seguir. Criando o relatório de itens do estoque

8 Para criar um relatório, dê um clique com o botão direito sobre o nome do projeto (Estoque) na aba Project Explorer. Selecione New / Jasper Report, como ilustra a próxima figura. Será apresentada a janela Report Templates. Selecione o template Simple Blue, como mostra a figura seguinte. Na próxima janela, informe o nome do arquivo como Estoque.jrxml, como está ilustrado pela próxima figura. Clique em Next e, na próxima janela, selecione a conexão que foi criada anteriormente, como mostra a próxima figura.

9 Clique em Next. Na próxima janela selecione o banco de dados desejado, como está ilustrado a seguir. Acesse a aba Diagram e arraste as tabelas estoque e grupo para o lado direito da janela, como está ilustrado na próxima figura.

10 Selecione os campos marcados em cada tabela. Se você clicar na aba Texto, esta irá mostrar o script SQL correspondente ao diagrama da figura anterior. A figura seguinte ilustra o script SQL criado com o digrama da figura anterior. Clique em Next. A próxima janela apresenta os campos selecionados no script SQL.

11 Essa janela permite selecionar os campos desejados que aparecerão no relatório. No caso, todos os campos listados do lado esquerdo serão utilizados. Clique no botão >> para confirmar todos os campos para o lado direito. A figura seguinte ilustra que todos os campos foram selecionados. A figura seguinte ilustra a seleção do campo de descrição do grupo selecionado, indicando que o relatório será agrupado pelo nome do grupo de itens do estoque. O relatório será criado e apresentado no ambiente do JRS, como ilustrado a seguir.

12 Esse relatório necessita ser ajustado. É o que vamos fazer. Para alterar cada item do cabeçalho, basta efetuar um duplo clique sobre cada item e efetuar a respectiva alteração. Por exemplo, para alterar o titulo TITLE, dê um duplo clique sobre TITLE e altere seu conteúdo para Relação de Estoque, como ilustrado a seguir. Antes de alterar Logo após a alteração

13 Pode-se também utilizar a parte direita da IDE para efetuar as respectivas alterações, como mostra a próxima figura. Para visualizar o relatório com os dados do banco, basta selecionar a aba Preview, logo abaixo do design do formulário.

14 Faça os ajustes em cada label do cabeçalho e também do grupo, como está indicado na figura anterior. Após selecionar Preview, o relatório será mostrado como indicado na próxima figura. Observe que os itens são agrupados conforme a descrição de cada grupo. No entanto, os conteúdos dos campos com seus respectivos títulos (como, por exemplo, o código do produto) não estão bem alinhados. Faça isso. Ajuste o alinhamento do código e da quantidade para que fiquem centralizados em relação aos seus respectivos títulos, conforme está ilustrado na figura seguinte.

15 Note que, agora, o código 2 de Balde de Plástico está centralizado em relação ao título Código. O mesmo ocorre com o valor da quantidade do item. Usando o relatório na aplicação