Expressões no Construtor de Relatórios do Power BI

APLICA-SE A: Power BI Report Builder Power BI Desktop

As expressões são amplamente usadas nos relatórios paginados do Power BI Report Builder para recuperar, calcular, exibir, agrupar, classificar, filtrar, parametrizar e formatar dados.

Várias propriedades de item de relatório podem ser definidas para uma expressão. Expressões ajudam a controlar o conteúdo, o design e a interatividade do seu 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 aplicativos como o Microsoft Excel, em que você trabalha com os dados diretamente em uma planilha, em um relatório você trabalha com expressões que são espaços reservados para os dados. Para ver os dados reais das expressões avaliadas, visualize 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, tais como tabelas e gráficos.

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

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 no 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ê visualiza o botão (fx) ou o valor <Expression> em uma lista suspensa, sabe que pode definir a propriedade como uma expressão.

Reconhecer expressões simples e complexas

As expressões começam com um sinal de igual (=) e são escritas no Microsoft Visual Basic. Elas podem incluir uma combinação de constantes, operadores e referências para valores internos (campos, coleções e funções) e para o 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 do espaço reservado. Normalmente, se uma caixa de texto contiver só uma expressão, a expressão será o valor da propriedade de caixa de texto. Se uma caixa de texto contiver várias expressões, cada expressão será o valor de texto do espaço reservado na caixa de texto.

Por padrão, as expressões aparecem na área de design do relatório como expressões simples ou complexas.

• Simples: uma expressão simples contém uma referência a um único item em uma coleção interna, por exemplo, um campo de conjunto de dados, um parâmetro ou um campo interno. Na superfície de design, uma expressão simples aparece entre colchetes. Por exemplo, [FieldName] corresponde à expressão subjacente =Fields!FieldName.Value. Expressões simples são criadas automaticamente quando você cria o layout do relatório e arrasta itens do painel Dados de Relatório para a área de design. Para obter mais informações sobre os símbolos que representam diferentes coleções internas, confira Reconhecer símbolos de prefixo para expressões simples.

• Complexas: uma expressão complexa contém referências a vários operadores, chamadas de função e referências internas. Uma expressão complexa aparece como <<Expr>> quando o valor da expressão inclui mais de uma referência simples. Para exibir 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 do espaço reservado.

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

Reconhecer símbolos de prefixo em expressões simples

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

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

Gravar expressões complexas

Expressões podem incluir referências a funções, operadores, constantes, campos, parâmetros, itens das coleções internas, e ao código personalizado interno ou assemblies personalizados.

A seguinte tabela lista os tipos de referências que podem ser incluídos em uma expressão:

Referências	Descrição	Exemplo
Constantes	Descreve as constantes acessadas interativamente para propriedades que exigem valores de constantes, tais como cores de fontes.	="Blue"
Operadores	Descreve os operadores a serem usados 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 internas	Descreve as coleções internas que podem ser incluídas em uma expressão, tais como Fields, Parameterse Variables.	=Fields!Sales.Value =Parameters!Store.Value =Variables!MyCalculation.Value
Relatório interno e funções de agregação	Descreve as funções internas, tais como Sum ou Previous, que podem ser acessadas de uma expressão.	=Previous(Sum(Fields!Sales.Value))
Referências a assembly e código personalizado em expressões no Construtor de Relatórios	Descreve como você pode acessar as classes de CLR internas xref:System.Math e xref:System.Convert, outras classes de CLR, funções de biblioteca em tempo de execução do Visual Basic ou métodos de um assembly externo. Descreve como é possível acessar o código personalizado que é inserido no relatório, ou que é compilado e instalado 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)

Validar expressões

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

• Por padrão, a expressão [Sum] calcula a soma dos dados que estão no escopo 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 o valor de uma propriedade Fonte, o valor deve ser avaliado como o nome de uma fonte.

• A sintaxe da expressão é validada no tempo de design. A validação do escopo da expressão ocorre quando você publica o relatório. Para a validação que depende dos dados reais, erros só podem ser detectados no tempo de execução. Algumas dessas expressões geram #Error como uma mensagem de erro no relatório renderizado.

Próximas etapas

• O que são relatórios paginados no Power BI?