Compartilhar via


Executando um relatório com parâmetros

Um relatório com parâmetros é um relatório que usa valores de entrada para completar o processamento do relatório. Exemplos comuns de relatórios com parâmetros incluem aqueles relatórios que filtram por um valor regional, uma categoria de produto ou um identificador. Geralmente, parâmetros são usados para concluir uma consulta que seleciona dados para o relatório. Se você gerenciar ou executar um relatório com parâmetros, precisa compreender como as seleções de parâmetros afetam o relatório com o qual está trabalhando.

ObservaçãoObservação

Um autor de relatório define os parâmetros usados em um relatório. Após o relatório ser publicado, é possível modificar algumas propriedades de parâmetro para alterar quais valores serão usados e como eles serão obtidos. Para obter mais informações sobre a criação de parâmetros, consulte Adicionando parâmetros ao relatório. Para obter mais informações sobre o gerenciamento de parâmetros, consulte Definindo propriedades de parâmetro para um relatório publicado.

Armazenando e solicitando valores de parâmetro

Para obter um valor de parâmetro em tempo de execução, é possível armazenar um valor padrão com o relatório ou solicitar que o usuário digite ou selecione um valor. Armazenar um valor de parâmetro com um relatório é útil se você quiser que o relatório sempre seja processado com um valor específico. Por exemplo, se um escritório regional tem um site da Web dedicado, é possível hospedar um relatório de vendas regionais no site que sempre use um código de região específico.

Também é possível solicitar que os usuários digitem ou selecionem o valor a ser usado quando abrirem o relatório. Ao configurar um relatório para solicitar valores de parâmetro, campos de entrada serão fornecidos para que o usuário possa digitar valores específicos. Após digitar os valores, um usuário clica em Exibir Relatório para executar o relatório. Se os valores forem válidos, o relatório será exibido. Se os valores não forem válidos, será exibida uma mensagem de erro ou um relatório vazio. Se você usar valores de parâmetro armazenados, o relatório será aberto sem exibir campos de entrada ou o botão Exibir Relatório. Todos os usuários que executam o relatório usam o mesmo valor de parâmetro.

Se o relatório incluir parâmetros com base em consulta e a fonte de dados exigir que cada usuário efetue logon, o usuário será solicitado a fornecer credenciais antes que os campos de entrada de parâmetros sejam exibidos em cada página. Nesse caso, as credenciais devem ser fornecidas para recuperar valores de parâmetro.

Geralmente, é necessário saber quais valores devem ser digitados para executar um relatório com parâmetros. Um relatório talvez inclua listas suspensas de valores válidos entre os quais é possível escolher.

Para definir propriedades de parâmetro (inclusive valores padrão) em um relatório publicado, use o Gerenciador de Relatórios. Para obter mais informações, consulte Criando parâmetros de relatório e configurando propriedades de parâmetros de relatório e Definindo parâmetros em uma assinatura.

Definindo parâmetros em uma URL de relatório

Outro modo de executar um relatório com parâmetros é através de uma URL. É possível especificar um ou mais parâmetros em pares de valor de nome codificado, usando o caractere de E comercial (&) para separá-los.

Parâmetros nulos usam sintaxe especial; é necessário especificar isnull para obter um valor nulo. Se você especificar um valor nulo para um parâmetro, serão ignorados todos os outros valores especificados para aquele mesmo parâmetro. O exemplo a seguir ilustra vários parâmetros para obter valores nulos e constantes:

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder&region=west&sales:isnull=true

Parâmetros com vários valores são especificados repetindo o nome do parâmetro. Por exemplo:

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&region=east&region=west

São especificados parâmetros Boolean com um valor de 0 ou 1.

Parâmetros Float devem incluir o separador decimal da localidade de servidor.

Parâmetros DateTime devem ser especificados com o formato AAAA-MM-DDTHH:MM:SS, com base no padrão da Organização Internacional de Padronização (ISO) 8601. Para obter mais informações sobre como definir parâmetros em uma URL, consulte Usando parâmetros de acesso a URL.