Partilhar via


Tutorial: Adicionar parâmetros ao relatório (Report Builder)

É possível adicionar parâmetros a relatórios paginados do Reporting Services com o Report Builder no SQL Server Reporting Services (SSRS) para que os leitores de relatório filtrem os dados para valores específicos. Os parâmetros de relatório são criados automaticamente para cada parâmetro de consulta incluído em uma consulta de conjunto de dados. O tipo de dados do parâmetro determina como ele aparece na barra de ferramentas de exibição de relatório.

A imagem a seguir mostra um relatório paginado com dados filtrados de acordo com os parâmetros selecionados:

Captura de tela que mostra um relatório paginado com dados filtrados de acordo com os parâmetros selecionados.

Neste tutorial, você:

  • Criar um relatório paginado com inserção de fonte de dados e consulta
  • Usar parâmetros de consulta para criar parâmetros de relatório e configurar propriedades
  • Usar conjuntos de dados para controlar os dados visíveis dos parâmetros do relatório
  • Definir valores padrão e valores personalizados para parâmetros

O tempo estimado para concluir este tutorial é de 25 minutos.

Observação

Os procedimentos a seguir fornecem instruções resumidas para trabalhar com o Report Builder. Em alguns casos, várias ações do assistente são consolidadas na mesma etapa. Para obter instruções detalhadas passo a passo com capturas de tela, confira Tutorial: Criar um relatório de tabela básico (Report Builder). O artigo descreve como navegar até um servidor de relatório, como escolher uma fonte de dados, como criar um conjunto de dados e muito mais.

Pré-requisitos

Para obter informações sobre os requisitos, confira Pré-requisitos para tutoriais (Construtor de Relatórios).

Crie um relatório com o Assistente de Tabela ou Matriz

Siga estas etapas para criar um relatório paginado (matriz) usando o assistente de Tabela ou Matriz:

  1. Inicie o Report Builder no computador, no portal da Web do Reporting Services ou no modo integrado do SharePoint.

    A caixa de diálogo Novo Relatório ou Conjunto de Dados será aberta. Se a caixa de diálogo não abrir, selecione Arquivo>Novo.

  2. Selecione a guia Novo Relatório e selecione Assistente de Tabela ou Matriz no painel direito.

  3. Na página Escolher um conjunto de dados, selecione a opção Criar um conjunto de dados e Avançar.

  4. Na página Escolher uma conexão com uma fonte de dados, selecione uma fonte de dados. Selecione uma fonte de dados na lista suspensa ou navegue até o servidor de relatório para selecionar uma fonte. O tipo da fonte de dados deve ser SQL Server.

  5. Na guia Geral, selecione Testar Conexão para verificar se é possível conectar-se à fonte de dados.

    Você deverá ver uma mensagem pop-up: "Conexão criada com sucesso". Selecione OK para limpar a mensagem pop-up.

  6. Selecione OK para concluir a configuração da fonte de dados e, depois, selecione Avançar.

  7. Na página Crie uma consulta, selecione Editar como Texto.

  8. No diálogo do designer de consultas, cole a consulta Transact-SQL a seguir na caixa superior:

    ;WITH CTE (StoreID, Subcategory, Quantity)
    AS (  
    SELECT 200 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 2002 AS Quantity  
    UNION SELECT  200 AS StoreID, 'Camcorders' AS Subcategory, 1954 AS Quantity  
    UNION SELECT  200 AS StoreID, 'Accessories' AS Subcategory, 1895 AS Quantity  
    UNION SELECT  199 AS StoreID, 'Digital Cameras' AS Subcategory, 1849 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1579 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Camcorders' AS Subcategory, 1561 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Digital Cameras' AS Subcategory, 1553 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Accessories' AS Subcategory, 1534 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Accessories' AS Subcategory, 1755 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Camcorders' AS Subcategory, 1631 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1772 AS Quantity)  
    SELECT StoreID, Subcategory, Quantity  
    FROM CTE  
    

    Essa consulta combina os resultados de várias instruções SELECT do Transact-SQL em uma expressão de tabela comum. A expressão especifica valores com base em dados de vendas simplificados de câmeras no banco de dados de exemplo da Contoso. As subcategorias são câmeras digitais, câmeras digitais SLR (reflex de lente única), filmadoras e acessórios.

  9. Na barra de ferramentas do Designer de Consultas, selecione Executar (!).

    A consulta executa e exibe o conjunto de resultados para os campos StoreID, Subcategoria e Quantidade.

    O conjunto de resultados consiste em 11 linhas de dados que mostram a quantidade de itens vendidos para cada subcategoria de quatro lojas. O nome da loja não faz parte do conjunto de resultados. Posteriormente neste tutorial, você irá pesquisar o nome do repositório que corresponde ao identificador de repositório de um conjunto de dados separado.

    Esta consulta não contém parâmetros de consulta. Você adicionará parâmetros de consulta posteriormente neste tutorial.

  10. Para continuar no assistente, selecione Avançar.

Formatar o layout do relatório e adicionar totais

O assistente fornece um design inicial para exibir os dados no relatório. No procedimento a seguir, você organiza os valores das quantidades vendidas em linhas agrupadas por subcategoria, com uma coluna para cada StoreID. O painel de visualização ajuda a visualizar o resultado dos dados de agrupamento antes de concluir o design do relatório.

Organize os dados da tabela em grupos na página Organizar campos:

  1. Na caixa Campos disponíveis, arraste o campo Subcategoria para a caixa Grupos de linhas.

  2. Arraste o campo StoreID para a caixa Grupos de colunas.

  3. Arraste o campo de Quantidade para a caixa Valores.

    A funçã Soma agrega automaticamente os dados de Quantidade, que é a agregação padrão para campos numéricos. O valor é [Sum(Quantity)].

  4. Para continuar no assistente, selecione Avançar.

  5. Na página Escolher o layout, em Opções, selecione a opção Mostrar subtotais e totais gerais.

    Quando você executa o relatório, a última coluna mostra a Quantidade total de cada Subcategoria para todas as lojas (StoreID). A última linha mostra a Quantidade total de todas as Subcategorias de cada loja (StoreID).

  6. Selecione Avançar para visualizar a tabela no painel Preview. Você verá três linhas que demonstram o layout da tabela quando executar o relatório:

    • A primeira linha é repetida uma vez para a tabela para mostrar os títulos das colunas.

    • A segunda linha se repete uma vez para cada StoreID para mostrar a quantidade de itens vendidos e a quantidade de cada subcategoria.

    • A terceira linha se repete uma vez para mostrar a quantidade total de itens vendidos e a quantidade total por subcategoria para todas as lojas.

  7. Selecione Concluir.

    O Report Builder adiciona sua matriz à superfície do design. A tabela tem três linhas e três colunas: Subcategory, [StoreID] e Total.

    Captura de tela da matriz com as três colunas e três linhas.

  8. Aumente a largura da tabela para que os dados da subcategoria possam ser exibidos em uma única linha no relatório:

    1. Na superfície do design, selecione na matriz para exibir os identificadores de coluna e linha. As alças aparecem como barras cinzas ao longo das bordas da tabela.

    2. Aponte para a linha entre as colunas Subcategoria e StoredID para exibir o cursor de seta dupla.

    3. Selecione e arraste a linha para aumentar a largura da coluna Subcategoria:

      Captura de tela da matriz enquanto expande a largura da coluna.

  9. Na guia Início, selecione Executar para visualizar o relatório.

    O relatório é executado no servidor de relatório e exibe a hora em que o processamento de relatório ocorreu:

    Captura de tela da visualização do relatório executada no servidor de relatório.

No design da matriz atual, os títulos das colunas exibem o identificador da loja, mas não o nome da loja. Posteriormente, você adiciona uma expressão para pesquisar o nome do repositório em um conjunto de dados contendo pares de identificador/nome do repositório.

Criar parâmetros de consulta, parâmetros de relatório e configurar propriedades

No Designer de Consultas, edite a consulta e adicione parâmetros. Quando você adiciona um parâmetro de consulta, o Report Builder cria automaticamente um parâmetro de valor único para o relatório. Cada parâmetro tem várias propriedades com valores padrão, como nome, prompt e tipo de dados. É possível configurar essas propriedades de acordo com os requisitos do relatório.

Adicionar parâmetros de consulta para criar parâmetros de relatório

Quando você adicionar um parâmetro de consulta a uma consulta, o Report Builder criará automaticamente um parâmetro de relatório de valor único com propriedades padrão para nome, aviso e tipo de dados.

Siga estas etapas para adicionar um parâmetro de consulta:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

  2. No painel de Dados do Relatório, expanda a pasta Conjuntos de Dados. Clique com o botão direito do mouse em DataSet1 e selecione Consulta.

    A caixa de diálogo do Designer de Consultas é aberta. A consulta existente aparece na caixa superior da caixa de diálogo.

    1. Use a barra separadora entre as duas caixas na caixa de diálogo e aumente o tamanho da caixa superior.

    2. Role até a parte inferior da caixa superior para que a última linha da consulta fique visível.

    3. Selecione Enter para adicionar uma nova linha ao final da consulta.

  3. Cole a seguinte cláusula WHERE do Transact-SQL como a última linha da consulta:

    WHERE StoreID = (@StoreID)
    

    A caixa de diálogo WHERE limita os dados recuperados ao identificador de loja especificado pelo parâmetro de consulta \@StoreID.

  4. Na barra de ferramentas do Designer de Consultas, selecione Executar (!).

    O diálogo Definir Parâmetros de Consulta é aberto e solicita um valor para o parâmetro de consulta \@StoreID.

    Dica

    Se as células completas da tabela e os títulos das colunas não estão visíveis, aumente o tamanho da caixa de diálogo.

  5. Na caixa Valor do Parâmetro, digite 200 e selecione OK:

    Captura de tela que mostra como adicionar o valor do parâmetro na caixa de diálogo Designer de Consultas.

    O conjunto de resultados exibe as quantidades vendidas de Acessórios, Filmadoras e Câmeras Digitais SLR do identificador de loja 200.

  6. Selecione OK para fechar o Designer de Consultas.

  7. No painel Dados do Relatório, expanda o nó Parâmetros:

    O nó contém um parâmetro de relatório chamado StoreID. Quando você seleciona o parâmetro, as propriedades do parâmetro são exibidas no painel Parâmetros na área de design. É possível usar esse painel para formatar o layout dos parâmetros do relatório.

    Captura de tela do nó Parâmetros no painel de Dados do Relatório e do painel Parâmetros na área de design.

    Dica

    Quando o painel Parâmetros não está visível, selecione Exibir e marque a caixa de seleção Parâmetros.

Atualizar propriedades de parâmetros de relatório

Após a criação dos parâmetros, é possível ajustar os valores padrão das propriedades. No exemplo do tutorial, o parâmetro de relatório StoreID tem o tipo de dados padrão Texto. Como o identificador de loja é um inteiro, você pode alterar o tipo de dados para Inteiro.

Siga estas etapas para alterar o tipo de dados de um parâmetro de relatório:

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

  2. Na caixa de diálogo Propriedades de parâmetro de relatório, configure as seguintes propriedades na guia Geral:

    • Prompt: Insira o Identificador da loja?. Este prompt aparece na barra de ferramentas do Report Viewer quando você executa o relatório.

    • Em Tipo de dados: na lista suspensa, selecione Inteiro. Essa configuração define o tipo de dados para entrada permitida no prompt.

    É possível deixar as outras propriedades e opções inalteradas.

  3. Selecione OK para aplicar as alterações.

  4. Selecione Executar para visualizar o relatório. O visualizador de relatórios exibe o prompt Identificador de loja? para o parâmetro StoreID.

  5. Na barra de ferramentas do Report Viewer, no prompt Identificador da loja?, insira 200 e selecione Exibir Relatório:

    Captura de tela da visualização do relatório quando a ID da Loja 200 é inserida no prompt do identificador da Loja.

Usar conjuntos de dados para fornecer valores

Para garantir que os leitores do relatório insiram apenas valores válidos para um parâmetro, apresente uma lista suspensa de valores possíveis. O conjunto de valores pode vir de um conjunto de dados ou de uma lista que você especificar. Os valores disponíveis devem ser fornecidos de um conjunto de dados com uma consulta que não contém uma referência ao parâmetro.

Criar um conjunto de dados para valores de parâmetro válidos

Siga estas etapas para criar um conjunto de dados que lista valores válidos para um parâmetro:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

  2. No painel Dados do Relatório, clique com o botão direito do mouse no nó Conjuntos de Dados e selecione Adicionar Conjunto de Dados.

  3. A caixa de diálogo Propriedades do conjunto de dados contém as propriedades e opções a seguir:

    1. Para a propriedade Nome, digite Lojas.

    2. Escolha a opção Usar um conjunto de dados inserido em meu relatório.

    3. Expanda a lista suspensa Fonte de dados e selecione a fonte de dados especificada anteriormente neste tutorial.

    4. Para a propriedade Tipo de consulta, verifique se a opção Texto está selecionada.

    5. Na caixa de consulta, cole a seguinte consulta:

      SELECT 200 AS StoreID, 'Contoso Catalog Store' as StoreName
      UNION SELECT 199 AS StoreID, 'Contoso North America Online Store' as StoreName
      UNION SELECT 307 AS StoreID, 'Contoso Asia Online Store' as StoreName
      UNION SELECT 306 AS StoreID, 'Contoso Europe Online Store' as StoreName
      
  4. Selecione OK para aplicar as alterações.

    O painel de Dados do Relatório adiciona o conjunto de dados Lojas no nó Conjunto de dados com as propriedades StoreID e StoreName.

Especificar a lista de valores disponíveis

Depois de ter um conjunto de dados com valores disponíveis, atualize as propriedades do relatório para identificar o conjunto de dados e a propriedade para preencher a lista de valores disponíveis na barra de ferramentas do Report Viewer.

Forneça valores disponíveis para um parâmetro a partir de um conjunto de dados por meio destas etapas:

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

  2. Na caixa de diálogo Propriedades de parâmetro de relatório, configure as seguintes propriedades na guia Valores Disponíveis:

    1. Selecione a opção Obter valores de uma consulta.

    2. Para a propriedade Conjunto de Dados, na lista suspensa, selecione Lojas.

    3. Para a propriedade Campo de valor, na lista suspensa, selecione StoreID.

    4. Para a propriedade Campo de rótulo, na lista suspensa, selecione StoreName. O campo de rótulo especifica o nome para exibição do valor.

  3. Vá para a guia Geral e altere o Prompt para o Nome da loja:.

  4. Selecione OK para aplicar as alterações.

    Os leitores do relatório agora selecionarão em uma lista de nomes de loja em vez de identificadores de loja. O tipo de dados de parâmetro permanece Inteiro porque o parâmetro se baseia no identificador de loja, não no nome de loja.

  5. Selecione Executar para visualizar o relatório. O Report Viewer exibe o prompt Nome da loja: como o parâmetro de StoreID.

    Na barra de ferramentas do Report Viewer, o prompt agora apresenta uma lista suspensa com o valor inicial Selecionar um valor:

    Captura de tela da visualização do relatório com o prompt de nome da loja atualizado que fornece uma lista suspensa de valores para o leitor.

  6. Na lista suspensa, selecione Lojas de Catálogos Contoso e selecione Exibir Relatório.

    O relatório exibe a quantidade vendida de Acessórios, Filmadoras e Câmeras Digitais SLR para o nome de exibição da loja Loja de Catálogos Contoso, que corresponde ao identificador de loja 200.

Pesquisar pares de nome/valor em conjuntos de dados

Um conjunto de dados pode conter o parâmetro identificador e o campo de nome correspondente. Quando você apenas um valor de identificador, pode pesquisar o nome correspondente em um conjunto de dados. Para essa abordagem, você precisa de um conjunto de dados criado que inclua pares nome-valor.

Siga estas etapas para pesquisar um valor para um nome de um conjunto de dados:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

  2. Na área de design, na linha de cabeçalho da coluna na matriz, clique com o botão direito do mouse no parâmetro [StoreID] e selecione Expressão.

  3. Na caixa de diálogo Expressão, configure as seguintes propriedades:

    1. Na caixa Definir expressão para: Valor na parte superior, exclua todo o texto.

    2. Na caixa Categoria, expanda o nó Funções Comuns e selecione Diversos. A caixa Item é atualizada e exibe um conjunto de funções.

    3. Na caixa Item, dê um clique duplo em Pesquisar. A caixa superior é atualizada e exibe a expressão =Lookup(. A caixa Exemplo mostra um exemplo da sintaxe da função Lookup.

    4. Na caixa superior, cole a seguinte expressão:

      =Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")
      

      A função Lookup pesquisa o valor do parâmetro do relatório StoreID no conjunto de dados Lojas e retorna o valor do parâmetro StoreName.

  4. Selecione OK para aplicar as alterações.

    O cabeçalho da coluna é alterado para uma expressão complexa, <<Expr>>.

  5. Selecione Executar para visualizar o relatório.

    Na visualização do relatório, o cabeçalho de coluna na parte superior de cada coluna exibe o nome da Loja em vez do identificador da Loja.

Configurar valores padrão e personalizados

É possível configurar valores padrão para parâmetros de relatório para que o relatório seja executado automaticamente sem solicitar a entrada do leitor. Selecione o valor padrão de um parâmetro em uma lista existente de valores ou especifique um valor personalizado.

Especificar um valor padrão a partir de um conjunto de dados

Siga estas etapas para configurar valores padrão usando um conjunto de dados:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

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

  3. Na caixa de diálogo Propriedades de parâmetro de relatório, configure as seguintes propriedades na guia Valores Padrão:

    1. Selecione a opção Obter valores de uma consulta.

    2. Para a propriedade Conjunto de Dados, na lista suspensa, selecione Lojas.

    3. Para a propriedade Campo de valor, na lista suspensa, selecione StoreID.

  4. Selecione OK para aplicar as alterações.

  5. Selecione Executar para visualizar o relatório.

    O relatório agora exibe o valor de prompt Contoso North America Online Store por padrão porque é o primeiro valor no conjunto de resultados do conjunto de dados Stores. O relatório exibe a quantidade vendida de Câmeras Digitais SLR o identificador da loja 199, que corresponde ao nome de exibição de loja da Loja Online da Contoso na América do Norte.

Fornecer valor padrão personalizado

É possível também fornecer um valor personalizado a ser usado como o valor padrão para o parâmetro:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

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

  3. Na caixa de diálogo Propriedades de parâmetro de relatório, configure as seguintes propriedades na guia Valores Padrão:

    1. Selecione a opção Especificar valores e, em seguida, selecione Adicionar. Uma nova linha de valor é adicionada à caixa Valor. O valor padrão na lista suspensa é (Nulo).

    2. Na caixa suspensa, digite 200.

  4. Selecione OK para aplicar as alterações.

  5. Selecione Executar para visualizar o relatório.

    O relatórios exibe o valor do prompt Loja de Catálogos Contoso porque ele é o nome de exibição do identificador de loja 200. O relatório exibe a quantidade vendida de Acessórios, Filmadoras e Câmeras Digitais SLR para o identificador de repositório 200.

Aprimorar o relatório com parâmetros

Há muitas maneiras de usar parâmetros de relatório para aprimorar o relatório. As seções a seguir descrevem várias técnicas de personalização:

  • Identificar os parâmetros atualmente selecionados pelo leitor de relatório
  • Permitir que os leitores de relatório filtrem os dados do relatório
  • Suporte a parâmetros de vários valores em seu relatório
  • Adicionar um parâmetro booliano para visibilidade condicional de dados de relatório

Mostrar parâmetros selecionados pelo leitor

Quando os leitores do relatório tem dúvidas sobre um relatório, é útil saber a seleção atual de valores de parâmetros. Você pode preservar os valores selecionados pelos usuários para cada parâmetro no relatório. Uma forma de fazer isso é exibir os parâmetros em uma caixa de texto no rodapé da página.

Siga estas etapas para exibir o valor do parâmetro selecionado com um rótulo no rodapé da página:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

  2. Clique com o botão direito do mouse no rodapé da página, selecione Inserir e, em seguida, selecione Caixa de Texto:

    Captura de tela que mostra como selecionar a opção de inserir uma caixa de texto no rodapé da página do relatório.

  3. Arraste a caixa de texto para junto da caixa de texto com o carimbo de data/hora. Use a alça lateral da caixa de texto para expandir sua largura.

  4. No painel Dados do Relatório, no nó Parâmetros, arraste o parâmetro StoreID para a caixa de texto no rodapé da página. A caixa de texto é atualizada para exibir o valor [@StoreID].

  5. Atualize a caixa de texto para adicionar um rótulo para o valor do parâmetro:

    1. Selecione a caixa de texto até que o cursor de inserção apareça após a expressão existente e digite um espaço.

    2. No painel de Dados do Relatório, arraste outra cópia do parâmetro StoreID até a caixa de texto. A caixa de texto é atualizada e exibe o valor [@StoreID] [@StoreID].

    3. Na caixa de texto, clique com o botão direito do mouse no primeiro parâmetro [StoreID] e selecione Expressão.

    4. Na caixa de diálogo Expressão, atualize a expressão na caixa Definir expressão para: Valor na parte superior. Substitua o texto Value pelo texto Label.

  6. Selecione OK para aplicar as alterações.

    A caixa de texto é atualizada e exibe o valor [@StoreID.Label] [@StoreID].

  7. Selecione Executar para visualizar o relatório.

    O relatório passa a exibir o nome e o identificador da loja selecionada no rodapé da página, com as informações do carimbo de data/hora.

Filtrar dados de relatório com parâmetros

Os filtros ajudam a controlar os dados a serem usados em um relatório, depois que ele chega de uma fonte de dados externa. Para permitir que os leitores do relatório controlem os dados que eles querem ver, é possível incluir o parâmetro de relatório em um filtro da matriz.

Para especificar um parâmetro em um filtro de matriz, siga estas etapas:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

  2. Na matriz de relatório, clique com o botão direito do mouse em um cabeçalho de coluna e selecione Propriedades do Tablix.

  3. Na caixa de diálogo de Propriedades Tablix, selecione a guia Filtros e escolha Adicionar. Uma nova linha de filtro é exibida.

    1. Para a propriedade Expressão, na lista suspensa, selecione o campo de conjunto de dados StoreID. A caixa tipo de dados exibe Inteiro. Quando o valor da expressão for um campo de conjunto de dados, o tipo de dados será definido automaticamente.

    2. Para a propriedade Operador, verifique se o símbolo de igualdade (=) está selecionado.

    3. Para a propriedade Value, insira [@StoreID].

      [@StoreID] é a sintaxe simples que representa a expressão mais longa =Parameters!StoreID.Value.

  4. Selecione OK para aplicar as alterações.

  5. Selecione Executar para visualizar o relatório.

    A matriz só exibe dados para o Loja de Catálogos Contoso.

  6. Na barra de ferramentas do Report Viewer, no prompt de Nome da loja, selecione Loja Online Contoso na Ásia e selecione Exibir Relatório.

    A matriz exibe dados correspondentes ao repositório que você selecionou.

Usar parâmetros de vários valores

Um parâmetro de vários valores é uma matriz de valores. Em uma consulta de conjunto de dados, a sintaxe de consulta deve testar a inclusão de um valor em um conjunto de valores. Em uma expressão de relatório, a sintaxe da expressão deve acessar uma matriz de valores, em vez de um valor individual.

Ao alterar um parâmetro de valor único para vários valores, é necessário alterar a consulta e todas as expressões que contêm alguma referência ao parâmetro, incluindo filtros.

Siga estas etapas para alterar um parâmetro de valor único existente para dar suporte a vários valores:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

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

  3. Na guia Geral, selecione a opção Permitir vários valores e selecione OK.

Atualize a consulta para processar corretamente os valores:

  1. No painel de Dados do Relatório, expanda o nó Conjuntos de Dados, clique com o botão direito do mouse em DataSet1 e selecione Consulta.

  2. Na caixa de diálogo do Designer de Consultas, role até a parte inferior da consulta na caixa superior.

  3. Altere o sinal de igualdade (=) para IN na cláusula WHERE do Transact-SQL na última linha da consulta:

    WHERE StoreID IN (@StoreID)
    

    O operador IN testa um valor para inclusão em um conjunto de valores.

  4. Selecione OK para aplicar as alterações.

Atualize o filtro de parâmetro para lidar corretamente com vários valores:

  1. Na matriz de relatório, clique com o botão direito do mouse em um cabeçalho de coluna e selecione Propriedades do Tablix.

  2. Na caixa de diálogo de Propriedades Tablix, selecione a guia Filtros.

  3. Para a propriedade Operador, selecione In na lista suspensa.

  4. Selecione OK para aplicar as alterações.

Atualize o rodapé da página para exibir e forma correta os dados do parâmetro de vários valores:

  1. Selecione a caixa de texto que exibe o parâmetro no rodapé da página.

  2. Exclua todo o texto na caixa de texto.

  3. Clique com o botão direito do mouse na caixa de texto e selecione Expressão.

  4. No diálogo Expressão, cole a expressão a seguir na caixa superior:

    =Join(Parameters!StoreID.Label, ", ")
    

    Esta expressão concatena todos os nomes de loja selecionados pelo usuário, separados por uma vírgula e um espaço.

  5. Selecione OK para aplicar as alterações.

    A caixa de texto no rodapé da página muda para uma expressão complexa, <<Expr>>.

  6. No rodapé da página, selecione na caixa de texto e use as alças para aumentar a largura da caixa.

  7. Na caixa de texto, posicione o cursor na frente da expressão e insira o texto Valores de parâmetro selecionados:.

  8. Selecione o texto do rótulo Valores de parâmetro selecionados: e aplique o formato Negrito ao texto. Você também pode usar o atalho de teclado (Ctrl + B).

Verifique o relatório e o suporte de teste para o parâmetro de vários valores:

  1. Selecione Executar para visualizar o relatório.

  2. Na barra de ferramentas do Report Viewer, no prompt Nome da loja, expanda a lista suspensa.

    Cada valor de parâmetro na lista tem uma caixa de seleção. Quando o valor do parâmetro é incluído na exibição do relatório, a caixa de seleção é marcada.

  3. No menu suspenso, selecione a opção Selecionar tudo. Essa opção marca todas as caixas de seleção na lista, o que faz com que todos os valores de parâmetro sejam exibidos no relatório.

  4. Na barra de ferramentas do Report Viewer, selecione Exibir Relatório. O relatório exibe a quantidade vendida de todas as subcategorias de todas as lojas:

    Captura de tela que mostra como Selecionar tudo para ver todos os valores de parâmetro no relatório.

    Dica

    Para valores de parâmetro longos ou relatórios largos com muitas colunas, aumente a largura do relatório ou as larguras das colunas na área de design para melhorar a legibilidade dos dados no modo de exibição de relatório. É possível também ajustar a formatação de títulos de coluna ou dados de célula, como usando o alinhamento central, para que os valores longos sejam quebrados em um formato legível.

  5. Na lista suspensa, desmarque a opção Selecionar Tudo e selecione dois valores: Loja de Catálogos Contoso e Loja Online Contoso na Ásia.

  6. Selecione Exibir relatório novamente para ver os resultados atualizados.

Adicionar parâmetros boolianos para visibilidade condicional

Ao implementar um parâmetro booleano (Verdadeiro ou Falso) no relatório, é possível controlar a visibilidade dos dados do parâmetro com base na configuração atual.

Siga estas etapas para adicionar um parâmetro booleano ao seu relatório:

  1. Na guia Executar, selecione Design para retornar ao modo de exibição de design.

  2. No painel ​​Dados do Relatório, clique com o botão direito do mouse sobre o nó Parâmetrose selecione Adicionar Parâmetro.

  3. Na caixa de diálogo Propriedades de parâmetro de relatório, configure as seguintes propriedades na guia Geral:

    • Nome: digite ShowSelections.

    • Prompt: digite Mostrar seleções?.

    • Tipo de dados: selecione Booliano na lista suspensa.

  4. Alterne para a guia Valores padrão e configure as seguintes propriedades:

    1. Selecione a opção Especificar valor e escolha Adicionar.

    2. Na caixa Valor, insira False.

  5. Selecione OK para aplicar as alterações de propriedade.

Agora você pode controlar a visibilidade com base na configuração do parâmetro:

  1. No rodapé de página na matriz, clique com o botão direito do mouse na caixa de texto que exibe o parâmetro e selecione Propriedades da Caixa de Texto.

  2. A caixa de diálogo Propriedades da Caixa de Texto contém as propriedades a seguir:

    1. Selecione a guia Visibilidade.

    2. Selecione a opção Mostrar ou ocultar com base em uma expressão.

    3. Selecione a opção Expressão (Fx).

    4. No diálogo Expressão, cole a expressão a seguir na caixa superior:

      =Not Parameters!ShowSelections.Value
      

      A propriedade Oculta controla a opção de Visibilidade de caixa de texto. Quando o operador Not (!) está presente e o leitor seleciona o parâmetro, a propriedade Oculta é False e a caixa de texto exibe os dados do parâmetro.

    5. Selecione OK para aplicar a expressão.

  3. Selecione OK novamente para aplicar as propriedades da caixa de texto.

Verifique o relatório e o suporte de teste para o parâmetro booliano:

  1. Selecione Executar para visualizar o relatório.

  2. Na barra de ferramentas do Report Viewer, defina a opção Mostrar seleções? como True. Selecione Exibir relatório.

    Quando o leitor define Mostrar seleções como True, as informações de valores de parâmetro selecionados são exibidas no relatório.

    Captura de tela que mostra como usar o parâmetro booleano no relatório para controlar a visibilidade dos dados.

Adicionar um título ao relatório

Adicione um título ao relatório com estas etapas:

  1. No Report Builder, selecione Design para retornar ao modo de design.

  2. Na superfície do design, selecione a caixa de texto Clique para adicionar título.

  3. Na caixa de texto Clique para adicionar título, insira o texto Vendas de Produtos Parametrizados e selecione fora da caixa de texto.

Salvar o relatório

Siga estas etapas para salvar o relatório em um servidor de relatório:

  1. Selecione Arquivo>Salvar como.

  2. Na caixa de diálogo Salvar como Relatório, selecione Sites e Servidores Recentes no painel direito.

  3. Selecione ou digite o nome do servidor de relatório no qual você tem permissão para salvar relatórios.

    A mensagem "Conectando-se a um servidor de relatório" é exibida. Quando a conexão for concluída, a pasta de relatório padrão será aberta. O administrador do servidor de relatório especifica o local da pasta padrão.

  4. Para o Nome do relatório, substitua o valor padrão Sem título por Parameterized_Product_Sales.

  5. Selecione Salvar.

O relatório será salvo no servidor de relatório. A barra de status da parte inferior da janela mostra o nome do servidor de relatório para a conexão.