Tutorial 2: Agrupando Dados do Relatório
Este tutorial fornece instruções para agrupar dados do cliente pelo limite de crédito. Ele começa com o relatório construído no Tutorial 1: "Construindo um Relatório de Listagem Simples." No primeiro tutorial, você construiu um relatório simples que listava os clientes em ordem alfabética. Neste relatório, os clientes serão organizados em grupos de limite de crédito de $50.000,00, como 0-49999, 50000-99999, 100000-149999, etc.
Antes de começar este tutorial, é necessário concluir o primeiro tutorial.
Neste tutorial, as seguintes tarefas serão executadas:
Tarefa 1: Abrir o Design de Relatório
No primeiro tutorial, você criou Customers.rptdesign em uma pasta de projeto chamada Meus Relatórios. Abra Customers.rptdesign utilizando um dos procedimentos a seguir:
- Se você estiver utilizando o Designer de Relatório BIRT, abra o arquivo por meio do Navegador.
- Abra o Navegador escolhendo Janela->Mostrar Visualização->Navegador. O Navegador mostra todas as pastas de projetos e arquivos de relatório criados.
- Navegue para a pasta Meus Relatórios e dê um clique duplo em Customers.rptdesign.
- Se estiver utilizando o Designer de Relatório RCP do BIRT, utilize o menu principal para abrir o arquivo:
- Escolha Arquivo->Abrir Arquivo.
- Navegue e selecione Customers.rptdesign e, em seguida, escolha Abrir.
O arquivo é aberto no editor de layout, conforme mostrado na Figura 8-1.
Figura 8-1 Design do relatório de cliente no editor de layout
Tarefa 2: Salvar o Relatório como um Novo Arquivo
Em vez de editar diretamente o relatório criado no primeiro tutorial, salve Customers.rptdesign como um novo arquivo.
- Escolha Arquivo->Salvar como. Salvar como exibe o nome e o local atuais do arquivo.
- Para Nome do Arquivo, altere Customers.rptdesign para Customers_grouped.rptdesign e, em seguida, escolha Concluir. O Designer de Relatório BIRT faz uma cópia de Customers.rptdesign. O novo arquivo aparece no editor de layout.
Tarefa 3: Incluir o Campo de Limite de Crédito no Conjunto de Dados
Para que o relatório exiba dados de limite de crédito, é necessário incluir o campo CREDITLIMIT no conjunto de dados.
- Escolha Explorador de Dados.
- Expanda Conjuntos de Dados e, em seguida, dê um clique duplo em Clientes. Editar Conjunto de Dados exibe a consulta SQL para o conjunto de dados Clientes.
- Inclua uma vírgula (,) depois do telefone.
- Na linha seguinte, inclua o seguinte texto:
A consulta modificada deve assemelhar-se à mostrada na
Figura 8-2.
Figura 8-2 Consulta com o campo creditLimit incluído
- Escolha Visualizar Resultados para verificar se a consulta retorna linhas com informações de limite de crédito.
- Escolha OK para salvar o conjunto de dados.
Tarefa 4: Incluir Dados de Limite de Crédito no Relatório
Neste procedimento, você inserirá o campo de limite de crédito na tabela existente.
- No editor de layout, selecione a tabela. Células-guia aparecem nos lados superior e esquerdo da tabela.
- Clique com o botão direito do mouse na célula-guia acima da primeira coluna e escolha Inserir->Coluna à Esquerda, conforme mostrado na Figura 8-3.
Figura 8-3 Inserindo uma coluna à esquerda de uma coluna existente
Uma nova coluna aparece.
- No Explorador de Dados, expanda Conjuntos de Dados e, em seguida, expanda Clientes. O conjunto de dados de Clientes exibe os campos especificados na consulta.
- Arraste o campo CREDITLIMIT a partir do Explorador de Dados e solte-o na célula da linha de detalhe ao lado de [CUSTOMERNAME].
O Designer de Relatório BIRT cria uma coluna nomeada que está ligada ao campo de conjunto de dados. Selecionar Ligação de Dados exibe essa ligação de coluna.
- Escolha OK para aceitar a ligação de coluna padrão.
No editor de layout, a tabela exibe o campo incluído. Ela também mostra o elemento de etiqueta incluído automaticamente pelo editor de layout na linha de cabeçalho. Essa etiqueta serve como título da coluna e exibe o nome do campo como texto estático. O relatório deve assemelhar-se ao mostrado na
Figura 8-4.
Figura 8-4 Resultado da inclusão do campo de limite de crédito no editor de layout
- Edite a etiqueta CREDITLIMIT para que apareça como Limite de Crédito.
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 8-5.
Figura 8-5 Visualização do relatório mostrando o resultado da inclusão do limite de crédito
Alguns dos clientes possuem um limite de crédito de 0. São novos clientes que ainda não foram aprovados para uma linha de crédito.
Tarefa 5: Agrupar Dados do Cliente por Limite de Crédito
O relatório está classificado atualmente em ordem alfabética por nome de cliente. Lembre-se que no primeiro tutorial, você especificou que as linhas da tabela fossem classificadas pelo nome do cliente. Neste procedimento, você agrupará os dados por limite de crédito em intervalos de 50.000. Quando você agrupa dados, o BIRT classifica as linhas em grupos primeiro e, em seguida, as classifica dentro de cada grupo, supondo-se que você também especifique uma condição de classificação no nível de tabela. Como você verá ao concluir essa tarefa, as linhas de dados dentro de cada grupo de limite de crédito serão classificadas pelo nome de cliente.
- Escolha Layout para retornar ao editor de layout.
- Clique com o botão direito do mouse na tabela e escolha Inserir Grupo->Acima. Novo Grupo, mostrado na Figura 8-6, exibe as propriedades do grupo que podem ser configuradas.
Figura 8-6 Novo Grupo
- Siga estas etapas para especificar o agrupamento por limite de crédito em intervalos de 50000:
- Para Nome, digite o seguinte texto como o nome do grupo:
- Para Grupo Ativo, selecione CREDITLIMIT na lista drop-down.
- Para Intervalo, selecione Intervalo na lista drop-down.
- Para Intervalo, digite 50000.
- Utilize os valores padrão para as outras opções.
- Escolha OK.
A tabela no design de relatório exibe uma linha de cabeçalho de grupo e uma linha de rodapé de grupo, conforme mostrado na
Figura 8-7. Ela também mostra o elemento de dados incluído automaticamente pelo editor de layout na linha de cabeçalho do grupo. Esse elemento de dados serve como título do grupo e, no relatório gerado, exibe o primeiro valor de limite de crédito de cada grupo.
Figura 8-7 Linhas de cabeçalho do grupo e de rodapé do grupo em um design de relatório
- Selecione o elemento de dados [CREDITLIMIT] que aparece na linha de cabeçalho do grupo. Não selecione o elemento de dados [CREDITLIMIT] que aparece na linha de detalhe.
- Em Editor de Propriedades, escolha Geral e, em seguida, escolha B para formatar o título do grupo como texto em negrito.
- Visualize o relatório. Role para baixo no relatório para visualizar todos os dados. Como mostra a Figura 8-8, o relatório organiza os dados em quatro grupos de limite de crédito. No início de cada grupo, você vê os seguintes números em negrito: 0, 61100, 113000, 227600. Eles correspondem ao primeiro valor de limite de crédito de cada grupo. Dentro de cada grupo, os clientes são classificados em ordem alfabética.
Figura 8-8 Visualização do relatório mostrando um dos quatro grupos de limite de crédito
Tarefa 6: Exibir Intervalos de Limite de Crédito no Cabeçalho do Grupo
Em vez de exibir o primeiro valor de cada grupo no cabeçalho do grupo, será mais fácil navegar pelo relatório se ele exibir o intervalo de limite de crédito de cada grupo, como a seguir:
Este procedimento mostra como gravar uma expressão JavaScript para exibir esses intervalos de limite de crédito. O procedimento também mostra como criar uma ligação de coluna à qual associar a expressão JavaScript.
- Escolha Layout para retornar ao editor de layout.
- Selecione a tabela e escolha Ligação no Editor de Propriedades.
- Crie uma nova ligação de coluna:
- Escolha Incluir.
- No Construtor de Expressões, digite a seguinte expressão:
- Escolha OK. A nova ligação de coluna aparece na página Ligação do Editor de Propriedades com o nome da coluna realçado.
- Substitua o nome Nova Ligação pelo seguinte nome:
- Atualize o elemento de dados CREDITLIMIT no cabeçalho do grupo para utilizar a nova ligação de coluna dando um clique duplo no elemento de dados e selecionando CREDIT_GROUP_HEADER e, em seguida, escolha OK.
- Visualize o relatório. Os cabeçalhos do grupo exibem os intervalos de limite de crédito. A Figura 8-9 mostra o cabeçalho de grupo 50000 - 99999.
Figura 8-9 Visualização do relatório mostrando intervalos do limite de crédito
Tarefa 7: Exibir Informações Agregadas
Um dos benefícios do agrupamento de dados é que você pode incluir informações resumidas ou agregadas no início ou no final de cada grupo. Neste procedimento, as seguintes tarefas serão concluídas:
- Exibir o número de clientes de cada grupo.
- Exibir o número de todos os clientes listados no relatório.
- Escolha Layout para retornar ao editor de layout.
- Exiba o número de clientes de cada grupo:
- Arraste um elemento de dados da paleta e solte-o na primeira célula na linha de rodapé do grupo. Os elementos que estiverem no rodapé do grupo aparecerão no final de cada grupo.
- Em Selecionar Ligação de Dados, crie uma nova ligação de coluna:
- Em uma nova linha, em Nome, digite o seguinte texto:
- Utilize o tipo de dados padrão, Qualquer um.
- Em Expressão, digite a seguinte expressão agregada:
Total.count( ) retorna o número de linhas.
- Utilize o valor padrão de Agregação Ativada, credit_group. Esse valor indica que a função Total.count( ) retornará o número de linhas de cada grupo de limite de crédito.
- Selecione a ligação de coluna recém-criada e escolha OK. O elemento de dados utiliza a ligação de coluna selecionada.
- Visualize o relatório. O relatório exibe o número de clientes no final de cada grupo, conforme mostrado na Figura 8-10.
Figura 8-10 Visualização do relatório mostrando uma contagem para cada grupo
- Escolha Layout para retornar ao editor de layout.
- Exiba o número de todos os clientes:
- Selecione a tabela.
Células-guia aparecem nos lados superior e esquerdo da tabela.
- Clique com o botão direito do mouse na célula-guia à esquerda da primeira linha, Tabela - Cabeçalho e, em seguida, escolha Inserir->Linha->Acima.
Aparece uma nova linha de cabeçalho da tabela acima da linha que exibe os títulos das colunas. Ela é colorida porque herdou as propriedades da linha seguinte a ela.
- Selecione a nova linha e, em Editor de Propriedades, altere sua cor de segundo plano para branco.
- Arraste um elemento de dados da paleta e solte-o na primeira célula na nova linha de cabeçalho da tabela. Os elementos que estiverem no cabeçalho da tabela aparecerão no início da seção.
- Em Selecionar Ligação de Dados, crie uma nova ligação de coluna:
- Em uma nova linha, em Nome, digite o seguinte texto:
- Utilize o tipo de dados padrão, Qualquer um.
- Em Expressão, digite a seguinte expressão agregada:
- Utilize o valor padrão de Agregação Ativada, ALL. Esse valor indica que a função Total.count( ) retornará o número de linhas da tabela inteira.
- Selecione a ligação de coluna recém-criada e escolha OK. O elemento de dados utiliza a ligação de coluna selecionada.
O design do relatório deve assemelhar-se ao mostrado na
Figura 8-11.
Figura 8-11 Design de relatório mostrando uma contagem total para clientes
- Visualize o relatório. O relatório exibe o número de clientes no início da tabela, conforme mostrado na Figura 8-12.
Figura 8-12 Visualização do relatório mostrando um número total de clientes
Tarefa 8: Formatar o Relatório
Agora que o relatório exibe os dados corretos, você poderá concentrar-se no aperfeiçoamento da aparência do relatório. As seguintes tarefas serão executadas nesta seção:
Remover Dados de Limite de Crédito das Linhas de Detalhes
Para verificar se os dados aparecem nos grupos de limite de crédito corretos, é útil exibir o limite de crédito de cada cliente. Agora que verificamos os dados, podemos excluir as informações de limite de crédito individual do relatório.
- Escolha Layout para retornar ao editor de layout.
- Exclua o elemento de dados [CREDITLIMIT] da linha de detalhe.
- Visualize o relatório. Ele deve assemelhar-se ao mostrado na Figura 8-13.
Figura 8-13 Visualização do relatório sem dados de limite de crédito em cada linha
Exibir Títulos de Grupo na Primeira Linha de cada Grupo
Os títulos do grupo de limite de crédito aparecem em suas próprias linhas, acima das linhas de detalhes de cada grupo. Neste procedimento, você soltará os títulos do grupo para que apareçam na primeira linha de detalhe.
- Escolha Layout para retornar ao editor de layout.
- Selecione a célula que contém o título do grupo, conforme mostrado na Figura 8-14. Certifique-se de selecionar a célula e não seu elemento de dados.
Figura 8-14 Célula do título de grupo selecionada
- Nas Propriedades Gerais do Editor de Propriedades, configure Soltar como Detalhe. No design de relatório, o título do grupo ainda aparece acima da linha de detalhe porque, tecnicamente, o elemento continua na linha de cabeçalho do grupo.
- Nas Propriedades de Preenchimento do Editor de Propriedades, configure Preenchimento--Superior para 12 pontos. Essa configuração alinha os títulos do grupo mais precisamente com os dados das linhas de detalhes. Lembre-se que, no primeiro tutorial, incluímos um preenchimento de 12 pontos na parte superior das células da linha de detalhe.
- Visualize o relatório. Os títulos do grupo aparecem na primeira linha de cada grupo, conforme mostrado na Figura 8-15.
Figura 8-15 Visualização do relatório mostrando os títulos de grupo soltos
Separar cada Grupo com uma Linha
Desenhar uma linha para separar cada grupo facilita a visão dos grupos de dados.
- Escolha Layout para retornar ao editor de layout.
- Selecione todas as células na linha de rodapé do grupo. Para selecionar várias células, utilize Shift-clique.
- Escolha Moldura no Editor de Propriedades e, em seguida, configure as propriedades da moldura:
- Configure Estilo com uma linha sólida.
- Escolha o botão que mostra a moldura inferior.
- Inclua mais espaço entre a linha e o texto acima dela. Enquanto as células ainda estão selecionadas, escolha as Propriedades de Preenchimento no Editor de Propriedades e configure Inferior para 6.0 pontos.
- Visualize o relatório. Aparece uma linha no final de cada grupo, conforme mostrado na Figura 8-16.
Figura 8-16 Visualização do relatório mostrando uma linha entre os grupos
Tarefa 9: Visualizar o Relatório no Visualizador de Relatórios BIRT
Até agora, verificamos a saída de relatório no pré-visualizador do Designer de Relatório BIRT. Desta vez, você utilizará o visualizador de relatórios para ver a aparência do relatório ao ser implementado. O visualizador de relatórios fornece funcionalidade adicional, incluindo a capacidade de navegar para seções específicas de um relatório utilizando um índice. Quando você cria grupos em um relatório, o BIRT gera automaticamente um índice utilizando os valores do grupo para mostrar a hierarquia do relatório.
- Escolha Arquivo->Visualizar Relatório no Visualizador da Web.
O relatório aparece no visualizador de relatórios.
- Escolha o botão de índice, aquele à esquerda no início da janela, para exibir o índice.
O índice exibe o primeiro valor em cada um dos quatro grupos de limite de crédito. Quando você seleciona um valor, o relatório exibe a seção correspondente do relatório. Se 61100 for selecionado, por exemplo, o relatório mostrará as linhas de cliente no intervalo de limite de crédito 50000 - 99999, conforme mostrado na
Figura 8-17.
Figura 8-17 Selecione um valor no índice para visualizar os dados
correspondentes
Tarefa 10: Exibir Intervalos de Limite de Crédito no Índice
Em vez de exibir o primeiro valor de cada grupo de limite de crédito, fará mais sentido se o índice exibir os mesmos valores do intervalo de limite de crédito que o relatório. Você realizará essa tarefa utilizando a mesma expressão JavaScript utilizada anteriormente para exibir intervalos de limite de crédito (0 - 49999, 50000 - 99999, etc.) no cabeçalho do grupo.
- Retorne para o Designer de Relatório BIRT.
- No editor de layout, selecione a tabela e, em seguida, escolha a guia Grupos no Editor de Propriedades.
- Dê um clique duplo em credit_group na lista de grupos.
Editar Grupo exibe as propriedades do grupo. Expressão do Item TOC é definida, por padrão, no campo de agrupamento, row["CREDITLIMIT"].
- Escolha o botão reticências (...) e, no Construtor de Expressões, substitua a expressão row["CREDITLIMIT"] pela expressão a seguir. Essa é a mesma expressão de ligação de coluna utilizada pelo elemento de dados no cabeçalho do grupo. Em vez de digitá-la novamente, você pode copiá-la do elemento de dados e colá-la aqui.
- Escolha OK.
- Visualize o relatório no visualizador de relatórios para verificar a alteração no índice.
O índice exibe os intervalos de limite de crédito, conforme mostrado na
Figura 8-18.
Figura 8-18 Índice atualizado


|