...
O objetivo deste documento é mostrar o funcionamento da ferramenta de sub-relatório, que será usada e 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 . Isso permite a criação de layouts complexos com diferentes partes em um único documento, sendo preenchido usando diferentes fontes de dados e relatórios.
Dica | ||
---|---|---|
| ||
Por se tratar de um relatório, o sub-relatório possui sua própria fonte de dados com seus filtros e/ou parâmetros. |
...
Nota |
---|
Ao definir o 'Nome' do componente, é alterado apenas a exibição do componente no layout do Designer e não irá refletir na Visualização/Geração do relatório. |
...
No exemplo Para melhor exemplificar o uso do recurso, será criado um fluxo de uso a seguir, contendo o seguinte cenário:
Será 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:
...
...
Para a criação do relatório principal 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 , quer 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, que será configurado posteriormente com o próprio Objeto de Negócio e Parâmetros para geração.
Nesse ponto, há duas formas de seguir com o Cadastro de um Relatório para que ele esteja disponível na lista do componente para ser usado como um Sub-Relatório.
Informações | ||||
---|---|---|---|---|
| ||||
Nesse caso, pela Listagem de Relatórios, o fluxo a seguir será conforme qualquer outra criação de Relatório, seguindo para a definição de Objeto de Negócio e Filtros e Configuração do Layout pelo Designer.
Para o Cadastro de Relatório através do Designer, após o duplo-clique no componente, será aberta uma nova aba no Designer completamente vazia, onde ao Salvar, será aberta uma guia para informar o nome do Novo 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 Para o Relatório criado para ser usado como Sub-Relatório, será configurado o Objeto de Negócio "Instalações por Versão", onde será criado também possui o Filtro da propriedade Aplicação como um ParâmentroParâmetro, para ser 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.
...
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 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.
Com a conclusão do Sub-Relatório, deve ser configurado o Componente de Sub-Relatórios, como o relatório a ser usado e o vínculo de Parâmetros com o Relatório Principal.
...
Informações | ||||
---|---|---|---|---|
| ||||
Para passar os parâmetros do relatório pai para o sub-relatório, deve ser definido um parâmetro no relatório que está sendo usado como sub-relatório. Ao inserir o sub-relatório no Relatório Principal, é possível selecionar o parâmetro do relatório e um valor que poderão ser passados do Relatório Principal para o parâmetro no sub-relatório. Para esse caso, será definido que:
|
...
|
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.
...
Informações | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
Há duas formas de seguir com o Cadastro de um Relatório para que ele seja disponibilizado na lista do componente para ser usado como um Sub-Relatório.
|
Informações |
---|
A aplicação conta com o Design de Relatórios da DevEx, para documentação sobre o uso de seus componentes, acesse: https://docs.devexpress.com/XtraReports/2162/reporting |
...