Artigo
04/01/2012

Parâmetros (Report Builder 3.0 e SSRS)

Os parâmetros de relatório permitem controlar os dados de relatório, conectar relatórios relacionados juntos e variar a apresentação do relatório. Para criar um relatório que use parâmetros com eficiência, é necessário entender como os parâmetros e as consultas a conjunto de dados estão relacionados, como incluir os parâmetros em expressões e como gerenciar os parâmetros de forma independente em uma definição de relatório no servidor de relatório ou site do SharePoint.

Você pode criar os parâmetros de relatório das seguintes maneiras:

Criar ou adicionar um conjunto de dados, inserido ou compartilhado, que tenha uma consulta que contém variáveis de consulta.
Criar um parâmetro manualmente do painel Dados do Relatório.
Adicionar uma parte de relatório que contém referências a um parâmetro ou a um conjunto de dados compartilhado que contém variáveis.

Após publicar um relatório, você pode gerenciar os parâmetros independentemente da definição do relatório. Você pode até mesmo criar vários conjuntos de parâmetros para o mesmo relatório. Para obter mais informações, consulte Definindo propriedades de parâmetro para um relatório publicado e Adicionando, modificando e excluindo relatórios vinculados.

A barra de ferramentas do visualizador de relatórios exibe cada parâmetro de forma que um usuário possa especificar valores interativamente. A ilustração a seguir mostra a área do parâmetro para um relatório com os parâmetros @StartDate, @EndDate, @Subcategory e @ShowAllRows.

Parâmetros na barra de ferramentas do visualizador de relatório

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 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 vários 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 Report Builder, 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: adicionando um parâmetro ao relatório (Construtor de Relatórios 3.0), Tutorial: Adicionando parâmetros a um relatório (SSRS) ou Report Samples (Report Builder 3.0 and SSRS) (em inglês)

Observação
Parâ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 os parâmetros sejam listados como uma parte de relatório, você não pode adicionar um parâmetro de parte de relatório diretamente a um relatório. Em vez disso, adicione a parte de relatório e os parâmetros de relatório necessários são gerados automaticamente a partir de consultas de conjuntos de dados que são contidos ou referenciados pela parte do relatório. Para obter mais informações sobre partes de relatório, consulte Partes de relatório (Construtor de Relatórios 3.0) e Partes de relatório no Designer de Relatórios (SSRS).

Parâ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 os parâmetros sejam listados como uma parte de relatório, você não pode adicionar um parâmetro de parte de relatório diretamente a um relatório. Em vez disso, adicione a parte de relatório e os parâmetros de relatório necessários são gerados automaticamente a partir de consultas de conjuntos de dados que são contidos ou referenciados pela parte do relatório. Para obter mais informações sobre partes de relatório, consulte Partes de relatório (Construtor de Relatórios 3.0) e Partes de relatório no Designer de Relatórios (SSRS).

Observação
É possível criar e modificar definições de relatórios (.rdl) no Report Builder 3.0 e no Designer de Relatórios no Business Intelligence Development Studio. Cada ambiente de criação fornece diferentes maneiras de criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Projetando e implementando relatórios usando o Designer de Relatórios (Reporting Services) na Web em microsoft.com.

É possível criar e modificar definições de relatórios (.rdl) no Report Builder 3.0 e no Designer de Relatórios no Business Intelligence Development Studio. Cada ambiente de criação fornece diferentes maneiras de criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Projetando e implementando relatórios usando o Designer de Relatórios (Reporting Services) na Web em microsoft.com.

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.

Ícone de seta usado com o link Voltar ao Início 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.

Ícone de seta usado com o link Voltar ao Início 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).

Ícone de seta usado com o link Voltar ao Início 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.

Ícone de seta usado com o link Voltar ao Início 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).

Ícone de seta usado com o link Voltar ao Início 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.