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.
.gif "Observação") Observaçã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 Parâmetros (Report Builder 3.0 e SSRS). 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 baseados em consulta e a fonte de dados exigir que cada usuário faça 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 Parâmetros (Report Builder 3.0 e SSRS) 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®ion=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®ion=east®ion=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.
Consulte também