Partilhar via


Como adicionar parâmetros em cascata a um relatório (Construtor de Relatórios 3.0 e SSRS)

Os parâmetros em cascata fornecem um modo de gerenciar grandes quantidades de dados de relatório. É 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çãoObservação

É possível criar e modificar definições de relatórios (.rdl) no Report Builder 3.0 e no Designer de Relatórios no Business Intelligence Development Studio. Cada ambiente de criação fornece diferentes maneiras de criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Projetando e implementando relatórios usando o Designer de Relatórios (Reporting Services) na Web em microsoft.com.

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, consulte Como adicionar, alterar ou excluir valores disponíveis para um parâmetro de relatório (Construtor de Relatórios 3.0 e SSRS).

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 Dados do Relatório determina a ordem na qual as consultas de parâmetro aparecem no relatório e portanto a ordem na qual um usuário escolhe cada valor de parâmetro sucessivo.

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

Para criar o conjunto de dados principal com uma consulta que inclui múltiplo parâmetros relacionados

  1. No painel Dados do Relatório, clique com o botão direito do mouse em uma fonte de dados e clique em 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 clique em Nova para criar uma.

  4. Em Tipo de consulta, escolha o tipo de consulta para a fonte de dados selecionada. Neste tópico, 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. Para obter mais informações, consulte "Filtering Rows by Using WHERE and HAVING" na documentação do Reporting Services nos Manuais Online do SQL Server.

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

    ObservaçãoObservaçã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, consulte Com alterar a ordem de um parâmetro de relatório (Construtor de Relatórios 3.0 e SSRS)

  7. Clique em OK.

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

Para 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 clique em 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 tópico, 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 à seguinte:

    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.

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

  6. Clique em OK.

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

Para 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 clique em Propriedades do Parâmetro.

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

  3. Clique em Valores Disponíveis.

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

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

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

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

  8. Clique em OK.

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

Para 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 clique em 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 tópico, 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, para criar uma consulta para um parâmetro que fornece todos os valores de subcategoria (parâmetro dependente) para uma categoria (parâmetro independente), você pode usar uma instrução Transact-SQL semelhante à seguinte:

    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 será preenchido com o valor escolhido pelo usuário para o parâmetro de relatório que tem o mesmo nome.

  6. Clique em OK.

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

Para 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 clique em Propriedades do Parâmetro.

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

  3. Clique em Valores Disponíveis.

  4. Clique em Obter valores de uma consulta.

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

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

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

  8. Clique em OK.

Para testar os parâmetros em cascata

  1. Clique em Executar.

  2. Na lista suspensa 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 suspensa do segundo parâmetro é populada com os valores disponíveis com base no valor do primeiro parâmetro.

  3. Na lista suspensa 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. Clique em Exibir Relatório. O relatório atualiza a exibição com base nos parâmetros escolhidos.