Uso de expressões em relatórios paginados (Power BI Report Builder)
APLICA-SE A:
Power BI Report Builder 
Power BI Desktop
Nos relatórios paginados do Power BI, as expressões são utilizadas em toda a definição do relatório para especificar ou calcular valores para parâmetros, consultas, filtros, propriedades de itens do relatório, definições de grupo e classificação, propriedades de caixa de texto, marcadores, mapas de documentos, conteúdo e imagens dinâmicos de cabeçalho e rodapé de página. 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. Essa lista não é abrangente. Defina uma expressão para qualquer propriedade em uma caixa de diálogo que exibe o botão de expressão (fx) ou em uma lista suspensa que exibe <Expression...>.
As expressões podem ser simples ou complexas. Asexpressõ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 escritas no Microsoft Visual 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.
Use 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. Também é possível digitar expressões diretamente em uma célula da região de dados ou em uma caixa de texto, tanto na superfície de design quanto 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. | Propriedade Value de um espaço reservado dentro de uma caixa de texto. Use Caixa de Diálogo de Propriedades de Espaço Reservado, Geral. | [Sales] |
| Agregue valores de um grupo. | Propriedade Value de um espaço reservado dentro de uma linha associada a um grupo Tablix. Use Caixa de Diálogo de Propriedades de Caixa de Texto. | [Sum(Sales)] |
| Inclua um número de página. | Propriedade Value de um espaço reservado dentro de uma caixa de texto que é colocada em um cabeçalho de página. Use Caixa de Diálogo Propriedades de Caixa de Texto, Geral. | [&PageNumber] |
| Exiba um valor de parâmetro selecionado. | Propriedade Value de um espaço reservado dentro de uma caixa de texto na superfície de design. Use Caixa de Diálogo Propriedades de Caixa de Texto, Geral. | [@SalesThreshold] |
| Especifique uma definição de grupo para uma região de dados. | Expressão de grupo no grupo Tablix. Use Caixa de Diálogo de Propriedades de Grupo Tablix, Geral. | [Category] |
| Exclua de uma tabela um valor de campo específico. | Equação de filtro no tablix. Use Caixa de Diálogo de Propriedades de Grupo Tablix, Filtros. | 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 Caixa de Diálogo de Propriedades de Grupo Tablix, Filtros. | [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 Caixa de Diálogo de Propriedades de Grupo Tablix, Filtros. | =[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 Caixa de Diálogo de Propriedades Tablix, Classificação. | [SizeSortOrder] |
| Vincule um parâmetro de consulta a um parâmetro de relatório. | Coleção de parâmetros no conjunto de dados. Use Caixa de Diálogo Propriedades de Conjunto de Dados, Parâmetros. | [@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 Caixa de Diálogo Propriedades de Sub-relatório, Parâmetros. | [@Category][@Category] |
Use 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 de agregação para um conjunto de dados. | Propriedade Value de um espaço reservado dentro de uma caixa de texto. Use Caixa de Diálogo de Propriedades de Espaço Reservado, Geral. | =First(Fields!Sales.Value,"DataSet1") |
| Concatene texto e expressões na mesma caixa de texto. | Valor de um espaço reservado dentro de uma caixa de texto que é colocada em um cabeçalho ou rodapé de página. Use Caixa de Diálogo de Propriedades de Espaço Reservado, Geral. | ="This report began processing at " & Globals!ExecutionTime |
| Calcule um valor de agregação para um conjunto de dados em outro escopo. | Valor de um espaço reservado dentro de uma caixa de texto que é colocada em um grupo tablix. Use Caixa de Diálogo de Propriedades de Espaço Reservado, Geral. | =Max(Fields!Total.Value,"DataSet2") |
| Formate os dados de uma caixa de texto de acordo com o valor. | Cor de um espaço reservado dentro de uma caixa de texto na linha de detalhes de um tablix. Use Caixa de Diálogo Propriedades de Caixa de Texto, Fonte. | =IIF(Fields!TotalDue.Value < 10000,"Red","Black") |
| Calcule um valor uma única vez para fazer referência a ele em todo o relatório. | Valor de uma variável de relatório. Use Caixa de Diálogo Propriedades de Relatório, Variáveis. | =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 Caixa de Diálogo de Propriedades de Grupo Tablix, Filtros. | Para o tipo de dados, selecione Booliano.=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 usando um parâmetro booliano nomeado Show. | Propriedade oculta em uma caixa de texto. Use Caixa de Diálogo de Propriedades de Caixa de Texto, Visibilidade. | =Not Parameters!Mostrar<parâmetro booliano>.Value |
| Especifique um cabeçalho de página dinâmico ou o conteúdo de um rodapé. | Valor de um espaço reservado dentro de uma caixa de texto que é colocada no cabeçalho ou rodapé de uma página. | ="Page " & Globals!PageNumber & " of " & Globals!TotalPages |
| Identifique todos os valores para um parâmetro multivalor escolhido pelo usuário. | Valor de um espaço reservado dentro de uma caixa de texto. Use Caixa de Diálogo de Propriedades de Grupo Tablix, Filtros. | =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 Caixa de Diálogo de Propriedades de Grupo, Quebras de Páginas. Selecione a opção Entre cada instância de um grupo. | =Ceiling(RowNumber(Nothing)/20) |
| Especifique a visibilidade condicional com base em um parâmetro. | Propriedade oculta de um tablix. Use Caixa de Diálogo de Propriedades Tablix, Visibilidade. | =Not Parameters!<parâmetro booliano>.Value |
| Especifique uma data formatada para uma determinada cultura. | Valor de um espaço reservado dentro de uma caixa de texto em uma região de dados. Use Caixa de Diálogo Propriedades de Caixa de Texto, Geral. | =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. | Valor de um espaço reservado dentro de uma caixa de texto em uma região de dados. Use Caixa de Diálogo Propriedades de Caixa de Texto, Geral. | ="Growth Percent: " & Format(Fields!Growth.Value,"p2") |
Conteúdo relacionado
- Expressões (Power BI Report Builder)
- Exemplos de Expressões (Power BI Report Builder)
- Parâmetros de Relatório (Power Bi Report Builder)
- Exemplos de equações de filtro (Construtor de Relatórios e SSRS)
- Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS)
- Cabeçalhos e rodapés de página (Construtor de relatórios)
- Formatando texto e espaços reservados (Construtor de Relatórios e SSRS)
- Ocultar um item (Construtor de Relatórios e SSRS)