Funções do Construtor de Relatórios – função First em um relatório paginado (Construtor de Relatórios)

Aplica-se a: SSRS (Construtor de Relatórios da Microsoft) Power BI Report Builder Report Designer no SQL Server Data Tools

Retorna o primeiro valor no escopo fornecido da expressão especificada em um relatório paginado.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Sintaxe

  
First(expression, scope)

Parâmetros

expressão
(Variant ou Binary) A expressão na qual a agregação será executada, por exemplo, =Fields!FieldName.Value.

escopo
(String) Opcional. O nome de um conjunto de dados, um grupo ou uma região de dados que contém os itens de relatório aos quais a função de agregação deve ser aplicada. Se scope não estiver especificado, será usado o escopo atual.

Tipo de retorno

Determinado pelo tipo de expressão.

Comentários

A função First retorna o primeiro valor em um conjunto de dados depois que toda a classificação e filtragem tiverem sido aplicadas no escopo especificado.

A função First não pode ser usada em expressões de filtro de grupo com qualquer coisa, exceto o escopo atual (padrão).

Também é possível usar a função First em um cabeçalho de página para retornar o primeiro valor da coleção de ReportItems para uma página de modo a produzir cabeçalhos em estilo de dicionário que exibem a primeira e a última entradas em uma página.

O valor de scope deve ser uma constante de cadeia de caracteres e não pode ser uma expressão. Para agregações externas ou que não especificam outras agregações, scope deve se referir ao escopo atual ou a um escopo contentor. Para agregações de agregações, as agregações aninhadas podem especificar um escopo filho.

Expression pode conter chamadas para funções de agregação aninhadas com as seguintes exceções e condições:

  • Escopo para agregados aninhados deve ser o mesmo que, ou contido no, escopo do agregado externo. Para todos os escopos distintos na expressão, um escopo deve estar em uma relação filho com todos os outros escopos.

  • Scope para agregações aninhadas não pode ser o nome de um conjunto de dados.

  • Expression não deve conter a função First, Last, Previousou RunningValue .

  • Expression não deve conter agregações aninhadas que especifiquem recursive.

Para obter mais informações, confira Referência de funções de agregação (Construtor de Relatórios e SSRS) e Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS).

Para obter mais informações sobre agregações recursivas, confira Criando grupos de hierarquias recursivas (Construtor de Relatórios e SSRS).

Exemplo

O exemplo de código a seguir retorna o número do primeiro produto no grupo Category de uma região de dados:

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

Conteúdo relacionado

  • Última atualização em