Criando parâmetros de relatório e configurando propriedades de parâmetros de relatório

Os parâmetros de relatório são definidos globalmente para o relatório. Os parâmetros do relatório serão criados automaticamente, se a consulta do relatório incluir parâmetros, ou poderão ser criados manualmente. Depois da criação de um parâmetro de relatório, é necessário definir propriedades que o identifiquem e que controlem como ele é usado no relatório.

Para trabalhar com parâmetros antes de um relatório ser publicado, use a caixa de diálogo Parâmetros do Relatório no Designer de Relatórios. Para obter mais informações, consulte Com adicionar, alterar ou excluir um parâmetro de relatório (Reporting Services).

Depois que o relatório é publicado, você pode modificar muitas propriedades de parâmetros no Gerenciador de Relatórios ou no SQL ServerManagement Studio. Para obter mais informações sobre como modificar propriedades de parâmetros e sobre considerações de segurança, consulte Definindo propriedades de parâmetro para um relatório publicado.

Parâmetros de relatório

Os parâmetros de relatório são criados automaticamente para parâmetros de consulta quando uma consulta de conjunto de dados é salva, ou você pode criar um parâmetro de relatório manualmente. Depois que um parâmetro de relatório é criado, talvez seja necessário ajustar os valores padrão das propriedades do parâmetro de relatório para obter a funcionalidade desejada. Por exemplo, pode ser necessário alterar o tipo de dados, criar um conjunto de dados para fornecer uma lista de valores disponíveis, criar um conjunto de dados para valores padrão ou definir se os valores podem ser brancos ou nulos.

Se você desejar que um parâmetro permita valores nulos, deverá alterar a consulta do conjunto de dados para também permitir vários valores. Para obter mais informações, consulte Usando parâmetros de valor único e multivalor. Além disso, se você incluir um parâmetro de vários valores em uma expressão, deverá compreender como escrever a expressão para acessar os valores desejados. Para obter mais informações, consulte Usando referências de coleções de parâmetros em expressões (Reporting Services).

Para criar ou modificar um parâmetro de relatório, clique com o botão direito do mouse no nó Parâmetros no painel de Dados e abra a caixa de diálogo Propriedades do Parâmetro.

ObservaçãoObservação

Quando você remove ou altera o nome de um parâmetro de consulta, o parâmetro de relatório correspondente não é automaticamente removido ou alterado. Se você alterar o nome de um parâmetro de consulta, quando a consulta for salva, um novo parâmetro de relatório correspondente ao nome alterado será criado. É possível renomear o parâmetro de relatório para que corresponda ao novo nome do parâmetro de consulta e atualizar as propriedades do parâmetro do conjunto de dados para vincular o parâmetro de consulta ao parâmetro de relatório. Se você remover um parâmetro de consulta e não precisar do parâmetro de relatório correspondente, deverá excluí-lo manualmente.

Nome e tipo de dados

Nomes de parâmetros são necessários e devem ser exclusivos dentro do relatório. Por padrão, o tipo de dados de um parâmetro é definido como String. Você pode escolher um tipo de dados diferente na lista suspensa. Se o parâmetro do relatório for baseado em um parâmetro de consulta, verifique se o tipo de dados do parâmetro do relatório corresponde ao tipo de dados do parâmetro da consulta. O Reporting Services não detecta tipos de dados de parâmetros, portanto você mesmo deve ajustar o tipo de dados.

Os nomes devem ser compatíveis com os padrões de caracteres e de maiúsculas e minúsculas da Common Language Specification. Para obter mais informações, consulte Common Language Specification no https://msdn.microsoft.com.

Prompt

Em um relatório publicado, os parâmetros normalmente são exibidos como caixas de texto em uma área de entrada de parâmetros na parte superior do relatório. A cadeia de caracteres do prompt define o rótulo que identifica o parâmetro na área de entrada. O prompt pode ser o nome do parâmetro ou instruções para o usuário, por exemplo, "Ano" ou "Selecione um ano". Se o prompt for deixado em branco e o valor padrão do parâmetro for especificado, o valor padrão será usado e a caixa de entrada do parâmetro não será exibida quando o usuário executar o relatório. Se o prompt for deixado em branco e nenhum valor padrão do parâmetro estiver especificado, o relatório não poderá ser executado. Se você não desejar solicitar parâmetros ao usuário, selecione Oculto ou Interno.

Parâmetros ocultos e internos

É possível definir opções que controlam a visibilidade de parâmetros no relatório publicado. A configuração das opções Oculto e Interno fornece diferentes níveis de visibilidade. É possível ocultar o parâmetro na área de entrada de parâmetros do relatório publicado e ainda definir valores para ele em uma URL do relatório ou em uma definição de assinatura. Se você definir um parâmetro como Interno, ele não será exposto de maneira alguma, exceto na definição do relatório. Um parâmetro interno deve ter um valor padrão que poderá ser nulo se a opção Permitir valor nulo estiver selecionada.

Parâmetros únicos e de vários valores

É possível definir um parâmetro de vários valores selecionando a opção Multivalor na caixa de diálogo Parâmetros do Relatório. Se essa caixa de seleção não estiver selecionada, o parâmetro será de valor único. A especificação da opção Multivalor adiciona caixas de seleção aos valores disponíveis em uma lista suspensa de parâmetros no relatório publicado. Os usuários podem selecionar os valores desejados. Por exemplo, no relatório de exemplo, Sales Reason Comparisons, os usuários podem selecionar vários produtos para exibição dos dados de vendas combinados para esses produtos.

Ao especificar os valores disponíveis, você pode fornecer uma lista estática ou usar uma consulta para recuperar valores disponíveis em uma fonte de dados. Um parâmetro de vários valores deve incluir pelo menos um valor. Valores nulos não são permitidos. A opção Selecionar Tudo é criada automaticamente e exibida apenas se houver mais de um valor.

ObservaçãoObservação

No Reporting Services, se você estiver usando uma fonte de dados do Analysis Services, não escolha a opção Selecionar Tudo. A opção Selecionar Tudo pode produzir desempenho inadequado ao processar uma consulta MDX. Para selecionar todos os valores, no designer de consulta, escolha a lista de membros Todos do MDX.

Permitir branco

Ao criar uma lista de valores disponíveis, se desejar que <Branco> seja permitido como válido, inclua-o na lista de valores válidos.

Permitir Nulo

Permitir Nulo é uma opção para parâmetros de valor único. Não é possível selecionar esse valor para um parâmetro de vários valores. Quando você seleciona Permitir Nulo, está permitindo que o parâmetro tenha um valor nulo. Por padrão, algumas linguagens de consulta não retornam valores nulos em um conjunto de resultados.

Valores disponíveis

Ao definir um parâmetro de relatório, você deve definir os valores que podem ser usados com o relatório. Esses são chamados de valores disponíveis ou de valores válidos. Uma lista de valores disponíveis contém um conjunto de valores/pares de valores. Quando o relatório é executado, o usuário vê o rótulo. Quando o usuário seleciona um rótulo, o valor correspondente é usado como o valor do parâmetro. Os valores disponíveis podem ser predefinidos como uma lista estática ou como uma expressão ou podem ser recuperados de um conjunto de dados:

  • Uma lista não consultada é uma lista estática de valores/pares de valores. A lista inteira está contida dentro da definição do parâmetro do relatório. Cada valor e rótulo pode ser um valor estático ou ser gerado a partir de uma expressão.

  • Uma lista consultada faz com que o servidor de relatório recupere um conjunto de valores e rótulos de um conjunto de dados quando o relatório é executado. Ao especificar uma lista de valores disponíveis consultados, você seleciona o conjunto de dados, o campo a ser usado para o valor e o campo a ser usado para o rótulo.

Ao especificar uma lista de valores disponíveis consultados, é recomendável criar um conjunto de dados simplificado a ser usado especificamente pelo parâmetro, em vez de usar um conjunto de dados mais complicado que também é usado pelas regiões de dados dentro do relatório. O uso do mesmo conjunto de dados para a lista de valores válidos e para as regiões de dados no relatório pode produzir resultados inesperados na lista de valores válidos.

Valor Padrão

É possível definir uma valor padrão para o parâmetro. Se todos os parâmetros de um relatório tiverem valores padrão, o relatório será processado imediatamente quando o relatório for aberto pelo usuário ou visualizado no Designer de Relatórios. Se pelo menos um parâmetro não tiver um valor padrão, o relatório exibirá os dados apenas após o usuário inserir todos os valores dos parâmetros e executar o relatório.

É possível usar valores consultados e não consultados como o padrão. Um valor padrão não consultado é um valor estático ou uma expressão. Um valor padrão consultado é uma expressão que aponta para um campo em um conjunto de dados. Se a consulta retornar várias linhas, o valor da primeira linha do conjunto de dados retornado será usado.

Também é possível optar por não especificar um valor padrão. Nesse caso, você deve especificar um prompt.

ObservaçãoObservação

Se estiver usando um parâmetro de vários valores e a consulta retornar mais de uma linha, todas as linhas serão usadas para o padrão.