Adicionar um sub-relatório e parâmetros (Construtor de Relatórios e SSRS)
Adicione sub-relatórios a um relatório quando quiser criar um relatório principal que seja um contêiner para vários relatórios relacionados. Um sub-relatório é uma referência a outro relatório. Para relacionar os relatórios por valores de dados (por exemplo, para que diversos relatórios exibam dados para o mesmo cliente), é preciso criar um relatório com parâmetros (por exemplo, um relatório que exiba os detalhes de um cliente específico) como o sub-relatório. Ao adicionar um sub-relatório ao relatório principal, você também pode especificar os parâmetros que serão passados para o sub-relatório.
Também é possível adicionar sub-relatórios a linhas ou colunas dinâmicas em uma tabela ou matriz. Quando o relatório principal é processado, o sub-relatório é processado para cada linha. Nesse caso, analise se você pode obter o efeito desejado usando regiões de dados ou regiões de dados aninhados.
Para adicionar um sub-relatório a um relatório, crie primeiro o relatório que atuará como sub-relatório. Para obter mais informações sobre a criação de sub-relatórios, consulte Sub-relatórios (Construtor de Relatórios e SSRS).
![]() |
---|
Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Partes de Relatório (Construtor de Relatórios e SSRS) e Partes de Relatório no Designer de Relatórios (SSRS) na Web em microsoft.com. |
Para adicionar um sub-relatório
Na guia Inserir, clique em Sub-relatório.
Na superfície de design, clique em um local no relatório e arraste a caixa até obter o tamanho desejado para o sub-relatório. Se preferir, clique na superfície de design para criar um sub-relatório de tamanho padrão.
Clique com o botão direito do mouse no sub-relatório e clique em Propriedades do Sub-relatório.
Na caixa de diálogo Propriedades do Sub-relatório, digite um nome na caixa de texto Nome ou aceite o nome padrão. O nome deve ser exclusivo no relatório. Por padrão, um nome geral, como Subreport1 ou Subreport2, é atribuído.
Na caixa Usar este relatório como sub-relatório, clique em Procurar ou digite o nome do relatório. É preferível clicar em Procurar porque o caminho para o sub-relatório será especificado automaticamente. Você pode especificar o relatório de várias maneiras. Para obter mais informações, consulte Especificando caminhos para itens externos (Construtor de Relatórios e SSRS).
(Opcional) Clique em Sim para Omitir borda na quebra de página para impedir que uma borda seja renderizada no meio do sub-relatório caso o sub-relatório se expanda por mais de uma página.
Clique em OK.
Para especificar os parâmetros que serão passados para um sub-relatório
No modo Design, clique com o botão direito do mouse no sub-relatório e clique em Propriedades do Sub-relatório.
Na caixa de diálogo Propriedades do Sub-relatório, clique em Parâmetros.
Clique em Adicionar. Uma linha nova é adicionada à grade de parâmetros.
Na caixa de texto de Nome, digite o nome de um parâmetro no sub-relatório ou escolha-o na caixa de listagem. Esse nome deve corresponder a um parâmetro de relatório, não a um parâmetro de consulta, no sub-relatório.
Na caixa de listagem Valor, digite ou selecione um valor a ser passado para o sub-relatório. Esse valor pode ser um texto estático ou uma expressão que referencie um campo ou outro objeto no relatório principal.
Observação
No Construtor de Relatórios, se um parâmetro estiver ausente na lista Parâmetros, e se o sub-relatório tiver um valor padrão definido, o sub-relatório será processado corretamente.
No Designer de Relatórios, todos os parâmetros exigidos pelo sub-relatório devem estar incluídos na lista Parâmetros. Se estiver faltando um parâmetro obrigatório, o sub-relatório não será exibido corretamente no relatório principal.
Repita as etapas de 3 a 5 para especificar um nome e um valor para cada parâmetro do sub-relatório.
Para excluir um parâmetro de sub-relatório, clique no parâmetro na grade de parâmetros e clique em Excluir.
Para alterar a ordem de um parâmetro de sub-relatório, clique no parâmetro e clique no botão de seta para cima ou para baixo.
A alteração da ordem de um parâmetro de sub-relatório não afeta o processamento do sub-relatório.
Consulte também
Conceitos
Sub-relatórios (Construtor de Relatórios e SSRS)
Comportamentos de renderização (Construtor de Relatórios e SSRS)