Usos de expressão em relatórios paginados (Construtor de Relatórios do Power BI)
APLICA-SE A:
Power BI Report Builder 
Power BI Desktop
Nos relatórios paginados do Power BI, 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 item de relatório, definições de grupo e classificação, propriedades de caixa de texto, marcadores, mapas de documentos, conteúdo e imagens dinâmicas de cabeçalho e rodapé de página. Este tópico fornece exemplos dos muitos locais em que você pode usar expressões para variar o conteúdo ou a aparência de um relatório. Esta lista não está completa. Você pode definir 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 <Expressão...>.
As expressões podem ser simples ou complexas. Expressões simples contêm uma referência a um único campo de conjunto de dados, parâmetro ou campo interno. Expressões complexas podem conter várias referências, operadores e chamadas de função internas. Por exemplo, uma expressão complexa pode incluir a função Soma aplicada ao campo Vendas.
As expressões são escritas em 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 e parâmetros do conjunto de dados, constantes, funções e operadores.
Use expressões simples
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 aparece como [ProductID]. Expressões simples são criadas automaticamente quando você arrasta um campo de um conjunto de dados para uma caixa de texto. Um espaço reservado é criado e a expressão define o valor subjacente. Você também pode digitar expressões diretamente em uma célula de região de dados ou 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 você pode usar expressões simples. A tabela descreve a funcionalidade, a propriedade a ser definida, a caixa de diálogo que você normalmente usa para defini-la e o valor da propriedade. Você pode digitar a expressão simples diretamente na superfície de design, em uma caixa de diálogo ou no painel Propriedades, ou pode editá-la na caixa de diálogo Expressão, assim como faria com qualquer expressão.
| Caraterística | 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 para um espaço reservado dentro de uma caixa de texto. Usar caixa de diálogo Propriedades do Espaço Reservado, Geral. | [Sales] |
| Agregar valores para um grupo. | Propriedade Value para um espaço reservado dentro de uma linha associada a um grupo tablix. Use a caixa de diálogo Propriedades da caixa de texto. | [Sum(Sales)] |
| Inclua um número de página. | Propriedade value para 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. | [&PageNumber] |
| Exiba um valor de parâmetro selecionado. | Propriedade Value para 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. | [@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. | [Category] |
| Excluir um valor de campo específico de uma tabela. | Equação de filtro no tablix. Use a caixa de diálogo Propriedades Tablix, Filtros. | Para tipo de dados, selecione Inteiro.[Quantity]>100 |
| Inclua apenas 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. | [Category]=Clothing |
| Excluir valores específicos para 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 Tablix, Filtros. | =[Color]<>Red=[Color]<>Blue |
| Especifique a ordem de classificação com base em um campo existente em uma tabela. | Ordenar expressão no tablix. Use a caixa de diálogo Propriedades Tablix, Classificação. | [SizeSortOrder] |
| Vincule um parâmetro de consulta a um parâmetro de relatório. | Coleta de parâmetros no conjunto de dados. Use a caixa de diálogo Propriedades do 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 a caixa de diálogo Propriedades do sub-relatório, parâmetros. | [@Category][@Category] |
Usar expressões complexas
Expressões complexas podem conter várias referências internas, operadores e chamadas de função e aparecem na superfície de design como <<Expr>>. Para ver ou alterar o texto da expressão, você deve abrir a caixa de diálogo Expressão ou digitar diretamente no painel Propriedades . A tabela a seguir lista maneiras típicas de usar uma expressão complexa para exibir ou organizar dados ou alterar a aparência do relatório, incluindo a propriedade a ser definida, a caixa de diálogo que você normalmente usa 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.
| Caraterística | Propriedade, contexto e caixa de diálogo | Valor da Propriedade |
|---|---|---|
| Calcule valores agregados para um conjunto de dados. | Propriedade Value para um espaço reservado dentro de uma caixa de texto. Usar caixa de diálogo Propriedades do Espaço Reservado, Geral. | =First(Fields!Sales.Value,"DataSet1") |
| Concatenar texto e expressões na mesma caixa de texto. | Valor para um espaço reservado dentro de uma caixa de texto que é colocado em um cabeçalho ou rodapé de página. Usar caixa de diálogo Propriedades do Espaço Reservado, Geral. | ="This report began processing at " & Globals!ExecutionTime |
| Calcule um valor agregado para um conjunto de dados em um escopo diferente. | Valor para um espaço reservado dentro de uma caixa de texto que é colocada em um grupo tablix. Usar caixa de diálogo Propriedades do Espaço Reservado, Geral. | =Max(Fields!Total.Value,"DataSet2") |
| Formate dados em uma caixa de texto dependendo do valor. | Cor para 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. | =IIF(Fields!TotalDue.Value < 10000,"Red","Black") |
| Calcule um valor uma vez para fazer referência ao longo do relatório. | Valor para uma variável de relatório. Use a caixa de diálogo Propriedades do relatório, Variáveis. | =Variables!MyCalculation.Value |
| Inclua valores específicos para 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 Tablix, Filtros. | Para o 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 usando um parâmetro booleano chamado Show. | Propriedade oculta em uma caixa de texto. Use a caixa de diálogo Propriedades da caixa de texto, visibilidade. | =Not Parameters!Mostrar<parâmetro booleano>.Value |
| Especifique o conteúdo dinâmico do cabeçalho ou rodapé da página. | Valor para um espaço reservado dentro de uma caixa de texto que é colocada no cabeçalho ou rodapé da página. | ="Page " & Globals!PageNumber & " of " & Globals!TotalPages |
| Identifique todos os valores para um parâmetro de vários valores escolhido pelo usuário. | Valor para um espaço reservado dentro de uma caixa de texto. Use a caixa de diálogo Propriedades Tablix, Filtros. | =Join(Parameters!MyMultivalueParameter.Value,", ") |
| Especifique quebras de página para cada 20 linhas em um tablix sem outros grupos. | Expressão de grupo para um grupo em um tablix. Caixa de diálogo Usar propriedades do grupo, quebras de página. 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 para um tablix. Use a caixa de diálogo Propriedades Tablix, Visibilidade. | =Not Parameters!<parâmetro booleano>.Value |
| Especifique uma data formatada para uma cultura específica. | Valor para 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. | =Fields!OrderDate.Value.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("de-DE")) |
| Concatenar uma cadeia de caracteres e um número formatado como uma porcentagem para duas casas decimais. | Valor para 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. | ="Growth Percent: " & Format(Fields!Growth.Value,"p2") |
Conteúdos relacionados
- Expressões (Construtor de Relatórios do Power BI)
- Exemplos de expressões (Construtor de Relatórios do Power BI)
- Parâmetros de relatório (Construtor de Relatórios do Power BI)
- 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)
- Formatação de texto e espaços reservados (Construtor de Relatórios e SSRS)
- Ocultar um item (Construtor de Relatórios e SSRS)