Referências de coleções de campos de conjuntos de dados (Construtor de Relatórios e SSRS)

Cada conjunto de dados de um relatório contém uma coleção Fields. A coleção Fields é o conjunto de campos especificado pela consulta do conjunto de dados, além de qualquer campo calculado adicional que você criar. Assim que você criar um conjunto de dados, a coleção de campos aparecerá no painel Dados do Relatório .

Uma referência de campo simples em uma expressão é exibida na superfície de design como uma expressão simples. Por exemplo, quando você arrasta o campo Sales do painel de dados do relatório para uma célula de tabela na superfície de design, o [Sales] é exibido. Isso representa a expressão subjacente =Fields!Sales.Value definida na propriedade Value da caixa de texto. Quando o relatório for executado, o processador de relatório avaliará essa expressão e exibirá os dados reais a partir da fonte de dados na caixa de texto da célula de tabela. Para obter mais informações, confira Expressões (Construtor de Relatórios e SSRS) e Coleção de campos de conjuntos de dados (Construtor de Relatórios e SSRS).

Exibindo a coleção de campos de um conjunto de dados

Para exibir os valores individuais de uma coleção de dados, arraste cada campo para uma linha de detalhes da tabela e execute o relatório. Referências provenientes da linha de detalhes de uma tabela ou da região de dados da lista exibem um valor para cada linha do conjunto de dados.

Para exibir valores resumidos para o campo, arraste cada campo numérico para a área de dados de uma matriz. A função de agregação padrão de total da linha é Sum, por exemplo, =Sum(Fields!Sales.Value). Você também pode alterar a função padrão para calcular outros totais. Para obter mais informações, confira Referência de funções de agregação (Construtor de Relatórios e SSRS).

Para exibir valores resumidos de uma coleção de campos em uma caixa de texto diretamente na superfície de design (não parte de uma região de dados), especifique o nome do conjunto de dados como um escopo da função de agregação. Por exemplo, para um conjunto de dados chamado SalesData, a expressão a seguir especifica o total de todos os valores do campo Sales: =Sum(Fields!Sales,"SalesData").

Quando você usa a caixa de diálogo Expressão para definir uma referência de campo simples, é possível selecionar a coleção Fields no painel Categoria e ver a lista de campos disponíveis no painel Campo . Cada campo tem várias propriedades, incluindo o Value e IsMissing. As demais propriedades são propriedades de campo estendidas predefinidas que podem estar disponíveis para o conjunto de dados, dependendo do tipo de fonte de dados.

Detectando nulos para um campo do conjunto de dados

Para detectar um valor de campo nulo (Nothing no Visual Basic), você pode usar a função IsNothing. Se ela for incluída em uma caixa de texto de uma linha de detalhes de tabela, a expressão a seguir testará o campo MiddleName e substituirá o texto "No Middle Name" quando o valor for nulo e o próprio valor do campo quando esse valor não for nulo:

=IIF(IsNothing(Fields!MiddleName.Value),"No Middle Name",Fields!MiddleName.Value)

Detectando campos ausentes em consultas dinâmicas em tempo de execução

Por padrão, os itens da coleção Fields têm duas propriedades: Value e IsMissing. A propriedade IsMissing indica se um campo que foi definido para um conjunto de dados em tempo de design estará contido em um dos campos recuperados em tempo de execução. Por exemplo, sua consulta pode chamar um procedimento armazenado no qual o conjunto de resultados varia de acordo com um parâmetro de entrada ou sua consulta pode ser SELECT * FROM <uma tabela> em que a definição da tabela foi alterada.

É possível testar a propriedade IsMissing em código personalizado para determinar a existência de um campo em um conjunto de resultados. Você não pode testar sua presença usando uma expressão com uma chamada de função do Visual Basic, como IIF ou SWITCH, porque o Visual Basic avalia todos os parâmetros na chamada para a função, o que resulta em um erro quando a referência à falta é avaliada.

Exemplo de controle da visibilidade de uma coluna dinâmica de um campo ausente

Para definir uma expressão que controla a visibilidade de uma coluna que exibe um campo em um conjunto de dados, primeiro defina uma função de código personalizado que retorne um valor booliano com base na existência ou ausência do campo. Por exemplo, a função de código personalizado a seguir retornará verdadeiro se o campo estiver ausente e falso se ele existir.

Public Function IsFieldMissing(field as Field) as Boolean  
 If (field.IsMissing) Then  
 Return True  
  Else   
  Return False  
 End If  
End Function  

Para usar essa função para controlar a visibilidade de uma coluna, defina a propriedade Hidden da coluna como a seguinte expressão:

=Code.IsFieldMissing(Fields!FieldName)

A coluna ficará oculta se o campo não existir.

Exemplo de controle da visibilidade de um valor de caixa de texto de um campo ausente

Para usar o texto que você escrever em substituição do valor de um campo ausente, escreva um código personalizado que retorne o texto que você possa usar no lugar do valor do campo quando o campo estiver ausente. Por exemplo, a função de código personalizado a seguir retornará o valor do campo se o campo existir e a mensagem indicando que você deve especificar o segundo parâmetro se o campo não existir:

Public Function IsFieldMissingThenString(field as Field, strMessage as String) as String  
 If (field.IsMissing) Then  
  Return strMessage  
 Else   
  Return field.Value  
  End If  
End Function  

Para usar essa função em uma caixa de texto, adicione a seguinte expressão à propriedade Value:

=Code.IsFieldMissingThenString(Fields!FieldName,"Missing")

A caixa de texto exibe o valor do campo ou o texto que você especificou.

Usando propriedades de campo estendidas

As propriedades de campo estendidas são propriedades adicionais definidas em um campo pela extensão de processamento de dados, que é determinada pelo tipo de fonte de dados do conjunto de dados. As propriedades de campo estendidas são predefinidas ou específicas para um tipo de fonte de dados. Para obter mais informações, confira Propriedades de campos estendidos para um banco de dados do Analysis Services (SSRS).

Se você especificar uma propriedade que não tem suporte para esse campo, a expressão será avaliada como null (Nothing no Visual Basic). Se um provedor de dados não oferecer suporte a propriedades de campo estendidas ou se o campo não for encontrado quando a consulta for executada, o valor da propriedade será null ( no Visual Basic) para propriedades do tipo String e Object, e zero (0) para propriedades do tipo IntegerNothing . Uma extensão de processamento de dados pode fazer bom uso das propriedades predefinidas ao otimizar consultas que incluem essa sintaxe.

Consulte Também

Exemplos de expressões (Construtor de Relatórios e SSRS)
Adicionar dados a um relatório (Construtor de Relatórios e SSRS)