Adicionar, alterar ou excluir um parâmetro de relatório paginado (Construtor de Relatórios)

Aplica-se a: Construtor de Relatórios da Microsoft (SSRS) Construtor de Relatórios do Power BI Designer de Relatórios no SQL Server Data Tools

Um parâmetro de relatório paginado fornece uma maneira de escolher os dados do relatório, conectar relatórios relacionados e variar a apresentação do relatório. Você pode fornecer um valor padrão e uma lista de valores disponíveis e o usuário pode alterar a seleção.

Depois de publicar um relatório, você poderá alterar os valores padrão, os valores disponíveis e outras propriedades para um parâmetro de relatório no servidor de relatórios. Você pode fornecer vários conjuntos de valores de parâmetros padrão criando relatórios vinculados. Para saber mais, confira Parâmetros de relatórios (Construtor de Relatórios).

Este artigo trata da adição de parâmetros de um relatório paginado no Report Builder ou Report Designer no SSDT (SQL Server Data Tools). Você também pode adicionar parâmetros de relatório a relatórios móveis no Publicador de Relatórios Móveis do Microsoft SQL Server. Para obter mais informações, consulte Criar relatórios móveis com o Publicador de Relatórios Móveis do SQL Server.

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.

Contudo, o Publicador de Relatórios Móveis do SQL Server foi preterido em todas as versões do SQL Server Reporting Services posteriores ao SQL Server Reporting Services 2019.

Adicionar ou editar um parâmetro de relatório

  1. No Construtor de Relatórios ou no Designer de Relatórios no SSDT (SQL Server Data Tools), no painel Dados de Relatório, clique com o botão direito do mouse no nó Parâmetros e selecione Adicionar Parâmetro. A caixa de diálogo Propriedades do Parâmetro do Relatório é aberta.

  2. Em Nome, digite o nome do parâmetro ou aceite o nome padrão.

  3. No Prompt, digite o texto que é exibido ao lado da caixa de texto do parâmetro quando o usuário executa o relatório.

  4. Na lista Tipo de dados, selecione o tipo de dados do valor do parâmetro.

  5. Se o parâmetro pode conter um valor em branco, selecione Permitir valor em branco.

  6. Se o parâmetro pode conter um valor nulo, selecione Permitir valor nulo.

  7. Para permitir que um usuário selecione mais de um valor do parâmetro, selecione Permitir diversos valores.

  8. Defina a opção de visibilidade.

    • Para mostrar o parâmetro na barra de ferramentas na parte superior do relatório, selecione Visível.

    • Para ocultar o parâmetro para que ele não seja exibido na barra de ferramentas, selecione Oculto.

    • Para ocultar o parâmetro e impedi-lo de ser modificado no servidor de relatórios depois que o relatório é publicado, selecione Interno. O parâmetro de relatório só pode ser exibido na definição do relatório. Para essa opção, você deve definir um valor padrão ou permitir que o parâmetro aceite um valor nulo.

  9. Selecione OK.

Excluir um parâmetro de relatório

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

  2. Clique com o botão direito do mouse no parâmetro do relatório e selecione Excluir.

Adicionar, alterar ou excluir valores disponíveis de um parâmetro de relatório (Construtor de Relatórios)
Adicionar, alterar ou excluir valores padrão de um parâmetro de relatório (Construtor de Relatórios)
Alterar a ordem de um parâmetro de relatório (Construtor de Relatórios)
Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios)
Adicionar parâmetros em cascata a um relatório (Construtor de Relatórios)
Tutorial: Adicionar um parâmetro ao relatório (Construtor de Relatórios)
Adicionar filtros de conjunto de dados, filtros de região de dados e filtros de grupo (Construtor de Relatórios)
Referências de coleções de parâmetros (Construtor de Relatórios)
Adicionar um parâmetro com vários valores a um relatório