Função de Agregação (Construtor de Relatórios e SSRS)

Retorna uma agregação personalizada da expressão especificada, conforme definido pelo provedor de dados.

Sintaxe

  
Aggregate(expression, scope)  

Parâmetros

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

escopo
(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 scope não estiver especificado, será usado o escopo atual.

Tipo de retorno

O tipo de retorno é determinado pelo provedor de dados. Retornará Nothing se o provedor de dados não der suporte a essa função ou se os dados não estiverem disponíveis.

Observações

A Aggregate função fornece uma maneira de usar agregações calculadas na fonte de dados externa. O suporte para esse 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 simples de uma consulta MDX. Algumas linhas no conjunto de resultados podem conter valores de agregação calculados no servidor de fonte de dados. Eles são conhecidos como agregações do servidor. Para exibir as agregações do servidor no designer de consultas gráficas do Analysis Services, é possível usar o botão Mostrar Agregação na barra de ferramentas. Para obter mais informações, confira Interface do usuário do Designer de Consultas MDX do Analysis Services (Construtor de Relatórios).

Ao exibir a combinação de valores de agregação e do conjunto de dados de detalhes nas linhas de detalhes de uma região de dados Tablix, normalmente as agregações do servidor não são incluídas porque não são dados de detalhes. No entanto, talvez você queira exibir todos os valores recuperados para o conjunto de dados e personalizar a maneira como os dados de agregação são calculados e exibidos.

O Reporting Services detecta o uso da função Aggregate em expressões em seu relatório para determinar se as agregações de servidor devem ser exibidas em linhas detalhadas. Se você incluir Aggregate em uma expressão em uma região de dados, as agregações de servidor só poderão aparecer no total de grupos ou em linhas totais gerais, não em linhas de detalhes. Se você quiser exibir agregações de servidor em linhas de detalhes, não use a Aggregate função.

É possível alterar este 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 de detalhes. Quando definido como False, as agregações de servidor aparecem como totais. A configuração desta propriedade afeta todas as regiões de dados vinculadas a este conjunto de dados.

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

• Scope para agregações aninhadas deve ser igual ao escopo da agregação externa ou deve estar contido nela. 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.

• A expressão não deve conterFirst, LastPreviousou RunningValue funções.

• 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).

Comparando as funções Agregação e Soma

A Aggregate função difere de funções de agregação numéricas, como Sum a Aggregate função retorna um valor calculado pelo provedor de dados ou extensão de processamento de dados. Funções de agregação numéricas, como Sum retornam um valor calculado pelo processador de relatório em um conjunto de dados da fonte de dados determinado pelo parâmetro de escopo. Para obter mais informações, confira as funções de agregação listadas em Referência de funções de agregação (Construtor de Relatórios e SSRS).

Exemplo

O seguinte exemplo de código mostra uma expressão que recupera uma agregação do 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")  

Consulte Também

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