Parâmetros (Report Builder 3.0 e SSRS)

Neste artigo

Usos comuns de parâmetros

Tipos de parâmetros

Trabalhando com parâmetros de relatório

Trabalhando com parâmetros de conjunto de dados

Parâmetros em cascata

Transmitindo parâmetros para detalhamento ou sub-relatórios

Gerenciando parâmetros em um servidor de relatório do site do SharePoint

Nesta seção

Tópicos relacionados

Usos comuns de parâmetros

Estas são as formas mais comuns de usar parâmetros:

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

• 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 outro usa valores de parâmetro predefinidos para gerentes de vendas. Os dois relatórios usam a mesma definição de relatório.

• Permita aos usuários filtrar 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.

Voltar ao início

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 Trabalhando com parâmetros de conjunto 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 Trabalhando com 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 estão disponíveis 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 3.0).

Com muita frequência, você trabalhará com parâmetros de relatório.

Voltar ao início

Trabalhando com 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.

Por padrão, os parâmetros criados automaticamente usam um nome, um aviso e um tipo de dados também gerados automaticamente. É possível alterar as propriedades de parâmetros de relatório no painel 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.
Perguntar	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: Text, Integer, Float, DateTime, Boolean. O tipo de dados determina a forma como um parâmetro de relatório é exibido na barra de ferramentas do visualizador de relatórios. O tipo de dados também pode ser importante quando você escrever expressões que incluam uma referência ao parâmetro.
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 um espaço em branco automaticamente nos 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 vários 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 vários valores exibidos em uma lista suspensa. Valores nulos não são permitidos. Quando esta 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 esta opção para ocultar o parâmetro de relatório no relatório. Os valores de parâmetro de relatório podem ser definidos em uma URL de relatório, em uma definição de assinatura ou no servidor de relatório com o uso do Gerenciador de Relatórios.
Interno	Selecione esta opção para ocultar o parâmetro de relatório. 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. Observação sobre segurança Em qualquer relatório que contenha um parâmetro do tipo de dados Text, 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 somente as permissões necessárias para exibir os dados do relatório. Para obter mais informações, consulte Segurança (Construtor de Relatórios 3.0).
Valores padrão	Defina os valores padrão de uma consulta ou de 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 um valor que indique se o parâmetro em questão afeta direta ou indiretamente os dados de um relatório. No servidor de relatório, esse valor é usado para determinar opções de cache para os relatórios e seus dados. Para obter mais informações, consulte Caixa de diálogo Propriedades do Parâmetro do Relatório, Avançado (Construtor de Relatórios 3.0).

Voltar ao início

Trabalhando com parâmetros de conjunto de dados

Os parâmetros de consulta são definidos quando você compila uma consulta em um criador 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 aos usuários 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 Adicionando dados a um relatório (Report Builder 3.0 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 3.0).

• 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 3.0) 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 Como adicionar parâmetros em cascata a um relatório (Construtor de Relatórios 3.0 e SSRS).

Voltar ao início

Transmitindo parâmetros para detalhamento e sub-relatórios

Os parâmetros são usados para conectar relatórios a sub-relatórios e relatórios de detalhamento. 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.

Para obter mais informações, consulte Usando parâmetros para conectar-se com outros relatórios (Construtor de Relatórios 3.0 e SSRS).

Gerenciando parâmetros em um servidor de relatório ou no site do SharePoint

Após a publicação de um relatório, os parâmetros podem ser gerenciados independentemente da definição do relatório. Dependendo de como o parâmetro é configurado no relatório no tempo de design, os administradores do servidor de relatório podem modificar muitas propriedades de parâmetros para um relatório ou conjunto de dados compartilhado. Se você estiver criando um relatório que pretende agendar para armazenamento em cache ou assinaturas, talvez haja requisitos adicionais que se aplicam a eles. Para obter mais informações, consulte os tópicos a seguir na documentação do Reporting Services nos Manuais Online do SQL Server.

• **Relatórios armazenados em cache.  ** Para criar um plano de cache para um relatório, cada parâmetro deverá ter um valor padrão. Para obter mais informações, consulte Cache de relatório no Reporting Services.

• **Conjuntos de dados armazenados em cache.   **Para criar um plano de cache para um conjunto de dados compartilhado, cada parâmetro deverá ter um valor padrão. Para obter mais informações, consulte Cache de relatório no Reporting Services.

• 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 Adicionando, modificando e excluindo relatórios vinculados.

• 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 Definindo parâmetros em uma assinatura e Assinatura e entrega (Reporting Services).

• Acesso à URL.   Você pode especificar valores em uma URL para um relatório. Também é possível executar relatórios e especificar valores de parâmetros com acesso à URL. Para obter mais informações, consulte Acesso à URL.

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.

• Como adicionar, alterar ou excluir um parâmetro de relatório (Construtor de Relatórios 3.0 e SSRS)

• Como adicionar, alterar ou excluir valores disponíveis para um parâmetro de relatório (Construtor de Relatórios 3.0 e SSRS)

• Como adicionar, alterar ou excluir valores padrão de um parâmetro de relatório (Construtor de Relatórios 3.0 e SSRS)

• Com alterar a ordem de um parâmetro de relatório (Construtor de Relatórios 3.0 e SSRS)

• Como adicionar parâmetros em cascata a um relatório (Construtor de Relatórios 3.0 e SSRS)

• Como adicionar um filtro a um conjunto de dados (Construtor de Relatórios 3.0 e SSRS)

Voltar ao início

Nesta seção

Usando parâmetros de valor único e de vários valores (Construtor de Relatórios 3.0 e SSRS)

Usando parâmetros para conectar-se com outros relatórios (Construtor de Relatórios 3.0 e SSRS)

Voltar ao início

Seções relacionadas

Usando referências de coleções de parâmetros (Construtor de Relatórios 3.0 e SSRS)

Usando expressões (Construtor de Relatórios 3.0 e SSRS)

Expressões (Construtor de Relatórios 3.0 e SSRS)

Caixa de diálogo Propriedades do Parâmetro do Relatório, Geral (Construtor de Relatórios 3.0)

Caixa de diálogo Propriedades de Parâmetros do Relatório, Geral

Caixa de diálogo Propriedades do Conjunto de Dados, Consulta (Construtor de Relatórios 3.0)

Caixa de diálogo Propriedades do Conjunto de Dados, Consulta

Designers de Consulta (Construtor de Relatórios 3.0)

Designers de Consulta do Reporting Services

Segurança (Construtor de Relatórios 3.0)

Voltar ao início

Consulte também

Conceitos