Compartilhar via

Adicionar, alterar ou excluir valores disponíveis para um parâmetro de relatório paginado (Construtor de Relatórios)

  • Artigo

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

Depois de criar um parâmetro de relatório paginado, você poderá especificar uma lista de valores disponíveis a ser exibida para o usuário. Uma lista de valores disponíveis limita as escolhas do usuário aos valores válidos para o parâmetro.

Os valores disponíveis são exibidos em uma lista ao lado do parâmetro de relatório na barra de ferramentas quando o relatório é executado. Os parâmetros de relatório podem representar um valor ou diversos valores. No caso de diversos valores, a lista começa com um recurso Selecionar Tudo, através do qual o usuário pode selecionar ou desmarcar todos os valores selecionando uma única caixa.

É possível fornecer uma lista de valores estática ou uma lista baseada em um conjunto de dados de relatório. Se preferir, você pode especificar um nome amigável para os valores usando um campo de rótulo. Por exemplo, no caso de um parâmetro baseado em um campo ProductID , você pode exibir o campo ProductName no rótulo do parâmetro. Quando o relatório é executado, o usuário pode escolher uma opção entre os nomes de produto, mas o valor efetivamente escolhido é o ProductIDcorrespondente.

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.

Depois de publicar um relatório, você poderá sobrescrever os valores que você definiu na ferramenta de criação de relatório, configurando os valores de propriedade de parâmetro no servidor de relatórios. Para obter mais informações, confira Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

Adicionar ou alterar os valores disponíveis para um parâmetro de relatório

  1. No painel Dados do Relatório , expanda o nó Parâmetros . Clique com o botão direito do mouse no parâmetro e selecione Propriedades do Parâmetro. A caixa de diálogo Propriedades do Parâmetro do Relatório é aberta.

    Observação

    Se o painel Dados do Relatório não estiver visível, selecione Exibir e em Dados do Relatório.

  2. Selecione Valores Disponíveis. Selecione uma opção de valores disponíveis:

    • Selcione Especificar valores para fornecer a lista de valores manualmente e, se desejar, nomes amigáveis (rótulos) para os valores.

      Selecione Adicionar, insira o valor na caixa de texto Valor e, opcionalmente, o rótulo na caixa de texto Rótulo. Se você não fornecer um rótulo, será usado o valor. Você pode gravar uma expressão para um valor. O tipo de dados deve coincidir com o tipo de dados do parâmetro. Os nomes de campo não podem ser usados em uma expressão para um parâmetro. Para obter exemplos, confira Filtros geralmente usados (Construtor de Relatórios).

      Repita esta etapa para todos os valores quantos você deseja fornecer. A ordem dos itens que você vê nesta lista determina a ordem em que o usuário os vê na lista. Para alterar a ordem de um item da lista, selecione uma caixa de texto Valor ou Rótulo para selecionar o item desejado e use os botões de seta para cima e para baixo para colocar o item no início ou no final da lista.

    • Selecione Obter valores de uma consulta para fornecer o nome de um conjunto de dados existente que recupera os valores e, opcionalmente, os nomes amigáveis deste parâmetro.

      Importante

      Se o mesmo conjunto de dados contiver o parâmetro de consulta correspondente ao parâmetro de relatórios, o relatório exibe uma mensagem de erro quando tentar executá-lo. Você pode solucionar esse erro usando um conjunto de dados diferente para recuperar os valores.

      Em Conjunto de dados, escolha o nome do conjunto de dados.

      No campo Valor, escolha o nome do campo que fornece os valores de parâmetro.

      No campo Rótulo, escolha o nome do campo que fornece os nomes amigáveis do parâmetro. Se não houver um campo separado para nomes amigáveis, escolha o mesmo campo escolhido para Valor.

  3. Selecione OK.

    Quando visualiza o relatório, você vê uma lista suspensa dos valores disponíveis para o parâmetro.

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

  1. No painel Dados do Relatório , expanda o nó Parâmetros . Clique com o botão direito do mouse no parâmetro e selecione Propriedades do Parâmetro. A caixa de diálogo Parâmetros de Relatório é exibida.

  2. Selecione Valores Disponíveis.

  3. Em Selecione uma das seguintes opções, selecione Nenhuma.

  4. Selecione OK.

    Quando você visualiza o relatório, vê que a lista dos valores disponíveis para o parâmetro não aparece mais.

Conteúdo relacionado