Compartilhar via


Adicionar parâmetros em cascata a um relatório paginado (Construtor de Relatórios)

Aplica-se a: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer no SQL Server Data Tools

Os parâmetros em cascata fornecem uma maneira de gerenciar grandes quantidades de dados em um relatório paginado. É possível definir um conjunto de parâmetros relacionados de forma que a lista de valores de um parâmetro dependa do valor escolhido em outro parâmetro. Por exemplo, o primeiro parâmetro é independente e pode apresentar uma lista de categorias de produtos. Quando o usuário seleciona uma categoria, o segundo parâmetro é dependente do valor do primeiro parâmetro. Seus valores são atualizados com uma lista de subcategorias dentro da categoria escolhida. Quando o usuário exibe o relatório, os valores dos dois parâmetros de categoria e subcategoria são usados para filtrar dados do relatório.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Para criar parâmetros em cascata, primeiro você define a consulta de conjunto de dados e inclui um parâmetro de consulta para cada parâmetro em cascata necessário. Você também deve criar um conjunto de dados separado para cada parâmetro em cascata para fornecer valores disponíveis. Para obter mais informações, confira Adicionar, alterar ou excluir os valores disponíveis de um parâmetro de relatório (Construtor de Relatórios).

A ordem é importante para parâmetros em cascata porque a consulta do conjunto de dados para um parâmetro posterior na lista inclui uma referência a cada parâmetro anterior na lista. Em tempo de execução, a ordem dos parâmetros no painel de dados do relatório determina a ordem na qual as consultas de parâmetro aparecem no relatório. Portanto, a ordem em que um usuário escolhe cada valor de parâmetro sucessivo.

Para obter informações sobre como criar parâmetros em cascata com diversos valores e o recurso Selecionar Tudo, consulte Como ter um parâmetro em cascata de diversos valores com selecionar tudo.

  1. No painel Dados do Relatório, clique com o botão direito do mouse em uma fonte de dados e selecione Adicionar Conjunto de Dados.

  2. Em Nome, digite o nome do conjunto de dados.

  3. Em Fonte de Dados, escolha o nome da fonte de dados ou selecione Nova para criar uma.

  4. Em Tipo de consulta, escolha o tipo de consulta para a fonte de dados selecionada. Neste artigo, o tipo de consulta Text é assumido.

  5. Em Consulta, digite a consulta a ser usada para recuperar dados para este relatório. A consulta deve incluir as seguintes partes:

    1. Uma lista de campos de fonte de dados. Por exemplo, em uma instrução Transact-SQL, a instrução SELECT especifica uma lista de nomes de colunas do banco de dados de uma determinada tabela ou exibição.

    2. Um parâmetro de consulta para cada parâmetro em cascata. Um parâmetro de consulta limita os dados recuperados da fonte de dados especificando determinados valores a serem incluídos ou excluídos da consulta. Normalmente, parâmetros de consulta ocorrem em uma cláusula de restrição na consulta. Por exemplo, em uma instrução SELECT do Transact-SQL, os parâmetros de consulta ocorrem na cláusula WHERE.

  6. Selecione Executar (!). Depois que você incluir parâmetros de consulta e executar a consulta, os parâmetros do relatório que correspondem aos parâmetros da consulta serão criados automaticamente.

    Observação

    A ordem dos parâmetros de consulta na primeira vez que você executa uma consulta determina a ordem como eles são criados no relatório. Para alterar a ordem, confira Alterar a ordem de um parâmetro de relatório (Construtor de Relatórios)

  7. Selecione OK.

Em seguida, você cria um conjunto de dados que fornece os valores para o parâmetro independente.

Criar um conjunto de dados para fornecer valores para um parâmetro independente

  1. No painel Dados do Relatório, clique com o botão direito do mouse em uma fonte de dados e selecione Adicionar Conjunto de Dados.

  2. Em Nome, digite o nome do conjunto de dados.

  3. Em Fonte de Dados, verifique se o nome é o nome da fonte de dados escolhida na etapa 1.

  4. Em Tipo de consulta, escolha o tipo de consulta para a fonte de dados selecionada. Neste artigo, o tipo de consulta Text é assumido.

  5. Em Consulta, digite a consulta a ser usada para recuperar valores para este parâmetro. Normalmente, consultas de parâmetros independentes não contêm parâmetros de consulta. Por exemplo, para criar uma consulta para um parâmetro que fornece todos os valores de categoria, você pode usar uma instrução Transact-SQL semelhante ao seguinte bloco:

    SELECT DISTINCT <column name> FROM <table>  
    

    O comando SELECT DISTINCT remove valores duplicados do conjunto de resultados para que você obtenha cada valor exclusivo da coluna especificada na tabela especificada.

    Selecione Executar (!). O conjunto de resultados mostra os valores que estão disponíveis para esse primeiro parâmetro.

  6. Selecione OK.

Em seguida, você define as propriedades do primeiro parâmetro para usar este conjunto de dados para popular seus valores disponíveis em tempo de execução.

Definir os valores disponíveis para um parâmetro de relatório

  1. No painel Dados do Relatório, na pasta Parâmetros, clique com o botão direito do mouse no primeiro parâmetro e selecione Propriedades do Parâmetro.

  2. Em Nome, verifique se o nome do parâmetro está correto.

  3. Selecione Valores Disponíveis.

  4. Selecione Obter valores de uma consulta. Três campos são exibidos.

  5. Em Conjunto de Dados, na lista, selecione o nome do conjunto de dados criado no procedimento anterior.

  6. No campo Valor, selecione o nome do campo que fornece o valor do parâmetro.

  7. No campo Rótulo, selecione o nome do campo que fornece o rótulo do parâmetro.

  8. Selecione OK.

Em seguida, você cria um conjunto de dados que fornece os valores para um parâmetro dependente.

Criar um conjunto de dados para fornecer valores para um parâmetro dependente

  1. No painel Dados do Relatório, clique com o botão direito do mouse em uma fonte de dados e selecione Adicionar Conjunto de Dados.

  2. Em Nome, digite o nome do conjunto de dados.

  3. Em Fonte de Dados, verifique se o nome é o nome da fonte de dados escolhida na etapa 1.

  4. Em Tipo de consulta, escolha o tipo de consulta para a fonte de dados selecionada. Neste artigo, o tipo de consulta Text é assumido.

  5. Em Consulta, digite a consulta a ser usada para recuperar valores para este parâmetro. Normalmente, consultas para parâmetros dependentes incluem parâmetros de consulta para cada parâmetro do qual este parâmetro é dependente. Por exemplo, é possível criar uma consulta para um parâmetro que fornece todos os valores de subcategoria (parâmetro dependente) para uma categoria (parâmetro independente). Para fazer isso, você pode usar uma instrução Transact-SQL semelhante ao seguinte bloco:

    SELECT DISTINCT Subcategory FROM <table>   
    WHERE (Category = @Category)  
    

    Na cláusula WHERE, Category é o nome de um campo de <table> e @Category é um parâmetro de consulta. Essa instrução gera uma lista de subcategorias para a categoria especificada em @Category. Em tempo de execução, esse valor é preenchido com o valor escolhido pelo usuário para o parâmetro de relatório que tem o mesmo nome.

  6. Selecione OK.

Em seguida, você define as propriedades do segundo parâmetro para usar este conjunto de dados para popular seus valores disponíveis em tempo de execução.

Definir os valores disponíveis para o segundo parâmetro

  1. No painel Dados do Relatório, na pasta Parâmetros, clique com o botão direito do mouse no primeiro parâmetro e selecione Propriedades do Parâmetro.

  2. Em Nome, verifique se o nome do parâmetro está correto.

  3. Selecione Valores Disponíveis.

  4. Selecione Obter valores de uma consulta.

  5. Em Conjunto de Dados, na lista, selecione o nome do conjunto de dados criado no procedimento anterior.

  6. No campo Valor, selecione o nome do campo que fornece o valor do parâmetro.

  7. No campo Rótulo, selecione o nome do campo que fornece o rótulo do parâmetro.

  8. Selecione OK.

Testar os parâmetros em cascata

  1. Selecione Executar.

  2. Na lista do primeiro parâmetro independente, escolha um valor.

    O processador de relatório executa a consulta de conjunto de dados para o próximo parâmetro e passa para ele o valor que você escolheu para o primeiro parâmetro. A lista do segundo parâmetro é populada com os valores disponíveis com base no valor do primeiro parâmetro.

  3. Na lista do segundo parâmetro dependente, escolha um valor.

    O relatório não é executado automaticamente depois que você escolhe o último parâmetro de forma que você pode alterar sua escolha.

  4. Selecione Exibir relatório. O relatório atualiza a exibição com base nos parâmetros escolhidos.