Funções do Construtor de Relatórios - Função de agregação em um relatório paginado (Construtor de Relatórios)

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

Retorna uma agregação personalizada da expressão especificada em um relatório paginado, conforme definido pelo provedor de dados.

Sintaxe

  
Aggregate(expression, scope)  

Parâmetros

expressão
A expressão na qual realizar a agregação. A expressão deve ser uma referência de campo simples.

âmbito
(String) O nome de um conjunto de dados, grupo ou região de dados que contém os itens de relatório aos quais aplicar a função de agregação. O escopo deve ser uma constante de cadeia de caracteres e não pode ser uma expressão. Se o escopo não for especificado, o escopo atual será usado.

Tipo de Retorno

O tipo de retorno é determinado pelo provedor de dados. Devolve Nada se o fornecedor de dados não suportar esta função ou se os dados não estiverem disponíveis.

Observações

A função Agregar fornece uma maneira de usar agregações que são calculadas na fonte de dados externa. O suporte para este recurso é determinado pela extensão de dados. Por exemplo, a extensão de processamento de dados do SQL Server Analysis Services recupera conjuntos de linhas nivelados de uma consulta MDX. Algumas linhas no conjunto de resultados podem conter valores agregados calculados no servidor de fonte de dados. Estes são conhecidos como agregados de servidor. Para exibir agregações de servidor no designer de consulta gráfica do Analysis Services, você pode usar o botão Mostrar Agregação na barra de ferramentas. Para obter mais informações, consulte Interface do usuário do Designer de Consultas MDX do Analysis Services (Construtor de Relatórios).

Quando você exibe a combinação de valores agregados e detalhados de conjuntos de dados em linhas de detalhes de uma região de dados Tablix, as agregações de servidor normalmente não são incluídas porque não são dados detalhados. No entanto, convém exibir todos os valores recuperados para o conjunto de dados e personalizar a maneira como os dados agregados são calculados e exibidos.

O Construtor de Relatórios deteta o uso da função Agregar em expressões no relatório para determinar se as agregações do servidor devem ser exibidas em linhas de detalhes. Se você incluir Agregação em uma expressão em uma região de dados, as agregações de servidor só poderão aparecer em linhas de total de grupo ou total geral, não em linhas de detalhes. Se desejar exibir agregações de servidor em linhas de detalhes, não use a função Agregar .

Você pode alterar esse comportamento padrão alterando o valor da opção Interpretar subtotais como detalhes na caixa de diálogo Propriedades do Conjunto de Dados . Quando essa opção é definida como True, todos os dados, incluindo agregações de servidor, aparecem como dados detalhados. Quando definido como False, as agregações do servidor aparecem como totais. A configuração dessa propriedade afeta todas as regiões de dados vinculadas a esse conjunto de dados.

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

• O escopo para agregados aninhados deve ser o mesmo ou estar 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.

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

• A expressão não deve conter as funções First, Last, Previous ou RunningValue .

• A expressão não deve conter agregações aninhadas que especifiquem recursivas.

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

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

Comparando as funções de agregado e soma

A função Agregar difere das funções de agregação numérica como Soma na medida em que a função Agregar retorna um valor que é calculado pelo provedor de dados ou extensão de processamento de dados. Funções de agregação numérica como Soma retornam um valor calculado pelo processador de relatório em um conjunto de dados do conjunto de dados determinado pelo parâmetro scope . Para obter mais informações, consulte as funções agregadas listadas em Referência de funções agregadas (Construtor de Relatórios e SSRS).

Exemplo

O exemplo de código a seguir mostra uma expressão que recupera uma agregação de servidor para o campo LineTotal. A expressão é adicionada a uma célula em uma linha que pertence ao grupo GroupbyOrder.

=Aggregate(Fields!LineTotal.Value, "GroupbyOrder")  

Conteúdo relacionado

• Usos de Expressão 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)
• Escopo de expressão para totais, agregações e coleções internas (Construtor de Relatórios e SSRS)