Índice | ||||
---|---|---|---|---|
|
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.
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. |
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.
Informações |
---|
São listados na propriedade Relatório Fonte Url todos os relatórios aos quais o usuário logado possui permissão, sendo Proprietário, Editor ou Leitor do relatório em questão. |
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. |
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:
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.
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 |