Tutorial 1: Construindo um Relatório de Listagem Simples
Esta seção fornece instruções passo a passo para a construção de um relatório que lista nomes, números de telefone e nomes de contato do cliente. O relatório utiliza dados do banco de dados de amostra fornecidos com Modelos Clássicos do Designer de Relatório BIRT. A Figura 1-1 mostra uma parte do relatório concluído.
Figura 1-1 Relatório listando nomes, números de telefones e contatos do cliente
Neste tutorial, as seguintes tarefas serão executadas:
- Criar um novo projeto. Se você estiver utilizando o Designer de Relatório RCP do BIRT, essa etapa não será concluída.
Tarefa 1: Criar um Novo Projeto
O Eclipse organiza os arquivos de acordo com os projetos. Você pode criar um projeto para organizar todos os relatórios ou criar vários projetos para organizar os relatórios por categorias. Para cada projeto criado, o Eclipse cria um diretório no sistema de arquivo.
Se você estiver utilizando o Designer de Relatório RCP do BIRT, essa tarefa não se aplica a você.
- Escolha Arquivo->Novo->Projeto. Novo Projeto, que aparece na Figura 1-2, exibe os tipos de projetos que podem ser criados.
Figura 1-2 Novo Projeto
- Expanda Business Intelligence and Reporting Tools, selecione Projeto de Relatório e escolha Avançar.
- Em Novo Projeto de Relatório, em Nome do Projeto, digite o seguinte texto, conforme mostrado na Figura 1-3:
- Para incluir o projeto, escolha Concluir. Agora é possível ver o projeto na visualização do Navegador, conforme mostrado na Figura 1-4.
Figura 1-4 Um projeto na visualização do Navegador
Tarefa 2: Criar um Novo Relatório
Você pode criar um relatório das seguintes maneiras:
- Iniciar com um design de relatório em branco.
- Utilizar um modelo de relatório predefinido.
Para cada modelo, o Designer de Relatório BIRT fornece uma folha de dicas contendo instruções passo a passo para ajudá-lo a criar o relatório.
Neste tutorial, você iniciará com um design de relatório em branco.
- Escolha Arquivo->Novo->Relatório. Novo Relatório aparece. A Figura 1-5 mostra a janela que aparece no Designer de Relatório BIRT. Novo Relatório é um pouco diferente no Designer de Relatório RCP do BIRT.
Figura 1-5 Novo Relatório no Designer de Relatório BIRT
- No Designer de Relatório BIRT, pressione Enter ou selecione a pasta-pai; selecione o projeto criado. Essa etapa aplica-se apenas aos usuários do Designer de Relatório BIRT.
- Digite o seguinte texto como o nome do arquivo:
- Escolha Avançar. Novo Relatório fornece opções para iniciar com um relatório em branco e vários modelos de relatórios, conforme mostrado na Figura 1-6.
Figura 1-6 Modelos de relatórios em Novo Relatório
- Selecione Relatório em Branco e escolha Concluir. Seu novo relatório aparece na janela principal. Essa janela exibe o editor de layout, conforme mostrado na Figura 1-7. O editor de layout mostra uma página de relatório vazia.
O restante deste tutorial fornece as etapas detalhadas para a criação do relatório do cliente.
Figura 1-7 Design de relatório em branco
Tarefa 3: Construir uma Origem de Dados
Antes de iniciar o projeto do relatório no editor de layout, construa uma origem de dados BIRT para conectar o relatório a um banco de dados ou a outros tipos de origens de dados. Ao construir uma origem de dados, você especifica a classe do driver, o nome da origem de dados e outras informações de conexão, como nome do usuário e senha. Neste tutorial, você utilizará o banco de dados de amostra, Modelos Clássicos, já configurado para ser utilizado com o Designer de Relatório BIRT. Não é necessário especificar informações de conexão para ele.
- Escolha Explorador de Dados. Se você utiliza a perspectiva de design de relatório padrão, o Explorador de Dados está à esquerda do editor de layout, ao lado da Paleta, conforme mostrado na Figura 1-8. Se ele não estiver aberto, escolha Janela->Mostrar Visualização->Explorador de Dados.
Figura 1-8 Explorador de Dados
- Clique com o botão direito do mouse em Origens de Dados e, em seguida, escolha Nova Origem de Dados no menu de contexto. Nova Origem de Dados exibe os tipos de origens de dados que podem ser criados, conforme mostrado na Figura 1-9.
Figura 1-9 Nova Origem de Dados
- Selecione Banco de Dados de Amostra de Modelos Clássicos Inc., na lista de tipos de origem de dados. Utilize o nome da origem de dados padrão e escolha Avançar. Aparecem informações de conexão sobre a nova origem de dados.
- Escolha Concluir. O Designer de Relatório BIRT cria uma nova origem de dados que é conectada ao banco de dados de amostra. Ela aparece em Origens de Dados no Explorador de Dados, mostrada na Figura 1-10.
Figura 1-10 Origens de Dados no Explorador de Dados
Tarefa 4: Construir um Conjunto de Dados
Agora você está pronto para construir o conjunto de dados. Um conjunto de dados identifica os dados a serem recuperados da origem de dados. Se o relatório for conectado a uma origem de dados JDBC, você utilizará uma instrução SQL SELECT para identificar os dados a serem recuperados.
- No Explorador de Dados, clique com o botão direito do mouse em Conjuntos de Dados e escolha Novo Conjunto de Dados no menu de contexto.
- Em Novo Conjunto de Dados, em Nome do Conjunto de Dados, digite o seguinte texto, conforme mostrado na Figura 1-11:
- Utilize os valores padrão para os outros campos:
- Origem de Dados mostra o nome da origem de dados criada anteriormente.
- Tipo de Conjunto de Dados indica que o conjunto de dados utiliza uma consulta SQL SELECT.
- Escolha Avançar.
Consulta exibe as informações para ajudá-lo a criar uma consulta SQL. Itens Disponíveis lista todas as tabelas do banco de dados Modelos Clássicos. Você pode clicar no sinal de mais (+) ao lado de uma tabela para exibir suas colunas. A área de texto do lado direito de Editar Conjunto de Dados mostra as palavras-chave obrigatórias de uma instrução SQL SELECT:
- Na área de texto, digite a seguinte instrução SQL SELECT para especificar os dados que serão recuperados:
Embora o editor do conjunto de dados mostre nomes de tabelas e de colunas em letras maiúsculas, eles podem ser digitados de qualquer maneira, porque o SQL não faz distinção entre maiúsculas e minúsculas. Se você não quiser digitar a consulta, arraste as colunas e as tabelas a partir de Itens Disponíveis para a área de texto.
A instrução SELECT criada, mostrada na
Figura 1-12, recebe valores das colunas CUSTOMERNAME, CONTACTLASTNAME, CONTACTFIRSTNAME e PHONE na tabela CUSTOMERS.
Figura 1-12 Instrução SQL SELECT em Editar Conjunto de Dados
- Escolha Concluir para salvar o conjunto de dados. Editar Conjunto de Dados exibe as colunas especificadas na consulta e fornece opções para editar o conjunto de dados.
- Escolha Visualizar Resultados para certificar-se de que a consulta seja válida e que retorne os dados corretos. Se a instrução SELECT tiver sido digitada corretamente, você verá os resultados mostrados na Figura 1-13. Estas são as linhas de dados retornadas pela consulta.
Figura 1-13 Linhas de dados retornadas por uma instrução SQL SELECT
- Escolha OK.
Tarefa 5: Definir Layout do Relatório
Neste procedimento, você inserirá elementos na página do relatório para exibir os dados do conjunto de dados criado anteriormente. Comece inserindo um elemento de tabela, depois insira elementos de dados na tabela. É importante entender a funcionalidade fornecida pela tabela:
- A tabela é repetida em todas as linhas de dados retornadas por um conjunto de dados.
- Ela permite definir layout dos dados com facilidade em um formato de linha e de coluna.
- Escolha Paleta. A paleta exibe todos os elementos que podem ser colocados em um relatório.
- Arraste um elemento de tabela da paleta e solte-o no relatório no editor de layout. Inserir Tabela solicita a especificação do número de colunas e linhas de detalhes a serem criados para a tabela.
- Especifique três colunas e uma linha de detalhe e, em seguida, escolha OK. Aparecerá uma tabela com três colunas e uma linha de detalhe no editor de layout. Agora você está pronto para inserir dados na tabela.
- Escolha Explorador de Dados.
- No Explorador de Dados, expanda Conjuntos de Dados e, em seguida, expanda Clientes. As colunas especificadas na consulta aparecem abaixo de Clientes.
- Arraste CUSTOMERNAME a partir do Explorador de Dados e solte-o na primeira célula da linha de detalhe da tabela, conforme mostrado na Figura 1-14. A linha de detalhe exibe os dados principais no relatório. No relatório concluído, a linha de detalhe é repetida para exibir todas as linhas de dados do conjunto de dados.
Figura 1-14 Arrastando uma coluna do Explorador de Dados e soltando-a em uma célula
da tabela
O Designer de Relatório BIRT cria uma coluna nomeada que está ligada ao campo de conjunto de dados. Selecionar Ligação de Dados, mostrada na
Figura 1-15, exibe essa ligação de dados.
Figura 1-15 Uma coluna nomeada ligada a um campo de conjunto de dados
- Escolha OK para aceitar a definição de ligação de dados padrão.
No editor de layout, a célula da tabela na qual você soltou o campo CUSTOMERNAME contém um elemento de dados que exibe [CUSTOMERNAME]. Acima desse elemento de dados há um elemento de etiqueta incluído automaticamente pelo editor de layout na linha de cabeçalho. Essa etiqueta exibe o nome do campo como texto estático. Ele serve como título da coluna. A
Figura 1-16 mostra os elementos de dados e de etiqueta.
Figura 1-16 Elementos de dados e de etiqueta em uma tabela
- Arraste PHONE a partir do Explorador de Dados e solte-o na segunda célula da linha de detalhe. Escolha OK para aceitar a ligação de dados padrão.
- Arraste CONTACTFIRSTNAME e solte-o na terceira célula da linha de detalhe. Escolha OK para aceitar a ligação de dados padrão.
- Arraste CONTACTLASTNAME e solte-o na terceira célula da linha de detalhe, abaixo de CONTACTFIRSTNAME. Escolha OK para aceitar a ligação de dados padrão. A página de relatório deve assemelhar-se à mostrada na Figura 1-17.
Figura 1-17 Informações de cliente e de contato incluídas em uma tabela
- Escolha Visualizar, a guia na parte inferior do editor de layout. O Designer de Relatório BIRT gera e exibe o relatório no formato HTML, conforme mostrado na Figura 1-18. Role para baixo para ver o relatório inteiro. Também é possível visualizá-lo em PDF. Isso é feito escolhendo-se Arquivo->Visualizar Relatório como PDF no menu principal.
Conforme mostra a
Figura 1-18, os dados estão corretos, mas aparecem em ordem aleatória. O mais adequado é classificar os dados alfabeticamente pelo nome do cliente. A aparência do relatório também precisa de aperfeiçoamento.
Figura 1-18 Visualização dos dados do relatório
Tarefa 6: Classificar os Dados
Ao criar e visualizar um relatório pela primeira vez, as linhas de dados são exibidas na ordem em que são retornadas pela consulta. A ordem pode variar, dependendo de vários fatores, como a forma com que os dados foram fornecidos na origem de dados. Na maioria dos casos, é provável que você queira alterar a ordem de exibição dos dados no relatório.
- Escolha Layout para retornar ao editor de layout.
- Abra Editor de Propriedades, se necessário. Se você utiliza a perspectiva de design de relatório padrão, o Editor de Propriedades aparece abaixo do editor de layout. Se ele não estiver aberto, escolha Janela->Mostrar Visualização->Editor de Propriedades.
- No editor de layout, selecione a tabela escolhendo a guia Tabela no canto inferior esquerdo. Essa guia aparece quando você suspende o ponteiro do mouse sobre essa área. O Editor de Propriedades exibe as propriedades da tabela, conforme mostrado na Figura 1-19.
Figura 1-19 Editor de Propriedades
- Escolha a guia Classificar.
- Escolha Incluir para criar uma expressão de classificação. Aparece uma linha em Chave de Classificação.
- Clique na linha em Chave de Classificação, selecione o botão de seta que aparece e escolha CUSTOMERNAME na lista drop-down.
- Utilize o valor padrão, Crescente, para Direção de Classificação, conforme mostrado na Figura 1-20.
Figura 1-20 Direção de classificação crescente
- Visualize o relatório. Os dados classificados aparecem na ordem crescente, pelo nome do cliente, conforme mostrado na Figura 1-21.
Figura 1-21 Dados classificados pelo nome do cliente
Observe que aparecem nomes com letras maiúsculas no início da lista. O BIRT classifica dados de cadeia pelos valores de ponto de código UCS2. Nos conjuntos de caracteres baseados em ASCII, as letras maiúsculas possuem valores de ponto de código inferiores aos das letras minúsculas. Portanto, as letras maiúsculas aparecem antes das minúsculas.
- Para classificar os nomes de clientes para que não façam distinção entre maiúsculas/minúsculas para que ANG Resellers apareça depois de American Souvenirs Inc., e não como antes, altere a expressão Chave de Classificação na página Classificação para a seguinte expressão:
Essa expressão utiliza a função JavaScript toUpperCase( ) para converter todos os valores de nomes de clientes em maiúsculas antes da classificação. Os nomes de funções JavaScript fazem distinção entre maiúsculas e minúsculas, portanto, é necessário digitar toUpperCase( ) exatamente conforme mostrado. As referências a nomes de colunas também fazem distinção entre maiúsculas e minúsculas. Nessa expressão, row["CUSTOMERNAME"] é o nome correto a ser utilizado. Se você digitar row["customername"], por exemplo, o Designer de Relatório BIRT exibirá um erro quando o relatório for executado. Você pode verificar a capitalização de um nome de coluna consultando o nome exibido no Explorador de Dados.
- Visualize o relatório. Os nomes dos clientes aparecem em uma ordem diferente. Os nomes com letras maiúsculas não aparecem no início da lista.
Tarefa 7: Formatar o Relatório
Agora que você verificou que o relatório exibe os dados corretos na ordem correta, poderá concentrar-se no aperfeiçoamento da aparência do relatório. As seguintes tarefas serão executadas nesta seção:
- Editar o texto dos títulos das colunas.
- Formatar os títulos das colunas para diferenciá-los das linhas de dados.
- Exibir nome e sobrenome dos contatos na mesma linha.
- Aumentar o espaço entre linhas.
Editar os Títulos das Colunas
- Escolha Layout para retornar ao editor de layout.
- Dê um clique duplo no título da primeira coluna, CUSTOMERNAME. O título da coluna está na primeira linha--a linha de cabeçalho--da tabela.
- Para substituir todo o texto realçado, comece a digitar e, em seguida, pressione Enter ao concluir. Para editar o texto, clique uma vez para cancelar a seleção do texto e, em seguida, posicione o cursor no lugar em que deseja excluir ou incluir caracteres.
Substitua CUSTOMERNAME pelo seguinte texto:
- Repita as etapas 2 e 3 para alterar os títulos da segunda e da terceira colunas para o seguinte texto:
O design do relatório deve assemelhar-se ao mostrado na
Figura 1-22.
Figura 1-22 Títulos de colunas revisados em um design de relatório
Formatar os Títulos das Colunas
Para formatar um elemento de relatório, configure suas propriedades. É possível realizar essa tarefa de duas maneiras:
- Configurar as propriedades de um elemento utilizando o Editor de Propriedades.
- Definir um estilo que contenha as propriedades desejadas e aplicá-lo a um elemento. Utilize esse método para definir as propriedades de formato uma vez e aplicá-las a mais de um elemento.
Neste procedimento, utilize o primeiro método para configurar os títulos das colunas como negrito e o segundo método para incluir cor na linha de cabeçalho.
- Para configurar os títulos das colunas como negrito utilizando o Editor de Propriedades:
- Selecione todos os títulos de colunas. Para selecionar vários elementos, pressione a tecla Shift enquanto clica em cada elemento. O Editor de Propriedades exibe as propriedades dos elementos selecionados, conforme mostrado na Figura 1-23.
Figura 1-23 Propriedades dos elementos selecionados em Editor de Propriedades
- Escolha B para formatar os títulos das colunas como texto em negrito.
- Para cancelar a seleção dos títulos das colunas, clique no espaço em branco fora da tabela.
- Para incluir uma cor de segundo plano na linha do cabeçalho utilizando um estilo:
- No menu principal, escolha Elemento->Novo Estilo.
Novo Estilo aparece, conforme mostrado na
Figura 1-24. O lado esquerdo exibe as categorias de propriedades. O lado direito exibe as propriedades da categoria selecionada.
Figura 1-24 Novo Estilo
- Para Estilo Customizado, especifique o seguinte nome para o estilo:
- Escolha Segundo Plano na lista de categorias de propriedades. Novo Estilo exibe as propriedades de segundo plano que podem ser configuradas.
- Especifique a cor da propriedade Cor de Segundo Plano utilizando um dos seguintes métodos:
- Selecione o botão ao lado da propriedade e escolha uma cor na paleta de cores que aparece.
- Selecione uma cor na lista drop-down.
Escolha OK.
- No editor de layout, selecione a tabela escolhendo a guia Tabela no canto inferior esquerdo. Essa guia aparece quando você suspende o ponteiro do mouse sobre essa área. Células-guia aparecem nos lados superior e esquerdo da tabela, conforme mostrado na Figura 1-25.
Figura 1-25 Células-guia no início e à esquerda de uma tabela
- Selecione a célula-guia ao lado da linha de cabeçalho. O Editor de Propriedades exibe as propriedades da linha selecionada.
- Escolha Propriedades e, em seguida, Geral, para exibir as propriedades gerais da linha.
- Aplique o estilo recém-criado selecionando table_header_row na lista drop-down ao lado de Estilo. O Designer de Relatório BIRT aplica o estilo na linha de cabeçalho e ele aparece colorido.
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 1-26.
Figura 1-26 Visualização do relatório mostrando o estilo da linha do cabeçalho
Até agora, o principal aperfeiçoamento é que os títulos estão bem visíveis e definidos.
Exibir Nome e Sobrenome na mesma Linha
Quando você coloca vários elementos em uma única célula, o Designer de Relatório BIRT cria elementos no nível do bloco. Se estiver familiarizado com HTML, você sabe que cada elemento de bloco inicia em uma nova linha. Para exibir vários elementos na mesma linha, é necessário configurá-los como elementos seqüenciais. Alternativamente, você pode concatenar os valores de nome e sobrenome para serem exibidos em um único elemento de dados, conforme descrito neste procedimento.
- Escolha Layout para retornar ao editor de layout.
- Exclua o elemento de dados que exibe o sobrenome do contato.
- Dê um clique duplo no elemento de dados que exibe o nome do contato.
Selecionar Ligação de Dados exibe todas as ligações de dados utilizadas no relatório. Um visto ao lado de CONTACTFIRSTNAME indica a ligação de dados utilizada pelo elemento de dados selecionado.
- Clique na célula que exibe a expressão dataSetRow["CONTACTFIRSTNAME"] e, em seguida, escolha as reticências (...) .
O Construtor de Expressões exibe a seguinte expressão na área de texto no início da janela:
- Para concatenar o nome e o sobrenome, utilize a seguinte expressão:
A
Figura 1-27 mostra essa expressão em Construtor de Expressões. As aspas (" ") vazias incluem um espaço entre o nome e o sobrenome. Você pode digitar a expressão na área de texto ou dar um clique duplo em um item no lado direito inferior da janela para inseri-lo na expressão.
Figura 1-27 Dados concatenados no Construtor de Expressões
- Escolha OK para fechar o Construtor de Expressões e, em seguida, escolha OK em Selecionar Ligação de Dados para salvar a expressão modificada.
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 1-28.
Figura 1-28 Visualização do relatório mostrando nomes de contatos concatenados
Aumentar o Espaço entre Linhas
O layout padrão inclui um espaço mínimo entre as linhas das tabelas. Normalmente, é provável que você queira ajustar o espaçamento entre as linhas.
- Escolha Layout para retornar ao editor de layout.
- Selecione todas as células na linha de detalhe central. Para selecionar várias células, utilize Shift-clique. Preste atenção para selecionar as células, não os elementos de dados contidos nas células. Aparece uma caixa em torno das células selecionadas, conforme mostrado na Figura 1-29.
Figura 1-29 Células selecionadas no editor de layout
O Editor de Propriedades exibe as propriedades das células. O título que aparece no Editor de Propriedades mostra o tipo de elemento selecionado, portanto, você verá Editor de Propriedades - Célula.
- Escolha Preenchimento. O Editor de Propriedades exibe as propriedades de preenchimento. Essas propriedades permitem especificar a quantidade de espaço a ser incluído nos lados superior, inferior, esquerdo ou direito do elemento.
- Configure Preenchimento--Superior como 12 pontos.
Neste momento, você deve se perguntar porque apenas não selecionou a linha para ajustar o espaçamento de linha, em vez de selecionar as células individuais da linha. O Designer de Relatório BIRT não suporta o preenchimento de linha, porque alguns navegadores não suportam esse recurso.
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 1-30. Há mais espaço entre as linhas de dados.
Figura 1-30 Visualização do relatório mostrando o espaçamento de linhas
Tarefa 8: Criar um Título de Relatório
Tudo o que o relatório precisa agora é de um título. Para exibir um título, utilize um elemento de etiqueta, um elemento de texto ou um elemento de dados:
- O elemento de etiqueta é adequado para texto curto e estático, como títulos de colunas.
- O elemento de dados é adequado para exibição de valores dinâmicos a partir de um campo de conjunto de dados ou de um campo calculado.
- O elemento de texto e adequado para texto com várias linhas que contém valores de formatação ou dinâmicos diferentes.
Neste procedimento, você utilizará um elemento de texto e tags HTML para formatar o texto. Observe que não é necessário utilizar HTML para criar texto formatado. Se, no entanto, você conhecer bem HTML ou Web design, talvez prefira utilizar HTML para criar um bloco de texto formatado.
- Escolha Layout para retornar ao editor de layout.
- Escolha Paleta.
- Arraste o elemento de texto da paleta e solte-o acima da tabela.
- Em Editar Item de Texto, selecione Texto HTML/Dinâmico na lista drop-down que exibe Texto Simples.
Ao selecionar texto HTML ou dinâmico, você pode incorporar tags HTML ou propriedades CSS no texto. Você pode digitar as tags ou pode inserir as tags HTML comumente utilizadas fornecidas pelo editor de texto.
- Especifique o seguinte texto na área de texto, mostrado na Figura 1-31:
- Escolha OK e, em seguida, visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 1-32.
Figura 1-32 Visualização do relatório mostrando o título do relatório formatado
Como você pode ver, utilizar o elemento de texto com HTML incorporado permite:
- Utilizar formatação diferente para cada linha em um bloco de texto com várias linhas.
- Inserir valores dinâmicos, como a data atual.
Alternativamente, você pode utilizar:
- Dois elementos de etiqueta para exibir a primeira e a segunda linhas de texto estático
- Um elemento de dados para exibir a terceira linha que contém o valor dinâmico
Próximas Etapas
Você acabou de construir seu primeiro relatório e trabalhou com algumas das ferramentas e recursos básicos do Designer de Relatório BIRT. Há muitas outras tarefas que podem ser realizadas para construir relatórios mais sofisticados. Algumas delas, descritas em outros capítulos deste manual, incluem:
- Conectando-se à sua própria origem de dados
- Criando gráficos
- Criando parâmetros de relatórios para entrada do usuário
- Construindo relatórios que contêm sub-relatórios
- Formatando elementos de relatório com base em condições
- Ocultando relatórios com base em condições
- Incluindo hyperlinks para vincular o relatório a locais da Web ou para vincular uma seção de relatório à outra
