Índice

Objetivo

       O objetivo deste documento é mostrar o funcionamento da ferramenta de sub-relatório, que será configurada diretamente no Designer do Relatório. 

       Um sub-relatório é definido como um relatório incluso em outro relatório, de forma que qualquer relatório pode ser usado como um sub-relatório, respeitando o acesso definido ao relatório individualmente.

       A inclusão de sub-relatórios permite a criação de layouts complexos com diferentes partes em um único documento, sendo preenchido usando diferentes fontes de dados e relatórios.

Adicionando o Componente Sub-Relatório

       O componente de Sub-Relatório se encontra na Barra de Controles na lateral esquerda e assim como os outros controles, o componente deve ser arrastado para o Layout para configuração.

       Na Barra de Propriedades, na lateral direita, é onde será configurado o Sub-Relatório, sendo na propriedade "Relatório Fonte Url" onde será selecionado o relatório a ser vinculado ao relatório principal como um Sub-Relatório.

Demonstração

     Para melhor exemplificar o uso do recurso, será criado um fluxo de uso a seguir, contendo o seguinte cenário:

     Será impresso um relatório contendo como modelo as Versões Publicadas do TReports como Relatório Principal, sendo exibida para cada versão, a Quantidade de Instalações realizadas, que será representado por um sub-relatório. Chegando ao seguinte layout esperado:
       

Associação do Sub-Relatório e Vínculo de Parâmetros

       Para a criação do Relatório Principal, será configurado o Objeto de Negócio "Histórico de Versões", aplicando um Filtro simples do campo Aplicação igual a um Parâmetro que será informado pelo usuário no momento da geração.

       No Designer, além dos campos do Objeto de Negócio, será também trazido para o Layout o Componente de Sub-Relatório, referenciando assim um relatório configurado com sua própria Fonte de Dados e seus Filtros/Parâmetros.

       Esse Relatório, referenciado como um sub-relatório, configurado com o Objeto de Negócio "Instalações por Versão", também possui o Filtro da propriedade Aplicação como um Parâmetro, que será vinculado também ao Filtro criado no Relatório Principal.

        Seguindo o Modelo de geração do Relatório Final, os dados de Quantidades de Instalações (Sub-Relatório), serão trazidos para cada Versão do Histórico de Versões (Relatório Principal), ou seja, para cada linha do Relatório Principal, será retornado o Sub-Relatório correspondente ao campo Versão do Relatório Principal.

       Sendo assim, além do Filtro criado para o Objeto de Negócio, para esse Relatório será configurada também uma Parametrização feita pelo Designer do Relatório, para que a geração do sub-relatório acompanhe cada variação no campo Versão trazida pelo Relatório Principal.

       Com o Parâmetro adicionado pelo Designer do Relatório, será adicionada a String de Filtro no relatório, vinculando a condição ao campo de versão da Fonte de Dados com o Parâmetro "Versão" criado:

Na geração individual desse Relatório, deverão ser informados os valores dos parâmetros criados pelo Designer e pelo Filtro do Objeto de Negócio, resultando no relatório de Quantidade de Instalações para a versão em específico.

       O relatório Final será gerado, sendo informado pelo usuário o Parâmetro de Aplicação, vinculado ao Parâmetro de Objeto de Negócio do Sub-Relatório, e o Parâmetro de Designer acompanha cada versão diferente retornada pelo Relatório Principal.

Adicionando um Sub-Relatório