Mudanças entre as edições de "Consulta:Totalizadores da Grid"
(→Ligações Externas) |
|||
| (11 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 1: | Linha 1: | ||
== Rodapé == | == Rodapé == | ||
| − | * Modo de Agregação: | + | * '''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: |
| − | * Máscara: | + | *: '''Sem Agregação:''' Os valores da coluna não serão agregados. |
| − | * Fórmula: | + | *: '''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 valor 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 === | === 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 sistema utilizada a biblioteca de terceiros [http://ncalc.codeplex.com NCalc], cujo os recursos disponíveis estão discriminados [[Expressões Matemáticas|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])) | ||
== Ver Também == | == Ver Também == | ||
| − | [[ | + | [[Expressões Matemáticas]] |
| + | |||
| + | == Referências == | ||
| + | * [https://ncalc.codeplex.com/wikipage?title=functions&referringTitle=Home Funções do NCalc - Mathematical Expressions Evaluator for .NET] | ||
Edição atual tal como às 19h08min de 11 de outubro de 2018
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 valor 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 sistema 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]))
