Expressões num relatório paginado (Construtor de Relatórios)

Aplica-se a: Construtor de Relatórios da Microsoft (SSRS) Designer de Relatórios do Power BI no SQL Server Data Tools

As expressões são amplamente utilizadas em relatórios paginados para recuperar, calcular, exibir, agrupar, ordenar, filtrar, parametrizar e formatar dados.

Muitas propriedades de item de relatório podem ser definidas como uma expressão. As expressões ajudam a controlar o conteúdo, o design e a interatividade do relatório. As expressões são escritas no Microsoft Visual Basic, salvas na definição de relatório e avaliadas pelo processador de relatório quando você executa o relatório.

Ao contrário de aplicações como o Microsoft Office Excel, onde trabalha diretamente com dados numa folha de cálculo, num relatório trabalha com expressões que são marcadores de posição para dados. Para ver os dados reais das expressões avaliadas, você deve visualizar o relatório. Quando você executa o relatório, o processador de relatório avalia cada expressão, pois combina dados de relatório e elementos de layout de relatório, como tabelas e gráficos.

À medida que você cria um relatório, muitas expressões para itens de relatório são definidas para você. Por exemplo, quando você arrasta um campo do painel de dados para uma célula da tabela na superfície de design do relatório, o valor da caixa de texto é definido como uma expressão simples para o campo. Na figura seguinte, o painel de Dados do Relatório mostra os campos do conjunto de dados ID, Nome, Território de Vendas, Código e Vendas. Três campos foram adicionados à tabela: [Nome], [Código] e [Vendas]. A notação [Name] na superfície de projeto representa a expressão subjacente =Fields!Name.Value.

rs_DataDesignandPreview

Quando você visualiza o relatório, o processador de relatório combina a região de dados da tabela com os dados reais da conexão de dados e exibe uma linha na tabela para cada linha do conjunto de resultados.

Para inserir expressões manualmente, selecione um item na superfície de design e use menus de atalho e caixas de diálogo para definir as propriedades do item. Quando você vê o botão (fx) ou o valor <Expression> em uma lista suspensa, sabe que pode definir a propriedade como uma expressão. Para mais informações, consulte Adicionar uma Expressão (Construtor de Relatórios e SSRS).

Para desenvolver expressões complexas ou expressões que utilizem código personalizado ou assemblies personalizados, recomendamos que utilize o Report Designer no SQL Server Data Tools (SSDT). Para mais informações, consulte Código Personalizado e Referências de Montagem em Expressões no Designer de Relatórios (SSRS).

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, no Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Compreender Expressões Simples e Complexas

As expressões começam com um sinal de igual (=) e são escritas no Microsoft Visual Basic. As expressões podem incluir uma combinação de constantes, operadores e referências a valores internos (campos, coleções e funções) e a código externo ou personalizado.

Você pode usar expressões para especificar o valor de muitas propriedades de item de relatório. As propriedades mais comuns são valores para caixas de texto e texto de espaço reservado. Normalmente, se uma caixa de texto contiver apenas uma expressão, a expressão será o valor da propriedade da caixa de texto. Se uma caixa de texto contiver várias expressões, cada expressão será o valor do texto de espaço reservado na caixa de texto.

Por defeito, as expressões aparecem na superfície do desenho do relatório como expressões simples ou complexas.

Simples Uma expressão simples contém uma referência a um único item numa coleção incorporada, por exemplo, um campo de conjunto de conjuntos, um parâmetro ou um campo incorporado. Na superfície de design, uma expressão simples aparece entre parênteses. Por exemplo, [FieldName] corresponde à expressão =Fields!FieldName.Valuesubjacente . Expressões simples são criadas automaticamente para si à medida que cria o layout do relatório e arrasta os itens do painel de Dados do Relatório para a superfície do design. Para mais informações sobre os símbolos que representam diferentes coleções incorporadas, consulte Compreensão de Símbolos de Prefixo para Expressões Simples.
Complexo Uma expressão complexa contém referências a múltiplas referências incorporadas, operadores e chamadas de função. Uma expressão complexa aparece como <<Expr>> quando o valor da expressão inclui mais do que uma simples referência. Para visualizar a expressão, passe o mouse sobre ela e use a dica de ferramenta. Para editar a expressão, abra-a na caixa de diálogo Expressão .

A figura a seguir mostra expressões simples e complexas típicas para caixas de texto e texto de espaço reservado.

rs_ExpressionDefaultFormat

Para exibir valores de exemplo em vez de texto para expressões, aplique formatação à caixa de texto ou ao texto do espaço reservado. A figura a seguir mostra a superfície de design do relatório alternada para mostrar valores de exemplo:

rs_ExpressionSampleValuesFormat

Para mais informações, consulte Texto de Formatação e Espaços Reservados (Construtor de Relatórios e SSRS).

Compreensão de Símbolos de Prefixo em Expressões Simples

Expressões simples usam símbolos para indicar se a referência é para um campo, um parâmetro, uma coleção incorporada ou a coleção ReportItems. A tabela a seguir mostra exemplos de texto de exibição e expressão:

Item	Exemplo de texto de exibição	Exemplo de texto de expressão
Campos do conjunto de dados	`[Sales]` `[SUM(Sales)]` `[FIRST(Store)]`	`=Fields!Sales.Value` `=Sum(Fields!Sales.Value)` `=First(Fields!Store.Value)`
Parâmetros do relatório	`[@Param]` `[@Param.Label]`	`=Parameters!Param.Value` `=Parameters!Param.Label`
Campos incorporados	`[&ReportName]`	`=Globals!ReportName.Value`
Caracteres literais usados para texto de exibição	`\[Sales\]`	`[Sales]`

Escrita de Expressões Complexas

As expressões podem incluir referências a funções, operadores, constantes, campos, parâmetros, itens de coleções internas e a código personalizado incorporado ou assemblies personalizados.

Observação

Para desenvolver expressões complexas ou expressões que utilizem código personalizado ou assemblies personalizados, recomendamos que utilize o Report Designer no SQL Server SQL Server Data Tools (SSDT). Para mais informações, consulte Código Personalizado e Referências de Montagem em Expressões no Designer de Relatórios (SSRS).

A tabela a seguir lista os tipos de referências que você pode incluir em uma expressão:

Referências	Description	Example
Constantes	Descreve as constantes que você pode acessar interativamente para propriedades que exigem valores constantes, como cores de fonte.	`="Blue"`
Operators	Descreve os operadores que você pode usar para combinar referências em uma expressão. Por exemplo, o operador & é usado para concatenar cadeias de caracteres.	`="The report ran at: " & Globals!ExecutionTime & "."`
Coleções Incorporadas	Descreve as coleções internas que você pode incluir em uma expressão, como `Fields`, `Parameters`e `Variables`.	`=Fields!Sales.Value` `=Parameters!Store.Value` `=Variables!MyCalculation.Value`
Relatórios e Funções Agregadas Incorporadas	Descreve as funções internas, como `Sum` ou `Previous`, que você pode acessar a partir de uma expressão.	`=Previous(Sum(Fields!Sales.Value))`
Código Personalizado e Referências de Montagem em Expressões no Designer de Relatórios (SSRS)	Descreve como você pode acessar as classes Math CLR internas e Convert, outras classes CLR, funções de biblioteca de tempo de execução do Visual Basic ou métodos de um assembly externo. Descreve como você pode acessar o código personalizado incorporado em seu relatório ou que você compila e instala como um assembly personalizado no cliente de relatório e no servidor de relatório.	`=Sum(Fields!Sales.Value)` `=CDate(Fields!SalesDate.Value)` `=DateAdd("d",3,Fields!BirthDate.Value)` `=Code.ToUSD(Fields!StandardCost.Value)`

Validação de Expressões

Quando você cria uma expressão para uma propriedade de item de relatório específica, as referências que você pode incluir em uma expressão dependem dos valores que a propriedade do item de relatório pode aceitar e do escopo no qual a propriedade é avaliada. Por exemplo:

Por defeito, a expressão [Soma] calcula a soma dos dados que estão no âmbito no momento em que a expressão é avaliada. Para uma célula de tabela, o escopo depende das associações de grupo de linhas e colunas. Para mais informações, consulte Escopo de Expressão para Totais, Agregados e Coleções Incorporadas (Construtor de Relatórios e SSRS).
Para o valor de uma propriedade Font, o valor deve corresponder ao nome de uma fonte.
A sintaxe da expressão é validada em tempo de design. A validação do escopo da expressão ocorre quando você publica o relatório. Para validação que depende dos dados reais, os erros só podem ser detetados em tempo de execução. Algumas destas expressões produzem #Error como uma mensagem de erro no relatório renderizado. Para ajudar a determinar os problemas deste tipo de erro, deve usar o Designer de Relatórios nas Ferramentas de Dados do SQL Server (SSDT). O Designer de Relatórios fornece uma janela de Saída que fornece mais informações sobre estes erros.

Para mais informações, consulte Referência de Expressão (Construtor de Relatórios e SSRS).