Partilhar via

Usos de expressões em relatórios paginados (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

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. Você pode definir uma expressão para qualquer propriedade em uma caixa de diálogo que exibe o botão de 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. Um espaço reservado é criado 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 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]

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 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
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. 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
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 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údo relacionado

  • Last updated on