Tópico AnteriorPróximo Tópico


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:

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

  1. Escolha Arquivo->Novo->Projeto. Novo Projeto, que aparece na Figura 1-2, exibe os tipos de projetos que podem ser criados.
  2. Figura 1-2 Novo Projeto
  3. Expanda Business Intelligence and Reporting Tools, selecione Projeto de Relatório e escolha Avançar.
  4. Em Novo Projeto de Relatório, em Nome do Projeto, digite o seguinte texto, conforme mostrado na Figura 1-3:
  5. Meus Relatórios 
     

    Figura 1-3 Novo Projeto de Relatório
  6. Para incluir o projeto, escolha Concluir. Agora é possível ver o projeto na visualização do Navegador, conforme mostrado na Figura 1-4.
  7. 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:

Neste tutorial, você iniciará com um design de relatório em branco.

  1. 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.
  2. Figura 1-5 Novo Relatório no Designer de Relatório BIRT
  3. 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.
  4. Digite o seguinte texto como o nome do arquivo:
  5. Customers.rptdesign 
    
  6. 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.
  7. Figura 1-6 Modelos de relatórios em Novo Relatório
  8. 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.

  1. 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.
  2. Figura 1-8 Explorador de Dados
  3. 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.
  4. Figura 1-9 Nova Origem de Dados
  5. 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.
  6. 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.
  7. 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.

  1. 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.
  2. Em Novo Conjunto de Dados, em Nome do Conjunto de Dados, digite o seguinte texto, conforme mostrado na Figura 1-11:
  3. Clientes 
     

    Figura 1-11 Novo Conjunto de Dados
  4. 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.
  5. Escolha Avançar.
  6. 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:
    select 
    from 
    
  7. Na área de texto, digite a seguinte instrução SQL SELECT para especificar os dados que serão recuperados:
  8. select customerName, 
    contactLastName, 
    contactFirstName, 
    phone 
    from Customers 
    
    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
  9. 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.
  10. 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.
  11. Figura 1-13 Linhas de dados retornadas por uma instrução SQL SELECT
  12. 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:

  1. Escolha Paleta. A paleta exibe todos os elementos que podem ser colocados em um relatório.
  2. 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.
  3. 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.
  4. Escolha Explorador de Dados.
  5. No Explorador de Dados, expanda Conjuntos de Dados e, em seguida, expanda Clientes. As colunas especificadas na consulta aparecem abaixo de Clientes.
  6. 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.
  7. 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
  8. Escolha OK para aceitar a definição de ligação de dados padrão.
  9. 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
  10. 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.
  11. Arraste CONTACTFIRSTNAME e solte-o na terceira célula da linha de detalhe. Escolha OK para aceitar a ligação de dados padrão.
  12. 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.
  13. Figura 1-17 Informações de cliente e de contato incluídas em uma tabela
  14. 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.
  15. 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.

  1. Escolha Layout para retornar ao editor de layout.
  2. 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.
  3. 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.
  4. Figura 1-19 Editor de Propriedades
  5. Escolha a guia Classificar.
  6. Escolha Incluir para criar uma expressão de classificação. Aparece uma linha em Chave de Classificação.
  7. Clique na linha em Chave de Classificação, selecione o botão de seta que aparece e escolha CUSTOMERNAME na lista drop-down.
  8. Utilize o valor padrão, Crescente, para Direção de Classificação, conforme mostrado na Figura 1-20.
  9. Figura 1-20 Direção de classificação crescente
  10. Visualize o relatório. Os dados classificados aparecem na ordem crescente, pelo nome do cliente, conforme mostrado na Figura 1-21.
  11. 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.
  12. 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:
  13. row["CUSTOMERNAME"].toUpperCase( ) 
    
    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.
  14. 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 os Títulos das Colunas

  1. Escolha Layout para retornar ao editor de layout.
  2. 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.
  3. 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.
  4. Substitua CUSTOMERNAME pelo seguinte texto:
    Cliente 
    
  5. Repita as etapas 2 e 3 para alterar os títulos da segunda e da terceira colunas para o seguinte texto:
  6. Fone 
    Contato 
    
    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:

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.

  1. Para configurar os títulos das colunas como negrito utilizando o Editor de Propriedades:
    1. 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.
    2. Figura 1-23 Propriedades dos elementos selecionados em Editor de Propriedades

    3. Escolha B para formatar os títulos das colunas como texto em negrito.
    4. Para cancelar a seleção dos títulos das colunas, clique no espaço em branco fora da tabela.
  2. Para incluir uma cor de segundo plano na linha do cabeçalho utilizando um estilo:
    1. No menu principal, escolha Elemento->Novo Estilo.
    2. 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
    3. Para Estilo Customizado, especifique o seguinte nome para o estilo:
    4. table_header_row 
      
    5. Escolha Segundo Plano na lista de categorias de propriedades. Novo Estilo exibe as propriedades de segundo plano que podem ser configuradas.
    6. 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.
    7. 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.
    8. Figura 1-25 Células-guia no início e à esquerda de uma tabela
    9. Selecione a célula-guia ao lado da linha de cabeçalho. O Editor de Propriedades exibe as propriedades da linha selecionada.
    10. Escolha Propriedades e, em seguida, Geral, para exibir as propriedades gerais da linha.
    11. 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.
  3. Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 1-26.
  4. 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.

  1. Escolha Layout para retornar ao editor de layout.
  2. Exclua o elemento de dados que exibe o sobrenome do contato.
  3. Dê um clique duplo no elemento de dados que exibe o nome do contato.
  4. 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.
  5. Clique na célula que exibe a expressão dataSetRow["CONTACTFIRSTNAME"] e, em seguida, escolha as reticências (...) .
  6. O Construtor de Expressões exibe a seguinte expressão na área de texto no início da janela:
    dataSetRow["CONTACTFIRSTNAME"] 
    
  7. Para concatenar o nome e o sobrenome, utilize a seguinte expressão:
  8. dataSetRow["CONTACTFIRSTNAME"]+" "+ 
    dataSetRow["CONTACTLASTNAME"] 
    
    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
  9. 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.
  10. Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 1-28.
  11. 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.

  1. Escolha Layout para retornar ao editor de layout.
  2. 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.
  3. 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.
  4. 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.
  5. Configure Preenchimento--Superior como 12 pontos.
  6. 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.
  7. 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.
  8. 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:

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.

  1. Escolha Layout para retornar ao editor de layout.
  2. Escolha Paleta.
  3. Arraste o elemento de texto da paleta e solte-o acima da tabela.
  4. Em Editar Item de Texto, selecione Texto HTML/Dinâmico na lista drop-down que exibe Texto Simples.
  5. 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.
  6. Especifique o seguinte texto na área de texto, mostrado na Figura 1-31:
  7. <CENTER><B><span style="font-size: larger"> 
    Lista de Clientes 
    </B></span><BR> 
    <FONT size="small">Apenas para uso interno</FONT><BR><BR> 
    Relatório gerado em <VALUE-OF>new Date( )</VALUE-OF> 
    </CENTER><BR><BR> 
     

    Figura 1-31 Texto com tags HTML
  8. Escolha OK e, em seguida, visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 1-32.
  9. 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:

Alternativamente, você pode utilizar:

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:


(c) Direitos Autorais Actuate Corporation 2006

Tópico AnteriorPróximo Tópico