Compartilhar via

  • Artigo

Usando expressões (Construtor de Relatórios 2.0)

No Reporting Services, as expressões são usadas em toda a definição de relatório para especificar ou calcular valores para parâmetros, consultas, filtros, propriedades de itens de relatório, definições de classificação e grupo, propriedades de caixa de texto, indicadores, mapas do documento, conteúdo de cabeçalho e rodapé de página dinâmica, imagens e definições de fonte de dados dinâmica. Este tópico contém exemplos dos muitos lugares em que você pode usar expressões para variar o conteúdo ou a aparência de um relatório. Esta lista não é completa. Você pode definir uma expressão para qualquer propriedade em uma caixa de diálogo que exiba o botão de expressão (fx) ou em uma lista suspensa que exiba <Expressão...>.

As expressões podem ser simples ou complexas. As expressões simples contêm uma referência a um único campo de conjunto de dados, parâmetro ou campo interno. As expressões complexas podem conter várias referências internas, operadores e chamadas de função. Por exemplo, uma expressão complexa pode incluir a função Sum aplicada ao campo Sales.

As expressões são gravadas no MicrosoftVisual Basic. Uma expressão começa com um sinal de igual (=) seguido por uma combinação de referências a coleções internas, como campos de conjunto de dados e parâmetros, constantes, funções e operadores.

Usando expressões simples

As expressões simples aparecem na superfície de design e em caixas de diálogo entre colchetes; por exemplo, um campo de conjunto de dados é exibido como [ProductID]. As expressões simples são criadas automaticamente quando você arrasta um campo de um conjunto de dados até uma caixa de texto. É criado um espaço reservado, e a expressão define o valor subjacente. Você também pode digitar expressões diretamente em uma célula da região de dados ou em uma caixa de texto, ambas na superfície de design ou em uma caixa de diálogo (por exemplo, [ProductID]).

A tabela a seguir lista exemplos de como usar expressões simples. A tabela descreve a funcionalidade, a propriedade a ser definida, a caixa de diálogo que você costuma usar para defini-la e o valor da propriedade. É possível digitar a expressão simples diretamente na superfície de design, em uma caixa de diálogo ou no painel Propriedades, ou ainda editá-la na caixa de diálogo Expressão, exatamente como você faria com qualquer expressão.

Funcionalidade

Propriedade, contexto e caixa de diálogo

Valor da propriedade

Especifique um campo de conjunto de dados a ser exibido em uma caixa de texto.

A propriedade Value de um espaço reservado dentro de uma caixa de texto. Use a Caixa de diálogo Propriedades do Espaço Reservado, Geral (Construtor de Relatórios 2.0).

[Sales]

Agregue valores para um grupo.

A propriedade Value de um espaço reservado dentro de uma linha associada a um grupo Tablix. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral (Construtor de Relatórios 2.0).

[Sum(Sales)]

Inclua um número de página.

A propriedade Value de um espaço reservado dentro de uma caixa de texto que é colocada em um cabeçalho de página. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral (Construtor de Relatórios 2.0).

[&PageNumber]

Exiba um valor de parâmetro selecionado.

A propriedade Value de um espaço reservado dentro de uma caixa de texto na superfície de design. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral (Construtor de Relatórios 2.0).

[@SalesThreshold]

Especifique uma definição de grupo para uma região de dados.

Expressão de grupo no grupo tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Geral (Construtor de Relatórios 2.0).

[Category]

Exclua de uma tabela um valor de campo específico.

Equação de filtro no tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros (Construtor de Relatórios 2.0).

Para tipo de dados, selecione Inteiro.

[Quantity]

>

100

Inclua somente um valor específico para um filtro de grupo.

Equação de filtro no grupo tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Filtros (Construtor de Relatórios 2.0).

[Category]

=

Clothing

Exclua de um conjunto de dados valores específicos de mais de um campo.

Equação de filtro para um grupo em um tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros (Construtor de Relatórios 2.0).

=[Color]

<>

Red

=[Color]

<>

Blue

Especifique a ordem de classificação com base em um campo existente em uma tabela.

Expressão de classificação no tablix. Use a Caixa de diálogo Propriedades do Tablix, Classificação (Construtor de Relatórios 2.0).

[SizeSortOrder]

Vincule um parâmetro de consulta a um parâmetro de relatório.

Coleção de parâmetros no conjunto de dados. Use a Caixa de diálogo Propriedades do Conjunto de Dados, Parâmetros (Construtor de Relatórios 2.0).

[@Category]

[@Category]

Passe um parâmetro de um relatório principal para um sub-relatório.

Coleção de parâmetros no sub-relatório. Use a Caixa de diálogo Propriedades do Sub-relatório, Parâmetros (Construtor de Relatórios 2.0).

[@Category]

[@Category]

Para ver mais exemplos, consulte Exemplos de expressão (Construtor de Relatórios 2.0).

Usando expressões complexas

As expressões complexas podem conter várias referências internas, operadores e chamadas de função e são exibidas na superfície de design como <<Expr>>. Para ver ou alterar o texto da expressão, abra a caixa de diálogo Expressão ou digite diretamente no painel Propriedades. A tabela a seguir lista maneiras comuns de usar uma expressão complexa para exibir ou organizar dados ou alterar a aparência de um relatório, inclusive a propriedade a ser definida, a caixa de diálogo que você costuma usar para defini-la e o valor da propriedade. Você pode digitar uma expressão diretamente em uma caixa de diálogo, na superfície de design ou no painel Propriedades.

Funcionalidade

Propriedade, contexto e caixa de diálogo

Valor da propriedade

Calcule valores agregados para um conjunto de dados.

A propriedade Value de um espaço reservado dentro de uma caixa de texto. Use a Caixa de diálogo Propriedades do Espaço Reservado, Geral (Construtor de Relatórios 2.0).

=First(Fields!Sales.Value,"DataSet1")

Concatene texto e expressões na mesma caixa de texto.

A propriedade Value de um espaço reservado dentro de uma caixa de texto que é colocada em um cabeçalho ou rodapé de página. Use a Caixa de diálogo Propriedades do Tablix, Filtros (Construtor de Relatórios 2.0).

="This report began processing at " & Globals!ExecutionTime

Calcule um valor agregado para um conjunto de dados em outro escopo.

O Value de um espaço reservado dentro de uma caixa de texto que é colocada em um grupo tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros (Construtor de Relatórios 2.0).

=Max(Fields!Total.Value,"DataSet2)

Formate os dados de uma caixa de texto de acordo com o valor.

A Color de um espaço reservado dentro de uma caixa de texto na linha de detalhes de um tablix. Use a Caixa de diálogo Propriedades da Caixa de Texto, Fonte (Construtor de Relatórios 2.0).

=IIF(Fields!TotalDue.Value < 10000,"Red","Black")

Calcule um valor uma única vez para fazer referência a ele em todo o relatório.

Value de uma variável de relatório. Use a Caixa de diálogo Propriedades do Relatório, Variáveis (Construtor de Relatórios 2.0).

Para obter mais informações sobre variáveis, consulte Usando referências de coleções de variáveis de grupo e de relatório em expressões (Construtor de Relatórios 2.0).

=Variables!MyCalculation.Value

Inclua valores específicos de mais de um campo de um conjunto de dados.

Equação de filtro para um grupo em um tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros (Construtor de Relatórios 2.0).

Para tipo de dados, selecione Booleano.

=IIF(InStr(Fields!Subcat.Value,"Shorts")=0 AND (Fields!Size.Value="M" OR Fields!Size.Value="S"),TRUE, FALSE)

=

TRUE

Oculte uma caixa de texto na superfície de design que pode ser alternada pelo usuário através de um parâmetro booleano denominado Show.

Hiddenpropriedade em uma caixa de texto. Use a Caixa de diálogo Propriedades da Caixa de Texto, Visibilidade (Construtor de Relatórios 2.0).

=Not Parameters!Show<boolean parameter>.Value

Especifique um cabeçalho de página dinâmico ou o conteúdo de um rodapé.

Value de um espaço reservado dentro de uma caixa de texto que é colocada no cabeçalho ou rodapé de uma página. Use a Caixa de diálogo Propriedades do Tablix, Filtros (Construtor de Relatórios 2.0).

="Page " & Globals!PageNumber & " of " & Globals!TotalPages

Especifique uma fonte de dados dinamicamente usando um parâmetro.

Cadeia de conexão na fonte de dados. Use a Caixa de diálogo Propriedades da Fonte de Dados, Geral (Construtor de Relatórios 2.0).

="Data Source=" & Parameters!ServerName.Value & ";initial catalog=AdventureWorks"

Identifique todos os valores para um parâmetro multivalor escolhido pelo usuário.

O Value de um espaço reservado dentro de uma caixa de texto. Use a Caixa de diálogo Propriedades do Tablix, Filtros (Construtor de Relatórios 2.0).

=Join(Parameters!MyMultivalueParameter.Value,", ")

Especifique quebras de página para cada 20 linhas em um tablix sem nenhum outro grupo.

Expressão de grupo para um grupo em um tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Geral (Construtor de Relatórios 2.0).

PageBreak para o grupo no Tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Quebras de Página (Construtor de Relatórios 2.0). Defina Entre cada instância de um grupo.

=Ceiling(RowNumber(Nothing)/20)

Especifique a visibilidade condicional com base em um parâmetro.

A propriedade Hidden de um tablix. Use a Caixa de diálogo Propriedades do Tablix, Visibilidade (Construtor de Relatórios 2.0).

=Not Parameters!<boolean parameter>.Value

Especifique uma data formatada para uma cultura específica.

Value de um espaço reservado dentro de uma caixa de texto em uma região de dados. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral (Construtor de Relatórios 2.0).

=Fields!OrderDate.Value.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("de-DE"))

Concatene uma cadeia de caracteres e um número formatado como porcentagem com duas casas decimais.

Value de um espaço reservado dentro de uma caixa de texto em uma região de dados. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral (Construtor de Relatórios 2.0).

="Growth Percent: " & Format(Fields!Growth.Value,"p2")

Para ver mais exemplos, consulte Exemplos de expressão (Construtor de Relatórios 2.0).