Criando parâmetros de relatório e configurando propriedades de parâmetros de relatório (Construtor de Relatórios 2.0)

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.

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.

É 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 de 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.

É 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çã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.

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 é 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.

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.

É 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 for aberto pelo usuário ou visualizado no Construtor de Relatórios 2.0. 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çã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.