Exemplos de expressões (Report Builder 3.0 e SSRS)

Você pode usar as funções do Visual Basic para manipular os dados exibidos nas caixas de texto ou usados para parâmetros, propriedades ou outras áreas do relatório. Esta seção fornece exemplos que demonstram algumas destas funções. Para obter mais informações, consulte Membros da biblioteca em tempo de execução do Visual Basic no MSDN.

O .NET Framework fornece muitas opções de formatos personalizados; por exemplo, para formatos de data específicos. Para obter mais informações, consulte Tipos de formatação no MSDN.

Funções matemáticas

Funções de data

Funções de cadeia de caracteres

Pesquisar

LookupSet

Funções de conversão

Funções de decisão

Em uma expressão, você pode adicionar uma referência a funções de relatório adicionais que manipulam dados em um relatório. Esta seção fornece exemplos de duas destas funções. Para obter mais informações sobre funções de relatórios e exemplos, consulte Referência de funções de agregação (Construtor de Relatórios 3.0 e SSRS).

Ao criar um relatório, você pode exibir o nome do relatório e o número da página no rodapé. Para fazer isso, você pode usar as expressões a seguir:

• A seguinte expressão fornece o nome do relatório e a hora em que foi executado. Ela pode ser colocada em uma caixa de texto no rodapé ou no corpo do relatório. A hora é formatada com a cadeia de caracteres de formatação do .NET Framework para data abreviada:

  =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
  

• A seguinte expressão, colocada em uma caixa de texto no rodapé de um relatório, fornece o número da página e o total de páginas no relatório:

  =Globals.PageNumber & " of " & Globals.TotalPages
  

Os exemplos a seguir descrevem como exibir os primeiros e os últimos valores de uma página no cabeçalho da página, semelhante ao que você pode encontrar em uma listagem de diretório. O exemplo pressupõe uma região de dados que contém uma caixa de texto denominada LastName.

• A expressão a seguir, colocada em uma caixa de texto no lado esquerdo do cabeçalho da página, fornece o primeiro valor da caixa de texto LastName na página:

  =First(ReportItems("LastName").Value)
  

• A expressão a seguir, colocada em uma caixa de texto no lado direito do cabeçalho da página, fornece o último valor da caixa de texto LastName na página:

  =Last(ReportItems("LastName").Value)
  

O exemplo a seguir descreve como exibir um total de páginas. O exemplo pressupõe uma região de dados que contém uma caixa de texto denominada Cost.

• A expressão a seguir, colocada no cabeçalho ou no rodapé de página, fornece a soma dos valores na caixa de texto Cost da página:

  =Sum(ReportItems("Cost").Value)
  

Observação
Você pode fazer referência a apenas um item de relatório por expressão em um cabeçalho ou rodapé de página. Além disso, é possível fazer referência ao nome da caixa de texto, mas não à expressão de dados reais dentro da caixa de texto, nas expressões de cabeçalho e rodapé de página.

Em alguns relatórios, você pode desejar colocar uma quebra de página no final de um número de linhas especificado ou, além disso, em grupos ou itens de relatório. Para fazer isso, crie um grupo que contenha os grupos ou registros de detalhes desejados, adicione uma quebra de página ao grupo e adicione uma expressão de grupo ao grupo por um número de linhas especificado.

• A expressão a seguir, quando colocada na expressão de grupo, atribui um número para cada conjunto de 25 linhas. Quando uma quebra de página é definida para o grupo, essa expressão resulta em uma quebra de página a cada 25 linhas.

  =Ceiling(RowNumber(Nothing)/25)
  

  Para permitir que o usuário defina um valor para o número de linhas por página, crie um parâmetro denominado RowsPerPage e baseie a expressão de grupo no parâmetro, conforme mostrado na expressão a seguir:

  =Ceiling(RowNumber(Nothing)/Parameters!RowsPerPage.Value)
  

  Para obter mais informações sobre como configurar quebras de página para um grupo, consulte Como adicionar uma quebra de página (Construtor de Relatórios 3.0 e SSRS).

• A expressão a seguir, quando usada na propriedade Color de uma caixa de texto, altera a cor do texto dependendo do valor do campo Profit:

  =Iif(Fields!Profit.Value < 0, "Red", "Black")
  

  Você também pode usar a variável de objeto Me do Visual Basic. Essa variável é outra maneira de fazer referência ao valor de uma caixa de texto.

  =Iif(Me.Value < 0, "Red", "Black")

• A expressão a seguir, quando usada na propriedade BackgroundColor de um item de relatório em uma região de dados, alterna a cor de plano de fundo de cada linha entre verde claro e branco:

  =Iif(RowNumber(Nothing) Mod 2, "PaleGreen", "White")
  

  Se você estiver usando uma expressão para um escopo especificado, poderá precisar indicar o conjunto de dados para a função de agregação:

  =Iif(RowNumber("Employees") Mod 2, "PaleGreen", "White")
  

Observação
As cores disponíveis são provenientes da enumeração de .NET FrameworkKnownColor.

Para especificar cores para um gráfico de Forma, você pode usar código personalizado para controlar a ordem em que as cores são mapeadas para valores de pontos de dados. Isso ajuda a usar cores consistentes para vários gráficos que têm os mesmos grupos de categorias. Para obter mais informações, consulte Como especificar cores consistentes em gráficos com várias formas (Construtor de Relatórios 3.0 e SSRS).

Você pode mostrar e ocultar itens em um relatório usando as propriedades de visibilidade para o item de relatório. Em uma região de dados, como uma tabela, é possível ocultar inicialmente as linhas de detalhes com base no valor de uma expressão.

• A expressão a seguir, quando usada para visibilidade inicial de linhas de detalhes em um grupo, mostra as linhas de detalhes de todas as vendas que excedem 90 por cento no campo PctQuota:

  =Iif(Fields!PctQuota.Value>.9, False, True)
  

• A expressão a seguir, quando definida na propriedade Hidden de uma tabela, mostrará a tabela apenas se ela tiver mais de 12 linhas:

  =IIF(CountRows()>12,true,false)
  

• A expressão a seguir, quando definida na propriedade Hidden de uma coluna, mostrará a coluna apenas se o campo existir no conjunto de dados do relatório depois que os dados são recuperados de uma fonte de dados:

  =IIF(Fields!Column_1.IsMissing, true, false)
  

É possível personalizar URLs usando dados do relatório e também controlar condicionalmente se as URLs são adicionadas como uma ação para uma caixa de texto.

• A expressão a seguir, quando usada como uma ação em uma caixa de texto, gera uma URL personalizada que especifica o campo do conjunto de dados EmployeeID como um parâmetro da URL.

  ="http://adventure-works/MyInfo?ID=" & Fields!EmployeeID.Value
  

  Para obter mais informações, consulte Como adicionar um hiperlink a uma URL (Construtor de Relatórios 3.0 e SSRS).

• A expressão a seguir controla condicionalmente se uma URL deve ser adicionada em uma caixa de texto. Essa expressão depende de um parâmetro denominado IncludeURLs que permite que um usuário decida se deve incluir URLs ativas em um relatório. Essa expressão é definida como uma ação em uma caixa de texto. Configurando o parâmetro como Falso e exibindo o relatório, você pode exportar o relatório Microsoft Excel sem hiperlinks.

  =IIF(Parameters!IncludeURLs.Value,"http://adventure-works.com/productcatalog",Nothing)
  

É possível usar expressões em um parâmetro para variar o valor padrão do parâmetro. Por exemplo, você pode usar um parâmetro para filtrar dados para um usuário específico baseado na ID do usuário usada para executar o relatório.

• A expressão a seguir, quando usada com o valor padrão para um parâmetro, coleta a ID do usuário da pessoa que executa o relatório:

  =User!UserID
  

• Para consultar um parâmetro em um parâmetro de consulta, expressão de filtro, caixa de texto ou outra área do relatório, use a coleção global de Parameters. Este exemplo supõe que o parâmetro é denominado Department:

  =Parameters!Department.Value
  

• Parâmetros podem ser criados em um relatório, mas definidos como ocultos. Quando o relatório é executado no servidor de relatório, o parâmetro não é exibido na barra de ferramentas e o leitor de relatório não pode alterar o valor padrão. É possível usar um parâmetro oculto, definido como um valor padrão, como uma constante personalizada. É possível usar esse valor em qualquer expressão, incluindo uma expressão de campo. A expressão a seguir identifica o campo especificado pelo valor do parâmetro padrão para o parâmetro denominado ParameterField:

  =Fields(Parameters!ParameterField.Value).Value
  

Você pode inicializar o valor para uma variável de grupo que é local para um escopo de grupo específico e depois incluir uma referência a essa variável nas expressões. Um dos modos pelos quais é possível usar uma variável de grupo com código personalizado é implementar uma agregação personalizada. Para obter mais informações, consulte Usando variáveis de grupo no Reporting Services 2008 para agregação personalizada.

Para obter mais informações sobre variáveis, consulte Usando referências de coleções de variáveis de grupo e de relatório (Construtor de Relatórios 3.0 e SSRS).

O exemplo a seguir chama um método inserido chamado FixSpelling, que substitui "Bicycle" para todas as ocorrências do texto "Bike" em SubCategory.Value.

=Code.FixSpelling(Fields!SubCategory.Value)

O código a seguir, quando incorporado em uma definição de relatório, mostra uma implementação do método FixSpelling. Este exemplo mostra como fazer referência à classe System.Text..::..StringBuilder do .NET Framework. Para obter mais informações, consulte Como adicionar código a um relatório (SSRS).

Public Function FixSpelling(ByVal s As String) As String
   Dim strBuilder As New System.Text.StringBuilder(s)
   If s.Contains("Bike") Then
      strBuilder.Replace("Bike", "Bicycle")
      Return strBuilder.ToString()
      Else : Return s
   End If
End Function

Alguns valores em uma expressão podem ser avaliados como nulos ou indefinidos na hora do processamento do relatório. Isso pode criar erros de tempo de execução que resultam em #Erro exibidos na caixa de texto em vez da expressão avaliada. A função IIF é particularmente sensível a esse comportamento porque, ao contrário de uma instrução If-Then-Else, cada parte da instrução IIF é avaliada (incluindo chamadas de função) antes de ser passada para a rotina que é testada como true ou false. A instrução =IIF(Fields!Sales.Value is NOTHING, 0, Fields!Sales.Value) gerará #Erro no relatório renderizado, se Fields!Sales.Value for NOTHING.

Para evitar essa condição, use uma das seguintes estratégias:

• Defina o numerador como 0 e o denominador como 1, se o valor do campo B for 0 ou indefinido. Caso contrário defina o numerador como o valor do campo A e o denominador como o valor do campo B.

  =IIF(Field!B.Value=0, 0, Field!A.Value / IIF(Field!B.Value =0, 1, Field!B.Value))
  

• Use uma função de código personalizado para retornar o valor da expressão. O exemplo a seguir retorna a diferença da porcentagem entre um valor atual e um valor anterior. Isso pode ser usado para calcular a diferença entre quaisquer dois valores sucessivos e trata o caso de borda da primeira comparação (quando não há valor anterior) e casos em que o valor anterior ou o valor atual é null (Nothing no Visual Basic).

  Public Function GetDeltaPercentage(ByVal PreviousValue, ByVal CurrentValue) As Object
      If IsNothing(PreviousValue) OR IsNothing(CurrentValue) Then
          Return Nothing
      Else if PreviousValue = 0 OR CurrentValue = 0 Then
          Return Nothing
      Else 
          Return (CurrentValue - PreviousValue) / CurrentValue
      End If
  End Function
  

  A expressão a seguir mostra como chamar esse código personalizado em uma caixa de texto:

  =Code.GetDeltaPercentage(Previous(Sum(Fields!Sales.Value),"ColumnGroupByYear"), Sum(Fields!Sales.Value))
  

  Isso ajuda a evitar exceções em tempo de execução. Agora você pode usar uma expressão como =IIF(Me.Value < 0, "red", "black") na propriedade Color da caixa de texto para exibição condicional do texto, dependendo se os valores são maiores que ou menores que 0.