Parâmetros de relatório (Construtor de Relatórios e SSRS)
Parâmetros de relatório o habilitam a controlar dados de relatório, conectar relatórios relacionados e variar a apresentação do relatório. Para criar um relatório que use parâmetros com eficiência, é necessário compreender como os parâmetros e as consultas a conjuntos de dados estão relacionados, como incluir os parâmetros em expressões e como gerenciar os parâmetros seja qual for a definição de relatório no servidor de relatório ou no site do SharePoint. Após publicar um relatório, você poderá gerenciar os parâmetros independentemente da definição do relatório. Criando relatórios vinculados, você pode até mesmo criar vários conjuntos de parâmetros para o mesmo relatório.
Ao visualizar um relatório, a barra de ferramentas do visualizador de relatórios exibe cada parâmetro de forma que um usuário possa especificar valores de maneira interativa. A ilustração a seguir mostra a área do parâmetro para um relatório com os parâmetros @StartDate, @EndDate, @Subcategory e @ShowAllRows.
.gif "rs_ParameterStory")
Painel de parâmetros A barra de ferramentas do visualizador de relatórios exibe um aviso e valor padrão para cada parâmetro. O layout do parâmetro na barra de ferramentas é formatado automaticamente. A ordem é determinada pela ordem dos parâmetros exibidos no painel de Dados do Relatório.
**Parâmetros @StartDate e @EndDate** O parâmetro @StartDate é do tipo de dados DateTime. O aviso Data de Início é exibido ao lado da caixa de texto. Para modificar a data, digite uma nova data na caixa de texto ou use o controle de calendário.
O parâmetro @EndDate é exibido ao lado de @StartDate.
**Parâmetro @Subcategory** O parâmetro @Subcategory é do tipo de dados Text. Como @Subcategory tem uma lista de valores disponíveis, os valores válidos são exibidos em uma lista suspensa. Você deve escolher os valores nessa lista. Como @Subcategory tem diversos valores, é exibida uma opção Selecionar Tudo que permite apagar e selecionar todos os valores na lista.
**Parâmetro @ShowAllRows** O parâmetro @ShowAllRows é do tipo de dados Boolean. Use os botões de opção para especificar True ou False.
Identificador Mostrar ou Ocultar Área de Parâmetros Na barra de ferramentas do visualizador de relatórios, clique nessa seta para mostrar ou ocultar o painel de parâmetros.
Botão Parâmetros Na visualização do Construtor de Relatórios, na Faixa de Opções, clique no botão Parâmetros para mostrar ou ocultar o painel de parâmetros.
Botão Exibir Relatório Na barra de ferramentas do visualizador de relatórios, clique em Exibir Relatório para executar o relatório depois de inserir valores de parâmetro. Se todos os parâmetros tiverem valores padrão, o relatório será executado automaticamente na primeira exibição.
Para obter mais informações sobre como usar parâmetros imediatamente, consulte Tutorial: Adicionar um parâmetro ao relatório (Construtor de Relatórios) ou Exemplos de relatório (Construtor de Relatórios e SSRS)
.gif "Observação") Observação |
|---|
Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Partes de Relatório (Construtor de Relatórios e SSRS) e Partes de Relatório no Designer de Relatórios (SSRS) na Web em microsoft.com. |
Neste artigo
Usos comuns para parâmetros
Tipos de parâmetros
Criar parâmetros
Parâmetros de relatório
Parâmetros de conjuntos de dados
Parâmetros em cascata
Exibir valores de parâmetros em um relatório
Definir parâmetros em um relatório detalhado
Definir parâmetros em um sub-relatório
Gerenciar parâmetros em um relatório publicado
Definir parâmetros em uma URL de relatório
Definir parâmetros para uma assinatura
Definir parâmetros para um instantâneo
Parâmetros e proteção de dados
Tópicos de instruções
Nesta seção
Tópicos relacionados
Usos comuns para parâmetros
Estas são as formas mais comuns de usar parâmetros:
Filtre os dados de relatório na fonte de dados criando consultas de conjunto de dados que incluam variáveis de consulta.
Filtre os dados de um conjunto de dados compartilhado. Quando você adiciona um conjunto de dados compartilhado a um relatório, não é possível alterar a consulta. No relatório, é possível adicionar um filtro de conjunto de dados que inclua uma referência a um parâmetro de relatório que você criou.
Permita que os usuários especifiquem valores para personalizar os dados em um relatório. Por exemplo, forneça dois parâmetros para a data de início e data de término em dados de vendas.
Permita que os usuários especifiquem valores para ajudar a personalizar a aparência de um relatório. Por exemplo, forneça um parâmetro booliano para indicar se é para expandir ou recolher todos os grupos de linhas aninhados em uma tabela.
Crie uma lista suspensa de valores para escolha, de forma que um usuário possa selecionar apenas um valor válido.
Crie um valor padrão para cada parâmetro, de forma que o relatório seja executado automaticamente na primeira exibição.
Crie valores em cascata, de forma que a lista suspensa para um parâmetro seja o conjunto de valores válidos baseados na seleção para um parâmetro anterior. Isso permite que você filtre milhares de valores de parâmetro sucessivamente para obter um número gerenciável.
Utilize parâmetros para relacionar relatórios principais a relatórios detalhados, a sub-relatórios e a relatórios vinculados. Ao criar um conjunto de relatórios, geralmente você pode criar cada relatório para responder a determinadas questões. Cada relatório pode fornecer uma exibição diferente ou um nível diferente de detalhes das informações relacionadas. Para fornecer um conjunto de relatórios inter-relacionados, crie parâmetros para os dados relacionados nos relatórios de destino.
Personalize conjuntos de parâmetros para vários usuários. Crie dois relatórios vinculados com base em um relatório de vendas no servidor de relatório. Um relatório vinculado usa valores de parâmetro predefinidos para vendedores e o outro usa valores de parâmetro predefinidos para gerentes de vendas. Os dois relatórios usam a mesma definição de relatório.
Caso pretenda criar instantâneos de relatório, históricos ou assinaturas para um relatório publicado, você precisará compreender como os parâmetros de relatório afetam os requisitos de design para o relatório.
.gif "Ícone de seta usado com o link Voltar ao Início")
Voltar ao início
Criar parâmetros
Você pode criar parâmetros de relatório das seguintes maneiras:
Crie ou adicione um conjunto de dados, inserido ou compartilhado, que tenha uma consulta que contém variáveis de consulta. Para obter mais informações, consulte Compreendendo os conjuntos de dados de relatório e consultas.
Crie um parâmetro manualmente a partir do painel de Dados do Relatório. Para obter mais informações, consulte Adicionar, alterar ou excluir um parâmetro de relatório (Construtor de Relatórios e SSRS).
Adicione uma parte de relatório que contenha referências a um parâmetro ou a um conjunto de dados compartilhado que contém variáveis.
ObservaçãoParâmetros podem ser publicados como uma parte de relatório separada para regiões de dados que têm conjuntos de dados dependentes com parâmetros. Embora parâmetros sejam listados como parte de um relatório, você não pode acrescentar um parâmetro de parte de relatório diretamente a um relatório. Em vez disso, adicione a parte de relatório, e quaisquer parâmetros de relatório necessários serão gerados automaticamente de consultas de conjunto de dados contidas ou referenciadas pela parte de relatório. Para obter mais informações sobre partes de relatório, consulte Partes de relatório (Construtor de Relatórios e SSRS) e Partes de relatório no Designer de Relatórios (SSRS).
Tipos de parâmetros
Os relatórios incluem dois tipos de parâmetros: parâmetros de conjunto de dados e parâmetros de relatório.
Parâmetro de conjunto de dados Um parâmetro de conjunto de dados para um conjunto de dados inserido ou um conjunto de dados compartilhado é criado automaticamente para cada variável de consulta no comando de consulta de conjunto de dados. Alguns criadores de consultas fornecem uma área para adicionar filtros aplicados com base em nomes de campo e uma opção para adicionar um parâmetro de conjunto de dados com base no nome de campo.
Os parâmetros de conjunto de dados são configurados depois que você define a consulta de conjunto de dados. É possível especificar valores padrão de forma independente para cada parâmetro de conjunto de dados. Ao adicionar um conjunto de dados compartilhado a um relatório, os parâmetros de conjunto de dados marcados como internos não poderão ser substituídos no relatório. Você poderá substituir os parâmetros de conjunto de dados que não estiverem marcados como internos. Também é possível criar parâmetros adicionais. Para obter mais informações, consulte Parâmetros de conjuntos de dados neste tópico.
Parâmetro de relatório Um parâmetro de relatório é criado automaticamente para cada parâmetro de conjunto de dados. Você também pode criar parâmetros de relatório manualmente. É possível configurar os parâmetros de relatório de forma que um usuário possa inserir valores interativamente para ajudar a personalizar o conteúdo ou a aparência de um relatório. Você também pode configurar parâmetros de relatório de forma que um usuário não possa alterar os valores pré-configurados. Os parâmetros de relatório são gerenciados independentemente de um relatório publicado no servidor de relatório. Para obter mais informações, consulte Parâmetros de relatório neste tópico.
Também é possível salvar um parâmetro de relatório separadamente do relatório, como uma parte de relatório. As partes de relatório são armazenadas no servidor de relatório e disponibilizadas para uso em relatórios de outras pessoas. As partes de relatório que são parâmetros não podem ser gerenciados de um servidor de relatório. Você pode procurar parâmetros na Galeria de Partes de Relatório e, depois de adicioná-los, configurá-los em seu relatório. Para obter mais informações, consulte Partes de relatório (Construtor de Relatórios e SSRS).
Voltar ao início
Parâmetros de relatório
O uso mais comum de parâmetros é para variar os dados do relatório recuperados pelas consultas de conjunto de dados. Neste cenário, um valor ou valores são solicitados aos usuários ao executarem o relatório, e a consulta de conjunto de dados recupera somente os dados solicitados. A consulta de conjunto de dados inclui os parâmetros de consulta, e o processador de relatório cria automaticamente os parâmetros de relatório vinculados indiretamente aos parâmetros da consulta.
| Observação |
|---|
Como os parâmetros são gerenciados independentemente no servidor, a republicação de um relatório principal com novas configurações de parâmetros não substituirá as configurações de parâmetros existentes no relatório. |
Os parâmetros de relatório são criados das seguintes formas:
Automaticamente, quando você define a consulta de conjunto de dados que contém variáveis de consulta. Para cada variável de consulta, são criados um parâmetro de consulta de conjunto de dados e um parâmetro de relatório correspondentes com os mesmos nomes. Um parâmetro de consulta pode ser uma referência a uma variável de consulta ou a um parâmetro de entrada para um procedimento armazenado.
Automaticamente, quando você adiciona uma referência a um conjunto de dados compartilhado que contém parâmetros de consulta.
Manualmente, quando você cria parâmetros de relatório no painel de dados do relatório. Os parâmetros são umas das coleções internas que você pode incluir em uma expressão em um relatório. Como as expressões são usadas para definir valores em uma definição de relatório, você pode usar parâmetros para controlar a aparência do relatório ou transmitir valores aos sub-relatórios ou relatórios relacionados que também usam parâmetros.
Por padrão, os parâmetros criados automaticamente usam um nome, um aviso e um tipo de dados gerados automaticamente. É possível alterar as propriedades de parâmetros de relatório no painel de Dados do Relatório usando a caixa de diálogo de Propriedades do Relatório. A tabela a seguir resume as propriedades que você pode definir para cada parâmetro:
Propriedade |
Descrição |
||
|---|---|---|---|
Nome |
Digite um nome com diferenciação de maiúsculas e minúsculas para o parâmetro. O nome deve começar com uma letra e conter letras, números, um sublinhado (_) e nenhum espaço. Para parâmetros gerados automaticamente, o nome corresponde ao parâmetro de consulta na consulta de conjunto de dados. Por padrão, parâmetros criados manualmente são semelhantes a ReportParameter1. |
||
Aviso |
O texto que aparece ao lado do parâmetro na barra de ferramentas do visualizador de relatórios. |
||
Tipo de dados |
Um parâmetro de relatório deve ser de um destes tipos de dados:
Quando os valores disponíveis são definidos para um parâmetro, o usuário escolhe valores em uma lista suspensa, mesmo que o tipo de dados seja DateTime. Para obter mais informações sobre tipos de dados de relatório, consulte Tipos de dados RDL. |
||
Permitir valor em branco |
Selecione esta opção se o valor do parâmetro puder ser uma cadeia de caracteres vazia ou ficar em branco. Se você especificar valores válidos para um parâmetro e desejar que um valor em branco seja um dos valores válidos, deverá incluí-lo como um dos valores que especificar. A seleção desta opção não inclui automaticamente um espaço em branco para valores disponíveis. |
||
Permitir valor nulo |
Selecione esta opção se o valor do parâmetro puder ser nulo. Se você especificar valores válidos para um parâmetro e desejar que um valor nulo seja um dos valores válidos, deverá incluir nulo como um dos valores que especificar. A seleção desta opção não inclui um valor nulo automaticamente nos valores disponíveis. |
||
Permitir diversos valores |
Forneça valores disponíveis para criar uma lista suspensa na qual seus usuários possam fazer seleções. Essa é uma boa maneira de assegurar que somente valores válidos sejam enviados na consulta de conjunto de dados. Selecione esta opção se o valor do parâmetro puder ter diversos valores exibidos em uma lista suspensa. Valores nulos são permitidos. Quando essa opção é selecionada, as caixas marcadas são adicionadas à lista de valores disponíveis em uma lista suspensa de parâmetros. A parte superior da lista inclui uma caixa de seleção para Selecionar Tudo. Os usuários podem marcar os valores desejados. Se os dados que fornecem valores forem alterados rapidamente, a lista que o usuário verá talvez não seja a mais atual. |
||
Visível |
Selecione esta opção para exibir o parâmetro de relatório na parte superior do relatório quando ele for executado. Esta opção permite que os usuários selecionem valores de parâmetro em tempo de execução. |
||
Oculto |
Selecione essa opção para ocultar o parâmetro no relatório publicado. Os valores de parâmetro de relatório ainda podem ser definidos em uma URL de relatório, em uma definição de assinatura ou no servidor de relatório. |
||
Interno |
Selecione essa opção para ocultar o parâmetro de relatório. No relatório publicado, o parâmetro de relatório só pode ser exibido na definição do relatório. |
||
Valores disponíveis |
Se você especificou valores disponíveis para um parâmetro, os valores válidos sempre aparecerão como uma lista suspensa. Por exemplo, se você fornecer valores disponíveis para um parâmetro DateTime, uma lista suspensa para datas aparecerá no painel de parâmetro em vez de um controle de calendário. Para assegurar que uma lista de valores seja consistente em um relatório e sub-relatórios, você poderá definir uma opção na fonte de dados para usar uma única transação para todas as consultas nos conjuntos de dados que forem associados a uma fonte de dados.
|
||
Valores padrão |
Defina os valores padrão usando uma consulta ou uma lista estática. Quando cada parâmetro tem um valor padrão válido, o relatório é executado automaticamente na primeira exibição. |
||
Avançado |
Defina o atributo de definição de relatório UsedInQuery, um valor que indica se o parâmetro em questão afeta direta ou indiretamente os dados de um relatório.
|
.gif "Observação sobre cuidados")
CuidadoVoltar ao início
Parâmetros de conjuntos de dados
Os parâmetros de consulta são definidos quando você compila uma consulta em um designer de consultas. Algumas extensões de dados fornecem um modo de selecionar quais campos serão incluídos como parâmetros. Outras extensões de dados identificam variáveis de consulta no comando de consulta. Um parâmetro de consulta é criado automaticamente para cada consulta disponível.
Nem todas as fontes de dados oferecem suporte a parâmetros de consulta. Para ocasiões em que não é possível filtrar dados na fonte, você pode usar parâmetros de relatório para fornecer a um usuário a capacidade de filtrar dados depois que eles são recuperados para o relatório. Embora todos os parâmetros de consulta possuam parâmetros de relatório correspondentes, é possível definir parâmetros de relatório independentemente. Os parâmetros de relatório também podem ser usados para alterar a aparência ou a organização de um relatório depois que os dados são recuperados.
Para filtrar dados na consulta de conjunto de dados, você pode incluir uma cláusula de restrição que limite os dados recuperados especificando valores a serem incluídos ou excluídos do conjunto de resultados.
Use o designer de consulta associado a uma fonte de dados para criar uma consulta parametrizada.
Em consultas Transact-SQL, diferentes fontes de dados dão suporte a diferentes sintaxes para parâmetros. O suporte abrange parâmetros que são identificados na consulta por posição ou por nome. Para obter mais informações, consulte os tópicos sobre tipos de fontes de dados externos específicos em Adicionar dados a um relatório (Construtor de Relatórios e SSRS). No designer de consulta relacional, você deve selecionar a opção de parâmetro para um filtro para poder criar uma consulta parametrizada. Para obter mais informações, consulte Interface de usuário do Designer de Consulta relacional (Construtor de Relatórios).
Para consultas baseadas em uma fonte de dados multidimensional como o Microsoft SQL Server Analysis Services, SAP NetWeaver BI ou Hyperion Essbase, você poderá especificar se um parâmetro será criado com base em um filtro que você definir no criador de consultas. Para obter mais informações, consulte o tópico sobre o designer de consultas em Designers de Consulta (Construtor de Relatórios) que corresponda à extensão de dados.
Voltar ao início
Parâmetros em cascata
Você pode criar parâmetros em cascata, em que o usuário escolhe um valor para cada parâmetro em uma ordem específica, e cada opção limita sucessivamente os valores disponíveis para o próximo parâmetro. Os parâmetros em cascata podem reduzir as milhares de opções possíveis a um número administrável. Por exemplo, um usuário escolhe uma categoria de produto, depois uma opção em uma lista de produtos disponíveis nessa categoria e, por fim, escolhe um tamanho e uma cor.
Para obter mais informações, consulte Adicionar parâmetros em cascata a um relatório (Construtor de Relatórios e SSRS).
Voltar ao início
Exibir parâmetros em um relatório
Os parâmetros de relatório são uma das coleções internas que você pode referenciar partir de uma expressão. A sintaxe da expressão varia dependendo de o parâmetro de relatório aceitar um único valor ou diversos valores. Para obter mais informações, consulte Filtros comumente usados (Construtor de Relatórios e SSRS) e Referências de coleções de parâmetros (Construtor de Relatórios e SSRS).
Definir parâmetros em um relatório detalhado
As ações de detalhamento são definidas nas páginas de propriedades de qualquer caixa de texto de um item de relatório ou em partes de um gráfico ou medidor. Esses parâmetros de relatório podem estar ocultos, usando valores no relatório principal para selecionar os dados corretos para o relatório conectado, ou podem estar visíveis para o usuário em tempo de execução. O modo como você define o nome do relatório de destino para a ação de detalhamento depende do fato de haver uma conexão ativa com um servidor de relatório. Para obter mais informações, consulte Especificando caminhos para itens externos (Construtor de Relatórios e SSRS).
Também é possível usar Acesso à URL para qualquer relatório endereçável por URL e incluir valores de parâmetros do relatório como parte da sintaxe da URL. Para obter mais informações, consulte Acesso à URL (SSRS).
Definir parâmetros em um sub-relatório
Para definir parâmetros para um sub-relatório, use a página Parâmetros da caixa de diálogo Propriedades do Sub-relatório. O modo como você define o nome do sub-relatório depende do fato de haver uma conexão ativa com um servidor de relatório. Para obter mais informações, consulte Especificando caminhos para itens externos (Construtor de Relatórios e SSRS).
| Observação |
|---|
Se um sub-relatório for usado em uma região de dados tablix, ele e seus parâmetros serão processados para cada linha na região de dados. Se houver muitas linhas, avalie se um relatório detalhado é mais adequado. |
Para obter mais informações, consulte Adicionar um sub-relatório e parâmetros (Construtor de Relatórios e SSRS).
Gerenciar parâmetros em um servidor de relatório ou site do SharePoint
Quando você cria um relatório, os parâmetros de relatório são salvos na definição de relatório. Quando você publica um relatório, os parâmetros de relatório são salvos e gerenciados separadamente da definição de relatório.
Para um relatório publicado, você pode usar o seguinte:
Propriedades de parâmetros de relatório. Altere os valores de parâmetros de relatório diretamente no servidor de relatório, de modo independente da definição de relatório.
**Relatórios armazenados em cache. **Para criar um plano de cache para um relatório, cada parâmetro deve ter um valor padrão. Para obter mais informações, consulte Armazenando relatórios em cache (SSRS).
**Conjuntos de dados compartilhados armazenados em cache. **Para criar um plano de cache para um conjunto de dados compartilhado, cada parâmetro deve ter um valor padrão. Para obter mais informações, consulte Armazenando relatórios em cache (SSRS).
Relatórios vinculados. Você pode criar relatórios vinculados com valores de parâmetro predefinidos para filtrar dados para públicos distintos. Para obter mais informações, consulte Criar um relatório vinculado.
Assinaturas de relatório. Você pode especificar valores de parâmetro para filtrar dados e entregar relatórios através de assinaturas. Para obter mais informações, consulte Assinaturas e entrega (Reporting Services).
Acesso à URL. Você pode especificar valores de parâmetros em uma URL para um relatório. Também é possível executar relatórios e especificar valores de parâmetros usando o acesso à URL. Para obter mais informações, consulte Definir parâmetros em uma URL de relatório.
As propriedades de parâmetros para um relatório publicado são geralmente preservadas se você publicar novamente a definição do relatório. Se a definição do relatório for publicada novamente como o mesmo relatório, e os nomes e tipos de dados dos parâmetros continuarem os mesmos, as configurações de propriedades serão retidas. Se você adicionar ou excluir parâmetros da definição do relatório, ou alterar o tipo de dados ou o nome de um parâmetro existente, poderá ser necessário alterar as propriedades dos parâmetros no relatório publicado.
Nem todos os parâmetros podem ser modificados em todos os casos. Se um parâmetro de relatório obtiver um valor padrão de uma consulta, não será possível modificar esse valor para um relatório publicado. Os valores de parâmetro padrão designados como “Baseado em consulta” são configurados na definição de relatório e não podem ser modificados no servidor de relatório. Um valor de parâmetro baseado em consulta não é um valor constante. O valor usado em tempo de execução é determinado quando a consulta é executada ou, no caso de parâmetros baseados em expressão, quando a expressão é avaliada.
As opções de execução de relatório podem afetar o tipo de processamento dos parâmetros. Um relatório executado como um instantâneo não pode usar parâmetros derivados de uma consulta, a menos que a consulta inclua valores padrão para os parâmetros.
Voltar ao início
Definir 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 pares de nome-valor codificados, usando o caractere de E comercial (&) para separá-los.
Parâmetros nulos. 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 diversos valores. Especifique diversos valores repetindo o nome do parâmetro. Por exemplo:
http://exampleWebServerName/reportserver? %2ffoldercontainingreports%2forders®ion=east®ion=west
Boolean. Use o valor 0 para false ou 1 para true.
Float. Inclua o separador decimal da localidade do servidor.
DateTime. Use o formato AAAA-MM-DDTHH:MM:SS, baseado no padrão ISO (Organização Internacional de Padronização) 8601.
A definição dos valores de parâmetros de relatório é somente uma maneira de usar a sintaxe de acesso de URL para exibir um relatório. Outro exemplo é especificar um parâmetro de URL para exibir um relatório a partir de um número de página específico. O exemplo a seguir abre o relatório de exemplo Catálogo de Produtos 2008 da AdventureWorks2012 na página 30:
http://exampleWebServerName/reportserver? %2fAdventureWorks2012+Sample+Reports%2fProduct+Catalog+2008&rs:Command=Render&rc:Section=30
Para obter mais informações, consulte Referência de parâmetro de acesso de URL.
Voltar ao início
Definir parâmetros para uma assinatura
Você pode definir uma assinatura para um relatório sob demanda ou para um instantâneo e especificar valores de parâmetro a serem usados durante o processamento da assinatura.
Relatório sob demanda. Para um relatório sob demanda, você pode especificar um valor de parâmetro diferente do valor publicado para cada parâmetro listado para o relatório. Por exemplo, suponha que você tenha um relatório Serviço de Chamada que usa um parâmetro Período de Tempo para retornar solicitações de atendimento ao cliente para o dia, semana ou mês atual. Se o valor de parâmetro padrão do relatório for definido como hoje, sua assinatura poderá usar um valor de parâmetro diferente (como semana ou mês) para produzir um relatório com estatísticas semanais ou mensais.
Instantâneo. Para um instantâneo, sua assinatura deve usar os valores de parâmetro definidos para o instantâneo. Sua assinatura não pode substituir um valor de parâmetro que está definido para um instantâneo. Por exemplo, suponha que você esteja assinando um relatório de vendas regional ocidental executado como um instantâneo de relatório e que o instantâneo especifique Ocidental como um valor de parâmetro regional. Nesse caso, se você criar uma assinatura para esse relatório, deverá usar o valor de parâmetro Ocidental em sua assinatura. Para fornecer uma indicação visual de que o parâmetro é ignorado, os campos de parâmetro da página da assinatura são definidos como campos somente leitura.
| Observação |
|---|
As assinaturas controladas por dados podem usar valores de parâmetro obtidos de uma fonte de dados de assinante. Para obter mais informações, consulte Usar uma fonte de dados externa para obter dados de assinante (assinatura controlada por dados). |
Se um valor de parâmetro for alterado no instantâneo de relatório após a definição da assinatura, o servidor de relatório desativará a assinatura. A desativação da assinatura indica que o relatório foi modificado. Abra a assinatura e salve-a para ativá-la.
Para obter mais informações, consulte Assinaturas e entrega (Reporting Services).
Voltar ao início
Definir parâmetros para um instantâneo
As opções de execução de relatório podem afetar o tipo de processamento dos parâmetros. Os relatórios parametrizados executados como instantâneos de relatório usam os valores de parâmetro definidos para o instantâneo de relatório. Os valores de parâmetro estão definidos na página de propriedades de parâmetro do relatório. Um relatório executado como um instantâneo não pode usar parâmetros derivados de uma consulta, a menos que a consulta inclua valores padrão para os parâmetros.
Se você alterar um valor de parâmetro no instantâneo do relatório, as assinaturas para o instantâneo serão desativadas. Abra a assinatura e salve-a para ativá-la.
Para obter mais informações, consulte Desempenho, instantâneos, cache (Reporting Services).
Voltar ao início
Parâmetros e proteção de dados
Tenha cuidado ao distribuir relatórios parametrizados que contêm informações confidenciais. Um usuário pode substituir facilmente um parâmetro de relatório por um valor diferente, resultando na divulgação indevida de informações.
Uma alternativa segura para usar parâmetros para dados de funcionários ou pessoais é selecionar os dados com base nas expressões que incluem o campo UserID da coleção Usuários. A coleção Usuários fornece um meio de obter a identidade do usuário que executa o relatório e de usar essa identidade para recuperar dados específicos do usuário.
.gif "Observação sobre segurança") Observação sobre segurança |
|---|
Em qualquer relatório que contenha um parâmetro do tipo String, use uma lista de valores disponíveis (também conhecida como uma lista de valores válidos) e verifique se todos os usuários que executam o relatório têm as permissões necessárias para exibir os dados do relatório apenas. Quando você define um parâmetro do tipo String, é exibida para o usuário uma caixa de texto que pode ter qualquer valor. Uma lista de valores disponíveis limita os valores que podem ser inseridos. Se o parâmetro do relatório estiver associado a um parâmetro de consulta e uma lista de valores disponíveis não for usada, um usuário do relatório poderá digitar sintaxe SQL na caixa de texto, abrindo potencialmente o relatório e o servidor a um ataque de injeção SQL. Se o usuário tiver permissões suficientes para executar a nova instrução SQL, resultados indesejados podem ser produzidos no servidor. Se um parâmetro de relatório não estiver associado a um parâmetro de consulta e os valores de parâmetro forem incluídos no relatório, um usuário do relatório poderá digitar sintaxe de expressão ou uma URL no valor do parâmetro e renderizar o relatório em Excel ou HTML. Se outro usuário exibir o relatório e clicar no conteúdo do parâmetro renderizado, o usuário poderá executar acidentalmente o script ou link mal-intencionado. Para reduzir o risco de execução acidental de scripts mal-intencionados, só abra relatórios renderizados de fontes confiáveis. Para obter mais informações sobre como proteger relatórios, consulte Proteger relatórios e recursos. |
Voltar ao início
Tópicos de instruções
Esta seção lista procedimentos que mostram, passo a passo, como trabalhar com parâmetros e filtros.
Adicionar, alterar ou excluir um parâmetro de relatório (Construtor de Relatórios e SSRS)
Alterar a ordem de um parâmetro de relatório (Construtor de Relatórios e SSRS)
Adicionar parâmetros em cascata a um relatório (Construtor de Relatórios e SSRS)
Adicionar um filtro a um conjunto de dados (Construtor de Relatórios e SSRS)
Voltar ao início
Seções relacionadas
Uso de expressões em relatórios (Construtor de Relatórios e SSRS)
Expressões (Construtor de Relatórios e SSRS)
Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS)
Segurança (Construtor de Relatórios)
Voltar ao início
Consulte também
Conceitos
Classificação interativa, mapas de documentos e links (Construtor de Relatórios e SSRS)