Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
Construtor de Relatórios da Microsoft (SSRS) Designer de Relatórios do Power BI no SQL Server Data Tools
Nos relatórios paginados, as expressões são usadas ao longo da definição do relatório para especificar ou calcular valores para parâmetros, consultas, filtros, propriedades dos itens do relatório, definições de grupos e ordenações, propriedades de caixas de texto, favoritos, mapas do documento, conteúdo dinâmico do cabeçalho e rodapé da página, imagens e definições dinâmicas de fontes de dados. 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 é abrangente. Pode definir uma expressão para qualquer propriedade numa caixa de diálogo que mostre o botão de expressão (fx) ou numa lista suspensa que mostre <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.
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.
Uso de 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. É criado um marcador de posição e a expressão define o valor subjacente. Também pode escrever expressões diretamente numa célula de região de dados ou numa caixa de texto, tanto na superfície de design como numa 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.
| Funcionalidade | Propriedade, contexto e caixa de diálogo | Valor de Propriedade |
|---|---|---|
| Especifique um campo de conjunto de dados a ser exibido em uma caixa de texto. | Propriedade Valor para o marcador de posição numa caixa de texto. Use Caixa de diálogo Propriedades do Marcador de Posição, Geral. | [Sales] |
| Agregar valores para um grupo. | Propriedade Valor para um marcador de posição numa linha associada a um grupo tablix. Utilize a caixa de diálogo Propriedades da caixa de texto. | [Sum(Sales)] |
| Inclua um número de página. | Propriedade valor para um marcador de posição dentro de uma caixa de texto inserida num cabeçalho de página. Utilize Caixa de diálogo Propriedades da caixa de texto, Geral. | [&PageNumber] |
| Exiba um valor de parâmetro selecionado. | Propriedade Valor para um marcador de posição numa caixa de texto na superfície de estrutura. Utilize 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. Utilize 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 de 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. Utilize 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 de um grupo num tablix. Use a caixa de diálogo Propriedades de 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. Utilize a caixa de diálogo Propriedades de Tablix, Ordenação. | [SizeSortOrder] |
| Vincule um parâmetro de consulta a um parâmetro de relatório. | Coleta de parâmetros no conjunto de dados. Utilize 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. Utilize a caixa de diálogo Propriedades do Sub-relatório, Parâmetros. | [@Category][@Category] |
Utilização de 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.
| Funcionalidade | Propriedade, contexto e caixa de diálogo | Valor de Propriedade |
|---|---|---|
| Calcule valores agregados para um conjunto de dados. | Propriedade Valor de um marcador de posição dentro de uma caixa de texto. Use Caixa de diálogo Propriedades do Marcador de Posição, Geral. | =First(Fields!Sales.Value,"DataSet1") |
| Concatenar texto e expressões na mesma caixa de texto. | Valor de um marcador de posição dentro de uma caixa de texto colocada num cabeçalho ou rodapé da página. Use Caixa de diálogo Propriedades do Marcador de Posição, Geral. | ="This report began processing at " & Globals!ExecutionTime |
| Calcule um valor agregado para um conjunto de dados em um escopo diferente. | Valor de um marcador de posição dentro de uma caixa de texto colocada num grupo tablix. Use Caixa de diálogo Propriedades do Marcador de Posição, Geral. | =Max(Fields!Total.Value,"DataSet2") |
| Formate dados em uma caixa de texto dependendo do valor. | Cor de um marcador de posição numa caixa de texto na linha de detalhes de um tablix. Utilize caixa de diálogo Propriedades da Caixa de Texto, Tipo de letra. | =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 de um grupo num tablix. Use a caixa de diálogo Propriedades de 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 |
| Esconda uma caixa de texto na superfície do design, que pode ser ativada pelo utilizador usando um parâmetro booleano chamado Mostrar. | Propriedade oculta numa caixa de texto. Utilize 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 de um marcador de posição numa caixa de texto colocada no cabeçalho ou rodapé da página. | ="Page " & Globals!PageNumber & " of " & Globals!TotalPages |
| Especifique uma fonte de dados dinamicamente usando um parâmetro. | Cadeia de ligação da fonte de dados. Use Caixa de Diálogo de Propriedades da Fonte de Dados, Geral. | ="Data Source=" & Parameters!ServerName.Value & ";initial catalog=AdventureWorks2022" |
| Identifique todos os valores para um parâmetro de vários valores escolhido pelo usuário. | Valor para um texto de marcador numa caixa de texto. Use a caixa de diálogo Propriedades de Tablix, Filtros. | =Join(Parameters!MyMultivalueParameter.Value,", ") |
| Especifique quebras de página a cada 20 linhas num tablix sem quaisquer outros grupos. | Expressão de grupo para um grupo num tablix. Utilize a caixa de diálogo 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. Utilize a caixa de diálogo «Propriedades de Tablix, Visibilidade». |
=Not Parameters!<
parâmetro booleano>.Value |
| Especifique uma data formatada para uma cultura específica. | Valor de um marcador de posição no interior de uma caixa de texto numa região de dados. Utilize 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 de um marcador de posição no interior de uma caixa de texto numa região de dados. Utilize Caixa de diálogo Propriedades da caixa de texto, Geral. | ="Growth Percent: " & Format(Fields!Growth.Value,"p2") |
Conteúdo relacionado
- Expressões num relatório paginado (Construtor de Relatórios)
- Exemplos de expressões em relatórios paginados do Report Builder
- Parâmetros de relatórios paginados no Construtor de Relatórios
- Exemplos de equações de filtro num relatório paginado (Construtor de Relatórios)
- Filtrar, agrupar e ordenar dados em relatórios paginados do Construtor de Relatórios
- Cabeçalhos e rodapés de página num relatório paginado (Construtor de Relatórios)
- Formatar texto e marcadores de posição em relatórios paginados (Construtor de Relatórios)
- Esconder um item (Construtor de Relatórios)