Funções do Construtor de Relatórios - Primeira função num relatório paginado (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

Devolve o primeiro valor no âmbito dado da expressão especificada num relatório paginado.

Sintaxe

  
First(expression, scope)  

Parâmetros

expressão
(Variante ou Binário) A expressão sobre a qual realizar a agregação, por exemplo, =Fields!FieldName.Value.

âmbito
(String) Opcional. O nome de um conjunto de dados, grupo ou região de dados que contém os itens do relatório aos quais aplicar a função agregada. Se o âmbito não for especificado, o âmbito atual é utilizado.

Tipo de Retorno

Determinado pelo tipo de expressão.

Observações

A primeira função devolve o primeiro valor num conjunto de dados depois de toda a ordenação e filtragem terem sido aplicadas no âmbito especificado.

A primeira função não pode ser usada em expressões de filtro de grupo com nada além do âmbito atual (padrão).

Também pode usar o Primeiro num cabeçalho de página para devolver o primeiro valor da coleção ReportItems para uma página, de modo a produzir títulos ao estilo de dicionário que mostrem a primeira e a última entrada de uma página.

O valor do âmbito deve ser uma constante de cadeia e não pode ser uma expressão. Para agregados externos ou agregados que não especificam outros agregados, o âmbito deve referir-se ao âmbito atual ou a um âmbito contido. Para agregados de agregados, agregados aninhados podem especificar um âmbito filho.

A expressão pode conter chamadas para funções agregadas aninhadas com as seguintes exceções e condições:

• O âmbito para agregados aninhados deve ser igual ou estar contido pelo âmbito do agregado exterior. Para todos os escopos distintos na expressão, um escopo deve ter uma relação hierárquica com todos os outros escopos.

• O âmbito para agregados aninhados não pode ser o nome de um conjunto de dados.

• A Expressão não deve conter as funções Primeiro, Último, Anterior ou Valor Executante .

• A expressão não deve conter agregados aninhados que especifiquem recursivo.

Para mais informações, consulte Aggregate Functions Reference (Report Builder e SSRS) e Expression Scope for Totais, Aggregates e Coleções Incorporadas (Report Builder e SSRS).

Para mais informações sobre agregados recursivos, consulte Criação de Grupos de Hierarquia Recursiva (Construtor de Relatórios e SSRS).

Example

O seguinte exemplo de código devolve o primeiro número de produto no Category grupo de uma região de dados:

=First(Fields!ProductNumber.Value, "Category")  

Conteúdo relacionado

• Utilizações de Expressões em Relatórios (Construtor de Relatórios e SSRS)
• Exemplos de Expressões (Construtor de Relatórios e SSRS)
• Tipos de Dados em Expressões (Construtor de Relatórios e SSRS)
• Âmbito de Expressão para Totais, Agregados e Coleções Incorporadas (Construtor de Relatórios e SSRS)