nginstack

Class: FieldAggregator

@nginstack/web-framework/lib/field-aggregator/FieldAggregator~ FieldAggregator

new FieldAggregator()

Classe abstrata que implementa a interface esperada dos objetos responsáveis pela agregação dos campos da grade.

Essa classe não deve ser utilizada diretamente. Instancie uma das classes filhas especializadas com o algoritmo de agregação desejado.

Members

dataSet :DataSet

Dados que serão agregados.

Essa propriedade é atualizada automaticamente pela grade de dados.

Type:

<nullable> decimalPrecision :number

Precisão decimal do totalizador. Caso não seja informada, será utilizada a precisão do campo totalizado.

Type:
  • number

description :string

Descrição da totalização que será exibida na interface do sistema.

Type:
  • string

lastValue :number

Valor calculado na última edição dos dados.

Type:
  • number

readOnly :boolean

Determina se o valor totalizado pode ser modificado pelo usuário. Por padrão, as totalizações serão apenas para leitura.

Nem todas as classes de agregação permitem a alteração dos valores a partir de uma modificação do total calculado. Quando esse recurso é suportado, deve ser aplicado algum critério de rateio da diferença do total informado nos registros que foram agregados. Esse rateio é aplicado diretamente nos dados, sem emitir os eventos de alteração do campo e da grade de dados, sendo recomendado apenas para dados que serão posteriormente validados antes de serem gravados na base dados.

Type:
  • boolean

supportsCalculatedFields :boolean

Indica se este agregador de valores suporta campos calculados.

Para manter compatibilidade com o comportamento legado do sistema, o padrão dessa propriedade é true e as classes filhas que não suportem campos calculados devem alterar esta propriedade para false para indicar que essa restrição de uso.

Type:
  • boolean

value :number

Valor corrente da agregação.

Type:
  • number

Methods

assign(obj)

Copia os valores das propriedades de um objeto

Parameters:
Name Type Description
obj FieldAggregator

Objeto do qual se deseja obter os valores.

checkRecNo(recNo)

Verifica se a posição informada existe no DataSet totalizado. Será gerado um erro caso a posição não seja válida.

Parameters:
Name Type Description
recNo number

Posição a ser verificada.

formatValue(value)

Formata o valor totalizado com a precisão decimal configurada.

Parameters:
Name Type Description
value number | Date

Valor a ser formatado.
Returns:

Valor formatado.

Type
string

previewValue()

Atualiza o valor do aggregate

reset()

Restaura o valor totalizado na última edição da grade.

toString()

Cria uma representação textual do campo que está sendo agregado.

Returns:
Type
string