...
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. |
...
Para melhor exemplificar o uso do recurso, será criado um fluxo de uso a seguir, contendo o seguinte cenário:
O Conector usado, referente a um Provedor Nativo, possui os Objetos de Negócio: Funcionários e o Histórico de Férias desse funcionário, pertencentes à área "Simulação".
Os dados demonstrados, que serão usados para criação dos Relatórios, estão disponíveis no seguinte endereço:
Bloco de código | ||
---|---|---|
| ||
https://run.mocky.io/v3/bec2d116-8298-4ff5-93c2-24a340ed0901 |
Conforme a representação, as informações de férias no relatório principal de Funcionários, vêm de um sub-relatório de Histórico de Férias. Para chegar no resultado esperado, os Objetos de Negócio a serem usados se relacionam através do campo "Chapa", que será parametrizado e será responsável por fazer a relação entre o sub-relatório com o Funcionário listado pelo Relatório Principal.
O primeiro passo será criar o Relatório Principal, escolhendo o Objeto de Negócio Funcionários. O relatório será uma lista simples de Funcionários e não conta com a adição de Filtros ou Parâmetros.
O próximo passo será criar um segundo Relatório que será referenciado como um Sub-Relatório. Para ele, será configurado com o Objeto de Negócio Histórico de Férias.
Seguindo o Modelo de Relatório Final, os dados de Histórico de Férias (Sub-Relatório) serão trazidos para cada Funcionário da Lista de Funcionários (Relatório Principal). Para que isso aconteça, será usado o Filtro pelo Design do Relatório através da String de Filtro. Dessa forma a geração do sub-relatório acompanha cada linha gerada pelo Relatório Principal, assim, para cada Funcionário listado, será retornado Histórico de Férias referente a ele.
Adicionando o Parâmetro "pCHAPA" diretamente pelo Designer do Relatório, será adicionada a String de Filtro no relatório, condicionando campo CHAPA da Fonte de Dados com o Parâmetro "pCHAPA" criado:
Na geração individual desse Relatório, deve ser informado o valor dos parâmetros criado pelo Designer, resultando no relatório de Histórico de Férias referente ao Funcionário especificado:
...
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 Designer do Relatório Principal, será trazido para o Layout o Componente de Sub-Relatório, referenciando assim o relatório de Histórico de Férias:
Para passagem de parâmetros do relatório principal 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á aplicado da seguinte forma:
...