Mudanças entre as edições de "Consulta:Totalizadores da Grid"
(→Rodapé) |
(→Agregação de Valores Customizada) |
||
Linha 15: | Linha 15: | ||
Além das funções nativas do NCalc, temos 5 funções customizadas, que foram criadas para fazer a agregação dos valores das colunas. São elas: | Além das funções nativas do NCalc, temos 5 funções customizadas, que foram criadas para fazer a agregação dos valores das colunas. São elas: | ||
− | * AggSum: | + | * '''AggSum:''' Retorna a soma de todos os valores da coluna especificada. |
− | AggSum([ | + | AggSum([receita]) + AggSum([valormargem]) * 100 / AggSum([receita]) |
− | * AggCount | + | * '''AggCount:''' Retorna a quantidade total de linhas da Grid. |
AggCount([coluna1]) | AggCount([coluna1]) | ||
+ | * '''AggAvg:''' Retorna a média geral dos valores da coluna especificada. | ||
+ | AggAvg([coluna1]) | ||
+ | * '''AggMin:''' Retorna o menor valor da coluna especificada. | ||
+ | AggMin([coluna1]) | ||
+ | * '''AggMax:''' Retorna o maior valor da coluna especificada. | ||
+ | AggMax([coluna1]) | ||
+ | O nome da coluna, passado como parâmetro nos exemplos acima, devem sempre estar entre '''colchetes'''. | ||
+ | '' '''Importante:''' Ao criar uma expressão para o rodapé da Grid, utilize '''sempre''' o nome da coluna junto com uma dessas funções de agregação.'' | ||
+ | ; Como evitar erro de Divisão por ZERO | ||
+ | Para evitar erros de divisão por ZERO na expressão, uma condição pode ser utilizada, utilizando a função IF do NCalc: | ||
− | + | if (AggSum([receita]) = 0, 0, AggSum([receita]) + AggSum([valormargem]) * 100 / AggSum([receita])) | |
− | |||
− | |||
− | |||
− | |||
== Ver Também == | == Ver Também == | ||
[[Expressões Matemáticas]] | [[Expressões Matemáticas]] |
Edição das 14h57min de 17 de novembro de 2014
Rodapé
- Modo de Agregação: Define a estratégia utilizada pela Grid para calcular o valor de rodapé (ou valor de agregação da coluna). Os seguintes modos de agregação estão diponíveis:
- Sem Agregação: Os valores da coluna não serão agregados.
- Soma: Os valores da coluna serão somados.
- Contagem: As linhas da Grid serão contadas.
- Média: Será realizada uma média geral em cima dos valores da coluna.
- Mínimo: Será utilizado o menor valor da Coluna
- Maximo: Será utilizado o maior valor da Coluna
- Customizado: Permite cadastrar um fórmula para calcular o agregador do coluna.
- Máscara: Campo que permite que o usuário especifique uma máscara a ser utilizada no valore de agregação> Se este campo não for informado, será usada a máscara cadastrada para a coluna.
- Fórmula: Campo para criação de uma expressão matemática que é habilitado quando o modo de agregação é Customizado.
Agregação de Valores Customizada
O modo de agregação Customizado do rodapé exige a criação de uma expressão matemática, que chamamos de Fórmula. Para interpretar essa fórmula, o LATROMI WecDB utilizada a biblioteca de terceiros NCalc, cujo os recursos disponíveis estão discriminados aqui.
Além das funções nativas do NCalc, temos 5 funções customizadas, que foram criadas para fazer a agregação dos valores das colunas. São elas:
- AggSum: Retorna a soma de todos os valores da coluna especificada.
AggSum([receita]) + AggSum([valormargem]) * 100 / AggSum([receita])
- AggCount: Retorna a quantidade total de linhas da Grid.
AggCount([coluna1])
- AggAvg: Retorna a média geral dos valores da coluna especificada.
AggAvg([coluna1])
- AggMin: Retorna o menor valor da coluna especificada.
AggMin([coluna1])
- AggMax: Retorna o maior valor da coluna especificada.
AggMax([coluna1])
O nome da coluna, passado como parâmetro nos exemplos acima, devem sempre estar entre colchetes. Importante: Ao criar uma expressão para o rodapé da Grid, utilize sempre o nome da coluna junto com uma dessas funções de agregação.
- Como evitar erro de Divisão por ZERO
Para evitar erros de divisão por ZERO na expressão, uma condição pode ser utilizada, utilizando a função IF do NCalc:
if (AggSum([receita]) = 0, 0, AggSum([receita]) + AggSum([valormargem]) * 100 / AggSum([receita]))