Tutorial 3: Construindo um Relatório com Sub-relatórios Lado a Lado
Esta seção fornece instruções passo a passo para a construção de um relatório que exibe uma lista de clientes. Para cada cliente, o relatório exibe informações de pedido e de pagamento. As informações de pedido e de pagamento estão em sub-relatórios separados que aparecem próximos um do outro. O relatório de cliente é o relatório principal, que também é chamado de relatório externo e os sub-relatórios de pedido e de pagamento são os relatórios de detalhes, também chamados de relatórios internos.
Cada relatório acessa dados de uma tabela diferente no banco de dados de amostra, Modelos Clássicos. O relatório de cliente utiliza dados da tabela Clientes. O sub-relatório de pedidos utiliza dados da tabela Pedidos. O sub-relatório de pagamentos utiliza dados da tabela Pagamentos.
Um campo comum, CUSTOMERNUMBER, vincula os relatórios. O valor do campo de link no relatório principal determina quais dados aparecerão nos relatórios de detalhes. Por exemplo, se o número do cliente no relatório principal for 173, os relatórios de detalhes exibirão as informações de pedido e de pagamento do cliente cujo ID é 173.
A Figura 13-1 mostra uma parte do relatório concluído.
Figura 13-1 Relatório principal dos clientes com sub-relatórios de pedido e de pagamento
Neste tutorial, as seguintes tarefas serão executadas:
Tarefa 1: Criar um Novo Relatório
Se você estiver utilizando o Designer de Relatório BIRT, essa tarefa supõe que você já tenha criado um projeto para seus relatórios. Se estiver utilizando o Designer de Relatório RCP do BIRT, não há requisito para um projeto.
- Escolha Arquivo->Novo->Relatório.
- Em Novo Relatório, selecione um projeto no qual armazenar o relatório.
- Digite o seguinte texto como o nome do arquivo:
- Escolha Avançar.
- Selecione Relatório em Branco e escolha Concluir. O novo relatório aparece no editor de layout.
Tarefa 2: Construir uma Origem de Dados
Antes de começar a projetar seu relatório no editor de layout, crie uma origem de dados para conectar seu relatório ao banco de dados Modelos Clássicos.
- Escolha Explorador de Dados.
- Clique com o botão direito do mouse em Origens de Dados e escolha Nova Origem de Dados no menu de contexto.
- Selecione Banco de Dados de Amostra de Modelos Clássicos, Inc., na lista de origens de dados, utilize o nome da origem de dados padrão e, em seguida, 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.
Tarefa 3: Construir um Conjunto de Dados para o Relatório do Cliente
Neste procedimento, você construirá um conjunto de dados para indicar quais dados extrair da tabela Clientes. O relatório de cliente que será criado mais tarde utiliza esse conjunto de dados.
- No Explorador de Dados, clique com o botão direito do mouse em Conjuntos de Dados e escolha Novo Conjunto de Dados.
- Em Novo Conjunto de Dados, digite o seguinte texto para o nome do conjunto de dados:
- 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 especifica 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. A área de texto do lado direito mostra as palavras-chave obrigatórias de uma instrução SQL SELECT.
- Expanda a tabela CUSTOMERS. As colunas na tabela Clientes aparecem.
- Utilize a seguinte instrução SQL SELECT para indicar quais dados devem ser recuperados. Você pode digitar os nomes da coluna e da tabela ou pode arrastá-los do lado esquerdo para o local apropriado na instrução SELECT.
Essa instrução criada, mostrada na
Figura 13-2, recebe valores das colunas CUSTOMERNAME e CUSTOMERNUMBER na tabela CUSTOMERS.
Figura 13-2 Consulta
- 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 confirmar que a consulta seja válida e que retorne os dados corretos. Se a instrução SELECT tiver sido criada corretamente, você verá os resultados mostrados na Figura 13-3. Estas são as linhas de dados retornadas pela consulta.
Figura 13-3 Visualização de dados
- Escolha OK.
Tarefa 4: Construir um Conjunto de Dados para o Sub-relatório de Pedidos
Neste procedimento, você construirá um conjunto de dados para indicar quais dados extrair da tabela Pedidos. O sub-relatório de pedidos que será criado mais tarde utiliza esse conjunto de dados.
- 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, digite o seguinte texto para o nome do conjunto de dados:
- Utilize os valores padrão para os outros campos e, em seguida, escolha Avançar.
- Em Consulta, expanda a tabela Pedidos para exibir suas colunas.
- Utilize a seguinte instrução SQL SELECT para indicar quais dados devem ser recuperados:
Essa instrução seleciona as colunas ORDERNUMBER e ORDERDATE na tabela Pedidos. A cláusula WHERE tem um marcador de parâmetro para o valor de CUSTOMERNUMBER. Durante a execução do relatório, o sub-relatório de pedidos recebe o valor CUSTOMERNUMBER atual do relatório de clientes.
- 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.
- Crie um parâmetro de conjunto de dados para fornecer o valor CUSTOMERNUMBER na cláusula WHERE:
- Escolha Parâmetros no lado esquerdo da janela. Editar Conjunto de Dados exibe informações de parâmetros.
- Especifique os seguintes valores na primeira linha da tabela:
- Nome: CustID
- Tipo de Dados: Inteiro
- Direção: Entrada
- Valor padrão: 103
103 é um dos valores da coluna CUSTOMERNUMBER. Um valor padrão é necessário para que o Designer de Relatório BIRT execute a consulta para fins de teste.
Editar Conjunto de Dados deve assemelhar-se ao mostrado na
Figura 13-4.
Figura 13-4 Definição de parâmetro no sub-relatório de pedidos
- Escolha Visualizar Resultados para confirmar que a consulta seja válida e que retorne os dados corretos. Se a instrução SELECT e o parâmetro de conjunto de dados tiverem sido criados corretamente, você verá os resultados mostrados na Figura 13-5. Estas são as linhas de dados retornadas pela consulta para o cliente número 103.
Figura 13-5 Visualização de dados para o sub-relatório de pedidos
- Escolha OK para salvar as alterações no conjunto de dados.
Tarefa 5: Construir um Conjunto de Dados para o Sub-relatório de Pagamentos
Neste procedimento, você construirá um conjunto de dados para indicar quais dados extrair da tabela Pagamentos. O sub-relatório de pagamentos que será criado mais tarde utiliza esse conjunto de dados.
- 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, digite o seguinte texto para o nome do conjunto de dados:
- Utilize os valores padrão para os outros campos e, em seguida, escolha Avançar.
- Em Consulta, expanda a tabela Pagamentos para exibir suas colunas.
- Utilize a seguinte instrução SQL SELECT para indicar quais dados devem ser recuperados:
Essa instrução seleciona as colunas PAYMENTDATE, CHECKNUMBER e AMOUNT na tabela Pagamentos. A cláusula WHERE tem um marcador de parâmetro para o valor de CUSTOMERNUMBER. Durante a execução do relatório, o sub-relatório de pagamentos recebe o valor CUSTOMERNUMBER atual do relatório de clientes.
- 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.
- Crie um parâmetro de conjunto de dados para fornecer o valor CUSTOMERNUMBER para a cláusula WHERE:
- Escolha Parâmetros. Editar Conjunto de Dados exibe informações de parâmetros.
- Especifique os seguintes valores na primeira linha da tabela:
- Nome: CustID
- Tipo de Dados: Inteiro
- Direção: Entrada
- Valor padrão: 103
- Escolha Visualizar Resultados para confirmar que a consulta seja válida e que retorne os dados corretos. Se a instrução SELECT e o parâmetro de conjunto de dados tiverem sido criados corretamente, você verá os resultados mostrados na Figura 13-6. Estas são as linhas de dados retornadas pela consulta para o cliente número 103.
Figura 13-6 Visualização de dados para o sub-relatório de pagamentos
- Escolha OK para salvar as alterações no conjunto de dados.
Tarefa 6: Criar o Relatório Principal do Cliente
Você utilizará um elemento de lista para criar o relatório principal e organizar os sub-relatórios de pedidos e de pagamentos nele. A lista é repetida pelas linhas de dados do cliente e cria os sub-relatórios de pedidos e de pagamentos relacionados para cada registro. Para maior clareza, o relatório de cliente exibe apenas o nome do cliente. Ele pode, naturalmente, exibir dados adicionais, como endereço do cliente, número do telefone e limite de crédito.
- Escolha Paleta.
- Arraste um elemento de lista da paleta e solte-o no relatório. O elemento de lista aparece no relatório, conforme mostrado na Figura 13-7.
Figura 13-7 Elemento de lista
- Associar ou ligar a lista ao conjunto de dados de Clientes:
- Em Editor de Propriedades, escolha a guia Ligação.
- Para Conjunto de Dados, selecione Clientes na lista drop-down.
- Escolha 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 área de detalhe da lista. 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 lista exibe o campo incluído, conforme mostrado na Figura 13-8.
Figura 13-8 Campo de conjunto de dados no elemento de lista
- Escolha Visualizar para visualizar o relatório. O relatório deve assemelhar-se ao mostrado na Figura 13-9. O relatório lista todos os nomes de clientes na ordem em que são retornados pela consulta.
Figura 13-9 Visualização de dados do relatório principal
- Classifique os nomes dos clientes em ordem crescente:
- Escolha Layout para retornar ao editor de layout.
- No editor de layout, selecione o elemento de lista. Suspenda o ponteiro do mouse sobre o canto inferior esquerdo até vir a guia Lista e, em seguida, escolha a guia.
- Em Editor de Propriedades, escolha a guia Classificação.
- Na página Classificar, escolha Incluir para criar uma expressão de classificação. Aparece uma linha em Classificação ativa.
- Clique na área em Chave de Classificação e, em seguida, selecione o botão de seta que aparece e selecione CUSTOMERNAME na lista drop-down.
- Utilize o valor padrão, Crescente, para Direção de Classificação, conforme mostrado na Figura 13-10.
Figura 13-10 Expressão de classificação
- Visualize o relatório. Os nomes dos clientes aparecem em ordem crescente.
Tarefa 7: Criar o Sub-relatório de Pedidos
O sub-relatório de pedidos lista os pedidos de cada cliente em um formato de linha e coluna. Ele exibe o número e a data de cada pedido. Para repetir pelas linhas do conjunto de dados de pedidos e exibi-los em formato de linha e coluna, utilize o elemento de tabela.
- Escolha Layout para retornar ao editor de layout.
- Arraste um elemento de tabela da paleta e solte-o abaixo do elemento de dados [CUSTOMERNAME], na área de detalhe. Inserir Tabela solicita a especificação do número de colunas e linhas de detalhes a serem criados para a tabela.
- Indique que deseja criar duas colunas e uma linha de detalhe e, em seguida, escolha OK. Aparecerá uma tabela com duas colunas e uma linha de detalhe no editor de layout.
- Ligue a tabela com o conjunto de dados de Pedidos:
- Em Editor de Propriedades, escolha Ligação.
- Para Conjunto de Dados, selecione Pedidos na lista drop-down.
- Escolha Explorador de Dados, expanda Conjuntos de Dados e, em seguida, expanda Pedidos. As colunas especificadas na consulta aparecem abaixo de Pedidos.
- Arraste ORDERNUMBER a partir do Explorador de Dados e solte-o na primeira célula da linha de detalhe 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 exibe essa ligação de coluna.
- Escolha OK para aceitar a ligação de coluna padrão.
No editor de layout, a célula da tabela na qual você soltou o campo de conjunto de dados contém um elemento de dados que exibe [ORDERNUMBER]. 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 e serve como título da coluna.
- Arraste ORDERDATE 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 coluna padrão. A página de relatório deve assemelhar-se à mostrada na Figura 13-11.
Figura 13-11 Design de relatório incluindo o sub-relatório de pedidos
- Classifique as linhas do pedido por ordem numérica:
- Selecione a tabela de pedidos.
- Em Editor de Propriedades, escolha Classificação.
- Na página Classificar, escolha Incluir para criar uma expressão de classificação. Aparece uma linha em Classificação ativa.
- Clique na área em Chave de Classificação e, em seguida, selecione o botão de seta que aparece e selecione ORDERNUMBER na lista drop-down.
- Utilize o valor padrão, Crescente, para Direção de Classificação.
- Visualize o relatório.
Figura 13-12 Visualização do relatório mostrando registros de pedidos repetidos
Os mesmos registros de pedidos aparecem para cada cliente porque você especificou um valor padrão de 103 para customerNumber quando criou o parâmetro de conjunto de dados CustID. Por causa desse valor padrão, o sub-relatório de pedidos sempre exibe os registros de pedidos para o cliente 103.
A solução é atualizar dinamicamente o valor do parâmetro CustID sempre que a linha de cliente no relatório principal é alterada. Este procedimento é descrito na tarefa a seguir.
Tarefa 8: Vincular o Sub-relatório de Pedidos ao Relatório Principal de Clientes
Você vinculará o sub-relatório de pedidos ao relatório principal de clientes ligando o parâmetro CustID ao campo de conjunto de dados CUSTOMERNUMBER no relatório de clientes. Sempre que o relatório de clientes atinge uma nova linha do cliente, o parâmetro CustID é atualizado com o novo valor CUSTOMERNUMBER.
Antes de ligar o parâmetro CustID ao campo de conjunto de dados CUSTOMERNUMBER, você deve criar uma ligação de coluna e ligá-la ao campo de conjunto de dados. Os parâmetros não podem acessar os campos de conjuntos de dados diretamente.
- Escolha Layout para retornar ao editor de layout.
- Crie uma ligação de coluna que ligue ao campo de conjunto de dados CUSTOMERNUMBER:
- Selecione a lista.
- Em Editor de Propriedades, escolha Ligação.
- Na página Ligação, escolha Incluir.
- Em Construtor de Expressões, escolha Conjuntos de Dados Disponíveis, selecione Clientes e, em seguida, dê um clique duplo em CUSTOMERNUMBER. O Construtor de Expressões exibe a expressão dataSetRow["CUSTOMERNUMBER"], conforme mostrado na Figura 13-13.
Figura 13-13 Construtor de Expressões mostrando a expressão de ligação da coluna
- 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:
- Selecione a tabela de pedidos.
- Em Editor de Propriedades, escolha Ligação.
- Na página Ligação, escolha Ligação de Parâmetros do Conjunto de Dados. A Ligação de Parâmetros do Conjunto de Dados exibe o parâmetro CustID, conforme mostrado na Figura 13-14. Seu valor é configurado com o padrão 103, especificado durante a criação do parâmetro de conjunto de dados.
Figura 13-14 Ligação de Parâmetros do Conjunto de Dados da tabela de pedidos
- Altere o valor do parâmetro para o campo CUSTOMERNUMBER no relatório de clientes:
- Clique no campo Valor e, em seguida, escolha o botão que aparece à direita.
Aparece o Construtor de Expressões.
- Em Construtor de Expressões, escolha Ligações de Colunas Disponíveis, selecione Lista e, em seguida, dê um clique duplo em CUSTOMER_NUMBER. O Construtor de Expressões exibe a expressão row["CUSTOMER_NUMBER"], conforme mostrado na Figura 13-15.
Figura 13-15 Campo CUSTOMERNUMBER no Construtor de Expressões
- Escolha OK para salvar a expressão. A página Ligação de Parâmetros do Conjunto de Dados exibe o novo valor de row["CUSTOMER_NUMBER"] para o parâmetro CustID.
- Escolha OK para salvar a ligação de parâmetros de conjunto de dados alterada.
- Visualize o relatório, que deve assemelhar-se ao mostrada na Figura 13-16.
Figura 13-16 Visualização do relatório mostrando dados de pedidos corretos
Tarefa 9: Criar o Sub-relatório de Pagamentos
O sub-relatório de pagamentos mostra, em um formato de linha e coluna, os pagamentos feitos pelos clientes. Ele exibe a data do pagamento, o número do cheque e o valor de cada pedido. Para repetir pelas linhas do conjunto de dados de pagamentos e exibi-los em formato de linha e coluna, utilize o elemento de tabela.
- Escolha Layout para retornar ao editor de layout.
- Arraste um elemento de tabela da paleta e solte-o abaixo do sub-relatório de pedidos, na área de detalhe. Inserir Tabela solicita a especificação do número de colunas e linhas de detalhes a serem criados para a tabela.
- Indique que deseja criar 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.
- Ligue a tabela com o conjunto de dados de Pagamentos:
- Em Editor de Propriedades, escolha Ligação.
- Para Conjunto de Dados, selecione Pagamentos na lista drop-down.
- Escolha Explorador de Dados, expanda Conjuntos de Dados e, em seguida, expanda Pagamentos. As colunas especificadas na consulta aparecem abaixo de Pagamentos.
- Arraste os seguintes campos a partir do Explorador de Dados e solte-os na primeira, na segunda e na terceira células, respectivamente, na linha de detalhe da tabela. Escolha OK para aceitar as ligações de colunas padrão para todos os campos.
- PAYMENTDATE
- CHECKNUMBER
- AMOUNT
A página de relatório deve assemelhar-se à mostrada na
Figura 13-17.
Figura 13-17 Design de relatório incluindo o sub-relatório de pagamentos
A tabela mostra os campos de conjuntos de dados incluídos. Ela também mostra as etiquetas incluídas automaticamente pelo editor de layout na linha de cabeçalho. As etiquetas exibem os nomes de campos como texto estático e servem como títulos de colunas.
- Classifique as linhas de pagamento por data de pagamento.
- Selecione a tabela de pagamentos.
- Em Editor de Propriedades, escolha Classificação.
- Na página Classificação, escolha Incluir para criar uma expressão de classificação. Aparece uma linha em Classificação ativa.
- Clique em Chave de Classificação, escolha o botão de seta que aparece e selecione PAYMENTDATE na lista drop-down.
- Utilize o valor padrão, Crescente, para Direção de Classificação.
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 13-18.
Figura 13-18 Visualização do relatório mostrando relatórios de pagamentos repetidos
Assim como com o sub-relatório de pedidos criado pela primeira vez, os mesmos registros de pagamentos são repetidos para cada cliente porque você especificou um valor padrão de 103 para customerNumber quando criou o parâmetro CustID do conjunto de dados de Pagamentos. Por causa desse valor padrão, o sub-relatório de pagamentos sempre exibe os registros de pagamentos para o cliente 103.
Assim como você fez para o sub-relatório de pedidos, é necessário atualizar dinamicamente o valor do parâmetro CustID para cada cliente do relatório principal.
Tarefa 10: Vincular o Sub-relatório de Pagamentos ao Relatório Principal de Clientes
Você vinculará o sub-relatório de pagamentos ao relatório principal de clientes ligando seu parâmetro CustID ao campo CUSTOMERNUMBER no relatório de clientes.
- Escolha Layout para retornar ao editor de layout.
- Selecione a tabela de pagamentos.
- Em Editor de Propriedades, escolha a guia Ligação.
- Na página Ligação, escolha Ligação de Parâmetros do Conjunto de Dados. A Ligação de Parâmetros do Conjunto de Dados exibe o parâmetro CustID. Seu valor é configurado com o padrão 103, especificado durante a criação do parâmetro de conjunto de dados.
- Altere o valor do parâmetro para o campo CUSTOMERNUMBER no relatório de clientes:
- Clique no campo Valor e, em seguida, escolha o botão que aparece à direita.
- Em Construtor de Expressões, escolha Ligações de Colunas Disponíveis, selecione Lista e, em seguida, dê um clique duplo em CUSTOMER_NUMBER. O Construtor de Expressões exibe a expressão row["CUSTOMER_NUMBER"].
- Escolha OK para salvar a expressão. A página Ligação de Parâmetros do Conjunto de Dados exibe o novo valor de row["CUSTOMER_NUMBER"] para o parâmetro CustID.
- Escolha OK para salvar a ligação de parâmetros de conjunto de dados alterada.
- Visualize o relatório. Agora o relatório exibe registros de pagamentos diferentes para clientes diferentes. Nem todos os clientes possuem registros de pagamentos. Para exibir somente os clientes que possuem pagamentos ou pedidos, altere a consulta do relatório de clientes.
Tarefa 11: Exibir Somente Clientes que Possuem Pedidos ou Pagamentos
O banco de dados contém clientes que não possuem pedidos ou pagamentos. A consulta do relatório de clientes retorna todos os clientes. Ao executar o relatório, há linhas de clientes que mostram somente os títulos de colunas das tabelas de pedidos e de pagamentos, conforme mostrado na Figura 13-19.
Figura 13-19 Relatório mostrando pedido ou pagamento sem dados para um cliente
É possível excluir os clientes que não possuem pedidos ou pagamentos alterando a consulta do relatório de clientes.
- Escolha Layout para retornar ao editor de layout.
- No Explorador de Dados, expanda Conjuntos de Dados, clique com o botão direito do mouse em Clientes e, em seguida, escolha Editar.
- Inclua as seguintes linhas SQL no final da consulta existente:
A cláusula WHERE EXISTS verifica se nas tabelas Pedidos e Pagamentos há valores customerNumber que correspondam a valores customerNumber na tabela Clientes. Apenas as linhas que possuam valores customerNumber correspondentes são selecionadas. A consulta completa deve assemelhar-se à mostrada na
Figura 13-20.
Figura 13-20 Cláusula WHERE EXISTS em Editar Conjunto de Dados
- Escolha Visualizar Resultados para verificar se a consulta retorna linhas e, em seguida, escolha OK.
- Visualize o relatório. Role para baixo no relatório para verificar a saída. O relatório não exibe mais os clientes que não possuem pedidos ou pagamentos.
Tarefa 12: Exibir os Sub-relatórios Lado a Lado
Agora que os sub-relatórios exibem os dados corretos, você poderá concentrar-se na definição do layout dos sub-relatórios lado a lado. Não é possível colocar duas tabelas uma próxima da outra, porque o Designer de Relatório BIRT cria elementos no nível de bloco, o que significa que cada elemento é iniciado em uma nova linha. Para exibir as tabelas lado a lado, insira-as em uma grade. A grade permite alinhar elementos com facilidade.
- Escolha Layout para retornar ao editor de layout.
- Arraste um elemento de grade da paleta e solte-o na linha de Detalhe acima da tabelas de pedidos. Inserir Grade solicita a especificação do número de colunas e linhas para a grade.
- Em Número de colunas, digite 2 e, em Número de linhas, digite 1 e, em seguida, escolha OK.
Aparecerá uma grade com duas colunas e uma linha no editor de layout.
- Mova a tabela de pedidos para a primeira célula da grade. Para isso, selecione a guia Tabela no canto inferior esquerdo e, em seguida, arraste a tabela e solte-a na célula da grade.
- Mova a tabela de pagamentos para a segunda célula da grade. O layout do relatório deve assemelhar-se ao mostrado na Figura 13-21.
Figura 13-21 Sub-relatórios lado a lado no design de relatório
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 13-22.
Figura 13-22 Visualização do relatório mostrando sub-relatórios lado a lado
Tarefa 13: Formatar o Relatório
Agora que o relatório exibe os dados e o layout corretos, você poderá concentrar-se no aperfeiçoamento da aparência do relatório. As seguintes tarefas serão executadas nesta seção:
Realçar os Nomes dos Clientes
- Escolha Layout para retornar ao editor de layout.
- No editor de layout, selecione o elemento de dados [CUSTOMERNAME].
- Escolha a guia Propriedades do Editor de Propriedades.
- Selecione Geral na lista, em Propriedades. O Editor de Propriedades exibe as propriedades gerais de formatação do elemento de dados.
- Para Tamanho, escolha Grande para exibir o texto do elemento em um tamanho maior. O texto aumenta de tamanho.
- Escolha B para formatar os dados como texto em negrito. Os dados aparecem em negrito.
Editar os Títulos das Colunas
Quando você insere um campo de conjunto de dados em uma tabela, o Designer de Relatório BIRT inclui automaticamente uma etiqueta com o nome do campo de conjunto de dados na linha de cabeçalho. Muitas vezes, os nomes de campos do conjunto de dados não apresentam uma forma apropriada para relatórios e precisam ser alterados.
- Dê um clique duplo no título da primeira coluna na tabela de pedidos. O texto é realçado.
- Substitua ORDERNUMBER pelo seguinte texto e, em seguida, pressione Enter:
- Repita as etapas anteriores para alterar o restante dos títulos de colunas para o seguinte texto:
O layout do relatório deve assemelhar-se ao mostrado na
Figura 13-23.
Figura 13-23 Títulos de colunas editados no design de relatório
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 13-24.
Figura 13-24 Títulos de colunas editados na visualização do relatório
Alterar os Formatos de Data
Quando você insere um elemento de dados do tipo de dados de data, o Designer de Relatório BIRT exibe as datas de acordo com a configuração de código do idioma do sistema. O Designer de Relatório BIRT fornece vários formatos de data diferentes que poderão ser selecionados se você não quiser utilizar o formato padrão. Neste procedimento, você criará um estilo que altera o formato dos valores ORDERDATE e PAYMENTDATE de 3 de jun de 2005, 12h, para 3/6/05.
- Escolha Layout para retornar ao editor de layout.
- Selecione o elemento de dados que exibe [ORDERDATE].
- Escolha Elemento->Novo Estilo no menu principal. Novo Estilo exibe as propriedades que podem ser configuradas para um estilo, conforme mostrado na Figura 13-25.
Figura 13-25 Novo Estilo
- Para Estilo Customizado, digite:
- Escolha Formato Data e Hora na lista de propriedades de estilo à esquerda.
- Escolha o formato m/d/aa na lista drop-down. Os valores da lista drop-down são atualizados dinamicamente com a data atual.
- Escolha OK.
O estilo Dados_data é aplicado ao elemento de dados [ORDERDATE], conforme mostrado na
Figura 13-26.
Figura 13-26 Estilo Dados_data aplicado a um elemento de dados
- Aplique o estilo Dados_data ao elemento de dados de data de pagamento.
- Selecione o elemento de dados que exibe [PAYMENTDATE], conforme mostrado na Figura 13-27.
Figura 13-27 O elemento [PAYMENTDATE] selecionado
- Clique com o botão direito do mouse no elemento selecionado e, em seguida, escolha Estilo->Aplicar Estilo->Dados_data.
- Visualize o relatório. As datas foram alteradas do formato 3 de jun de 2005, 12h, para 3/6/05.
Alterar os Formatos de Número
Quando você insere um elemento de dados do tipo de dados inteiro, o Designer de Relatório BIRT exibe os números de acordo com a configuração de código do idioma do sistema. O Designer de Relatório BIRT fornece vários formatos numéricos diferentes que poderão ser selecionados se você não quiser utilizar o formato padrão. Neste procedimento, você criará um estilo que altera o formato dos valores de 48425,69 para $48.425,69.
- Escolha Layout para retornar ao editor de layout.
- Selecione o elemento de dados que exibe [AMOUNT] na tabela de pagamentos.
- Escolha Elemento->Novo Estilo no menu principal. Novo Estilo exibe as propriedades na categoria geral.
- Para Estilo Customizado, digite:
- Escolha Formato Numérico na lista de propriedades de estilo à esquerda.
- Especifique os atributos de formatação a seguir, conforme mostrado na Figura 13-28:
- Para Formatar Número como, selecione Moeda na lista drop-down.
- Para Casas decimais, utilize o valor padrão 2.
- Selecione Utilizar separador 1000s.
- Para Símbolo, selecione $ na lista drop-down.
- Utilize os valores padrão para os outros atributos.
Figura 13-28 Propriedades de Formatar Número
- Escolha OK. O estilo Dados_moeda é aplicado ao elemento de dados [AMOUNT], conforme indicado pela propriedade Estilo do elemento em Editor de Propriedades.
- Visualize o relatório. Os números aparecem no formato de moeda, conforme mostrado na Figura 13-29.
Figura 13-29 Formato de moeda na visualização do relatório
Aumentar o Espaço Vertical entre Elementos
Neste procedimento, você aumentará o espaço entre o nome do cliente e as linhas que antecedem e precedem o nome. Você pode ajustar o espaço vertical entre os elementos de várias maneiras:
- Pode aumentar o preenchimento ou as margens superior ou inferior dos elementos.
- Pode organizar os elementos em uma grade e ajustar as alturas das linhas da grade.
- Pode organizar os elementos em uma grade e utilizar linhas vazias com alturas especificadas para fornecer espaço entre os elementos.
A formatação com uma grade é mais fácil e fornece resultados mais previsíveis. Os valores das propriedades de preenchimento e de margens podem produzir resultados diferentes em navegadores da Web diferentes. Neste procedimento, você utilizará o terceiro método.
- Escolha Layout para retornar ao editor de layout.
- Coloque o elemento de dados [CUSTOMERNAME] na grade que contém as duas tabelas, concluindo as seguintes etapas:
- Selecione a grade. Suspenda o ponteiro do mouse sobre o canto inferior esquerdo até vir a guia Grade e, em seguida, escolha a guia. Células-guia aparecem nos lados superior e esquerdo da grade selecionada.
O editor de layout mostra as molduras de elementos de dados, grades, tabelas e células individuais e pode ser difícil, às vezes, ver onde um elemento foi colocado. Se precisar de uma visualização mais clara dos contêineres e de seus elementos, utilize a visualização de Tópicos para obter uma visualização em árvore do design de relatório. Também é possível utilizar a visualização de Tópicos para selecionar um determinado elemento se for muito difícil de selecioná-lo. Por exemplo, pode ser difícil selecionar a grade em vez da tabela dentro da grade. Para abrir a visualização de Tópicos, escolha Janela->Mostrar Visualização->Esboço.
- Clique com o botão direito do mouse na célula-guia à esquerda da primeira linha da grade e, em seguida, escolha Inserir->Linha->Acima, conforme mostrado na Figura 13-30.
Figura 13-30 Inserido uma nova linha
Aparece uma nova linha acima da linha selecionada.
- Mova o elemento de dados [CUSTOMERNAME] de seu local atual para a primeira célula da nova linha de grade, conforme mostrado na Figura 13-31.
Figura 13-31 Elemento de dados movido para a nova linha
- Inclua uma nova linha de grade acima e abaixo da linha que contém o elemento de dados [CUSTOMERNAME] utilizando os procedimentos descritos até agora.
- Selecione a grade e, em seguida, selecione sua primeira linha, conforme mostrado na Figura 13-32.
Figura 13-32 Selecionando a primeira linha
- Nas Propriedades Gerais do Editor de Propriedades, configure a altura da linha para 0,2 pol., conforme mostrado na Figura 13-33.
Figura 13-33 Configurando a propriedade de altura da linha
- Selecione a terceira linha da grade e configure sua altura para 0,1 pol. O design de relatório deve assemelhar-se ao mostrado na Figura 13-34.
Figura 13-34 Novas alturas de linhas no design de relatório
- Visualize o relatório. Há mais espaço acima e abaixo do nome do cliente. O relatório deve assemelhar-se ao mostrado na Figura 13-35.
Figura 13-35 Visualização do relatório mostrando espaço incluído
Aumentar o Espaço Horizontal entre as Tabelas de Pedidos e de Pagamentos
Neste procedimento, você aumentará o espaço entre a tabela de pedidos e de pagamentos. Como com o espaçamento vertical, você pode ajustar o espaço horizontal entre os elementos de várias maneiras:
- Pode aumentar o preenchimento ou as margens esquerda ou direita dos elementos.
- Pode organizar os elementos em uma grade e ajustar as larguras das colunas da grade.
- Pode organizar os elementos em uma grade e utilizar colunas vazias com larguras especificadas para fornecer espaço entre os elementos.
Novamente, a formatação com uma grade é mais fácil e fornece resultados mais previsíveis. Os valores das propriedades de preenchimento e de margens podem produzir resultados diferentes em navegadores da Web diferentes. Neste procedimento, você utilizará o terceiro método.
- Escolha Layout para retornar ao editor de layout.
- Selecione a grade. Suspenda o ponteiro do mouse sobre o canto inferior esquerdo até vir a guia Grade e, em seguida, escolha a guia. Células-guia aparecem nos lados superior e esquerdo da grade selecionada.
- Clique com o botão direito do mouse na célula-guia acima da primeira coluna e, em seguida, escolha Inserir->Coluna à Direita, conforme mostrado na Figura 13-36.
Figura 13-36 Inserindo uma coluna
Uma nova coluna aparece entre a primeira e a terceira colunas. Por padrão, o Designer de Relatório BIRT cria colunas com as mesmas larguras.
- Selecione a coluna recém-incluída e utilize o Editor de Propriedades para configurar sua largura para 0,4 pol., conforme mostrado na Figura 13-37.
Figura 13-37 Configurando uma largura de coluna
A largura da segunda coluna diminui.
- Visualize o relatório.
Há mais espaço entre as tabelas de pedidos e de pagamentos, conforme mostrado na
Figura 13-38.
Figura 13-38 Visualização do relatório mostrando espaço incluído entre as tabelas
Incluir Molduras em torno das Tabelas
Neste procedimento, você incluirá uma caixa em torno das tabelas de pedidos e de pagamentos para identificá-las claramente como dois sub-relatórios separados.
- Escolha Layout para retornar ao editor de layout.
- Selecione a tabela de pedidos.Suspenda o ponteiro do mouse sobre o canto inferior esquerdo até vir a guia Tabela e, em seguida, escolha a guia. Células-guia aparecem nos lados superior e esquerdo da tabela selecionada.
- Escolha Moldura no Editor de Propriedades e, em seguida, configure as propriedades da moldura:
- Configure Estilo com uma linha sólida.
- Escolha todos os botões para incluir molduras em torno da tabela, conforme mostrado na Figura 13-39.
Figura 13-39 Incluindo molduras em uma tabela
- Repita as etapas anteriores para desenhar uma moldura em torno da tabela de pagamentos.
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 13-40.
Figura 13-40 Molduras em torno das tabelas na visualização do relatório
Aumentar o Espaço entre as Molduras da Tabela e o Conteúdo
As molduras superior e esquerda das tabelas estão muito próximas do conteúdo da tabela. Neste procedimento, você aumentará o espaço entre as molduras superior e esquerda e o conteúdo.
- Escolha Layout para retornar ao editor de layout.
- Selecione a primeira célula na linha de cabeçalho do grupo da tabela de pedidos. Tenha cuidado ao selecionar a célula, conforme mostrado na Figura 13-41, e não seu elemento de dados.
Figura 13-41 Selecionando uma célula
O título que aparece no Editor de Propriedades mostra o nome do elemento selecionado. Verifique se ele exibe o seguinte texto:
- Escolha as Propriedades de Preenchimento no Editor de Propriedades e, em seguida, configure Superior e Esquerda para 6 pontos.
Figura 13-42 Propriedades de preenchimento da célula no Editor de Propriedades
No editor de layout, aparece espaço extra nas partes superior e esquerda da célula, conforme mostrado na
Figura 13-43.
Figura 13-43 Preenchimento da célula no design de relatório
- Selecione a célula ao lado da célula recém-formatada e configure suas propriedades de preenchimento das partes Superior e Esquerda para 6 pontos.
- Selecione as duas células da linha de detalhe e configure a propriedade de preenchimento do lado Esquerdo para 6 pontos.
- Selecione as células que estão nas mesmas posições na tabela de pagamentos e aplique as mesmas configurações utilizadas para elas na tabela de pedidos.
- Visualize o relatório. O relatório deve assemelhar-se ao mostrado na Figura 13-44.
Figura 13-44 Visualização do relatório mostrando mais espaço dentro das tabelas


|